decispher

The system of record for engineering decisions. — decispher.com

Turn every branch into a flight recorder for your AI coding sessions.

npx decispher init

One command wires the current repo:

• Capture — decisions, discovered constraints, and rejected attempts from Claude Code and Cursor sessions, with provenance (reasoning, terminal evidence, per-edit diffs). Redacted at source, buffered offline, never blocking your agent.
• Pre-flight briefing — resume any branch warm: the agent's first message already knows what was decided, what failed, and what's still open.
• Recording light — the Claude Code statusline shows exactly what's staged on this branch: ● rec │ feat/x │ 2 decisions · 1 constraint staged.
• Promote — one click moves session knowledge into your project's corpus, fused against existing context (supersedes / contradicts / extends detected automatically).

Commands

| Command | What it does | |---------|--------------| | decispher init | Wire this repo: Claude Code hooks, Cursor hooks + rules, git post-checkout hook, statusline recording light. Flags: --api-key, --api-url, --repo owner/name | | decispher status | List staged units on the current branch, with one-keystroke discard | | decispher discard <id> | Discard a staged unit (id prefix accepted) |

What gets written

| Path | Purpose | Commit it? | |------|---------|-----------| | .decispher/recorder.json | Repo name + API URL (no secrets) | ✅ | | .decispher/hooks/decispher-hook.mjs | Zero-dependency hook handler | ✅ | | .cursor/hooks.json | Cursor hooks (afterFileEdit · beforeShellExecution · stop) — merged, user entries preserved | ✅ | | .cursor/rules/decispher.mdc | Cursor agent rules: read the branch briefing at conversation start, self-report decisions via session_record | ✅ | | .decispher/.session/ | Local event buffer + caches | ❌ (gitignored by init) | | ~/.decispher/credentials.json | Your API key, per API URL (0600) | never in the repo |

Privacy

Secrets are pattern-masked before anything leaves your machine, and content from sensitive paths (.env*, keys, certs, credentials) is never read at all. What syncs is extracted context units with provenance — never your full transcript.

See also

• @decispher/mcp-server — serve your team's decisions, conventions, and constraints to any MCP-capable agent.

© Decispher. All rights reserved.