Skip to main content
Three commands, one terminal, working end-to-end. If you’d rather build with code, skip to the SDK — same three steps, pick your framework.
1

Install the CLI

npm install -g @copass/cli
Requires Node.js 20+.
2

Authenticate

copass login
You’ll get an OTP by email. On success, your tokens are written to ~/.olane/config.json alongside an auto-generated encryption key.
3

Ingest and ask

Bootstrap the current directory (creates a sandbox, data source, and project — once per project):
cd ~/your/project
copass setup
Push content in:
echo "Migrating checkout confirmation to Stripe webhooks" | \
  copass ingest --source-type decision
Ask a question:
copass question "what did we change about checkout?"
That’s it. Your data is in Copass, attributed to the filesystem data source this project was set up against, and queryable through the knowledge graph.
Everything the CLI does calls the same public API. If you outgrow the CLI, port the same flow to the SDK or hit the REST API directly.

​
What just happened

  • copass setup created a sandbox (your tenancy boundary), registered a custom data source rooted at this directory, and created a storage project linking the source. The three resulting ids live in .olane/refs.json.
  • copass ingest pushed content through that data source. The server chunked it, extracted entities, and stored the raw bytes in your vault.
  • copass question hit the knowledge graph, scoped to this project, and returned a synthesized answer.

​
Want a hosted agent instead?

Same three ids, one router.run(...) call — plus one-line OAuth for GitHub, Slack, Notion, and friends. See Agent Router. 
import { AgentRouter } from '@copass/agent-router';
const router = new AgentRouter({ auth, sandboxId });
await router.integrations.connect('github', { onConnectUrl: open });
for await (const e of router.run({ provider: 'anthropic', model: 'claude-opus-4-7', system, message, endUserId })) { /* stream */ }

​
Next steps

  • CLI — the full command surface, --json scripting, the MCP server.
  • SDK — do the same thing from a Node or Python app.
  • Agent Router — run a hosted agent with OAuth’d integrations.
  • Overview — how the pieces fit together, and which surface to reach for.