deja

What survives a run.

deja is a self-hosted memory layer for agents. It exposes durable memory via REST + MCP, with scoped recall and optional live working state.

Start here

1) Tutorial (learning-oriented)

• Quickstart: https://deja.coey.dev/guides/quickstart

2) How-to guides (task-oriented)

• Connect an MCP client: https://deja.coey.dev/docs
• Integrations index: https://deja.coey.dev/integrations
• Cursor integration: https://deja.coey.dev/integrations/cursor
• Claude Code integration: https://deja.coey.dev/integrations/claude-code
• GitHub Actions integration: https://deja.coey.dev/integrations/github-actions

3) Reference (information-oriented)

• REST + MCP reference: https://deja.coey.dev/docs
• OpenAPI (working state): docs/openapi-working-state.yaml
• Drizzle schema source of truth: src/schema.ts
• Migration artifacts: drizzle/

4) Explanation (understanding-oriented)

• Architecture & self-hosting: https://deja.coey.dev/guides/architecture-and-self-hosting
• Use cases: https://deja.coey.dev/use-cases

---

Minimal deploy

git clone https://github.com/acoyfellow/deja
cd deja
bun install
wrangler login
wrangler vectorize create deja-embeddings --dimensions 384 --metric cosine
wrangler secret put API_KEY
bun run deploy

---

Minimal MCP config (agent-agnostic)

Any MCP-capable agent can connect to:

• Endpoint: https://<your-host>/mcp
• Header: Authorization: Bearer <API_KEY>

Example:

{
  "mcpServers": {
    "deja": {
      "type": "http",
      "url": "https://deja.your-subdomain.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${DEJA_API_KEY}"
      }
    }
  }
}

---

Core API surface

• Memory: /learn, /inject, /query, /learnings, /learning/:id, /stats
• Working state: /state/:runId, /state/:runId/events, /state/:runId/resolve
• Secrets: /secret, /secret/:name, /secrets

For full payloads and examples, use: https://deja.coey.dev/docs