SDKs

npm install crosmos

export CROSMOS_API_KEY="csk_..."

import Crosmos from "crosmos";

const client = new Crosmos();

const space = await client.spaces.create({
	name: "personal-agent",
	description: "Memory for the user's personal agent",
});

console.log(space.id);

const spaces = await client.spaces.list({ name: "personal-agent" });
const space = spaces.spaces[0];

const ingest = await client.sources.ingest({
	space_id: space.id,
	sources: [
		{
			content: "User prefers detailed technical explanations and uses Neovim.",
			content_type: "text",
			meta: {
				source: "profile-import",
			},
		},
	],
});

console.log(ingest.job_id);

const job = await client.jobs.getStatus(ingest.job_id);

console.log(job.status);

const conversation = await client.conversations.ingest({
	space_id: space.id,
	session_id: "chat-001",
	session_date: "2026-05-28T10:00:00Z",
	messages: [
		{
			role: "user",
			content: "I want my agent to remember that I prefer Bun for TypeScript projects.",
		},
		{
			role: "assistant",
			content: "Got it. I will keep that in mind for future setup.",
		},
	],
	meta: {
		app: "example-agent",
	},
});

console.log(conversation.source_ids);

const search = await client.search.hybrid({
	space_id: space.id,
	query: "What does the user prefer for TypeScript projects?",
	limit: 5,
	include_source: true,
});

for (const candidate of search.candidates) {
	console.log(candidate.content, candidate.score);
}