Engram

Local-first developer context hub built on Supermemory. Capture high-signal intent from your IDE and terminal, open Context anytime to see where you left off, Save a capsule to switch tools or share with a teammate.

Works across VS Code, Cursor, Windsurf, and VSCodium (one extension). Optional terminal/git hooks and npx @engram-cli/engram + MCP for Claude Code and other agents.

Live site: engram-context.vercel.app

Install / usage

1. Extension — Sideload the VSIX: extension/engram-0.1.0.vsix (build with cd extension && npm run package). In VS Code/Cursor: Extensions → … → Install from VSIX…. Or use Install extension on the landing page.
2. Start the backend — npx @engram-cli/engram start starts Supermemory Local (:6767) + the Engram backend (:7731) in the foreground.
3. Install hooks — npx @engram-cli/engram init in each project repo to enable terminal + git capture.
4. Dashboard — Sign in on the landing site, then open engram-context.vercel.app/dashboard (local backend on :7731 required for live context).
5. MCP — Add to your Claude Code or other MCP client config:

{
  "mcpServers": {
    "engram": {
      "command": "npx",
      "args": ["-y", "@engram-cli/engram", "mcp"],
      "env": { "ENGRAM_BACKEND_URL": "http://localhost:7731" }
    }
  }
}

On first run, use the extension Setup checklist (or dashboard Settings) to paste your Supermemory API key and optional LLM key.

Share links need an account (GitHub, Google, or email). Solo capture/Context needs no account.

Mental model

Piece	Role
Capture	Invisible write pipeline — events go into local Supermemory
Context	Always-current read — assembles a brief when you open the panel (not a separate store)
Save / Load	Freeze / restore the project's capsule for IDE handoff
Share	Upload a sanitized capsule snapshot → public link + Copy Markdown / Import

Files stay on disk. Engram shares context, not tabs, buffers, or chat history.

Features

Backend & capsules

• API on :7731: ingest, Context, capsule save/load, hybrid search
• Project scope: containerTag: project_{slug}
• Capsules → backend/data/capsules/{project}/current.json (or ~/.engram/data for standalone npx)

Extension (MVP)

• VS Code / Cursor / Windsurf / VSCodium: P0 capture (file open, Problems errors)
• Sidebar Context panel, Save/Load capsules, NL search
• Sideload: extension/engram-0.1.0.vsix — see extension/README.md

CLI / MCP / hooks

• npx @engram-cli/engram start — standalone (bundled backend) or monorepo
• MCP tools: status, context, save/load/list capsules, search, emit + engram:// resources
• Terminal + git hooks via npx @engram-cli/engram init

Landing, dashboard & share

• Marketing site + hosted dashboard at engram-context.vercel.app
• Sign in (GitHub / Google / email) to create and manage share links
• Public /share/[token] page with Copy Markdown; engram import for local restore

Stack

• Memory: Supermemory Local (localhost:6767) + TypeScript SDK
• Backend: Hono + TypeScript (localhost:7731)
• Contracts: @engram-cli/contracts (zod schemas) — npm @engram-cli/engram / @engram-cli/contracts
• Extension: VS Code Extension API
• Share / auth: Supabase (snapshots + Auth only; graph stays in Supermemory)
• Landing: Next.js + Tailwind

Docs

• CONTEXT.md — domain language, API contract, data storage, verify steps
• PRD.md — product requirements
• DEVELOPMENT.md — architecture & build order
• landing/DEPLOY.md — Vercel deploy
• landing/docs/OAUTH_SETUP.md — GitHub / Google OAuth
• backend/README.md — run API + curl smoke
• extension/README.md — F5 / VSIX sideload
• cli/README.md — npm publish + CLI commands

Repo layout

backend/              # Hono API
packages/contracts/   # Shared zod schemas
extension/            # VS Code extension (Capture + Context + Save/Load)
cli/                  # npx @engram-cli/engram + MCP
landing/              # Next.js marketing + hosted /dashboard + share API
dashboard/            # Legacy Vite UI (prefer landing /dashboard)
terminal-hook/        # Shell hook
git-hooks/            # Git hooks
docs/images/          # README screenshots

Backend

# Supermemory Local on :6767 first (see CONTEXT.md)
cd packages/contracts && npm install && npm run build
cd ../backend && npm install && npm run dev   # http://localhost:7731
npm run smoke:curl

Or from anywhere: npx @engram-cli/engram start

Repo-root .env needs SUPERMEMORY_API_KEY + SUPERMEMORY_BASE_URL=http://localhost:6767.

Monorepo tip: project data lives in backend/data. Standalone npx defaults to ~/.engram/data. From this repo, prefer cd cli && node dist/cli.js start so you reuse monorepo data.

Landing

cd landing && npm install && npm run dev

Open http://localhost:3000 — production: https://engram-context.vercel.app

License

MIT