Cli
Cross-tool decision memory for AI coding agents: search your decision graph, check changes over MCP.
- Transport
- Not stated
- Package
- —
- Registry id
- io.github.aligndottech/cli
No install snippet on purpose. A working MCP config is a command, its arguments and an environment block — the last two are where API keys live, so this catalogue never stores them and cannot publish them. Follow the link above for the authors' own instructions.
Your AI agents know the code. They don't know the company.
The decisions behind the code live in commits, tickets, chat and meetings. Months later nobody can tell what still stands, what conflicts, or why. Align pulls them into one graph your agents check before they build.
curl -fsSL https://align.tech/install.sh | sh
align
That is the whole thing. align sets itself up the first time you run it and asks whether you
want it local-only or synced; after that it shows your graph and what to do next.
A standalone binary. No Node, no npm, nothing else to install, and local-only mode works fully - on-device embeddings included, running on a WASM backend bundled inside the binary. Linux, macOS and Windows, x64 and arm64, glibc and musl. Verified against the release's own checksums, and you can read install.sh before you pipe it anywhere.
Prefer npm, or already have Node? npm install -g @aligndottech/cli (Node 22.16+).
Binaries for every platform are on the releases page.
MIT. No account needed. Beta, pre-1.0.
Run it inside a git repository. --local seeds the graph from your commit history, so you have
something to ask about straight away, and your decisions stay in a SQLite file on your machine.
Your decisions and code never go to Align. It sends two anonymous counts by default (install,
setup completed); usage only with your consent; align telemetry off or DO_NOT_TRACK=1 stops
all of it. What touches the network, and every field.
Want sync across machines and cross-tool relationship detection? Drop the flag. align setup
logs you in - a work email lands you in your company's graph (first person in is the admin,
the next colleague on that domain joins it automatically); a personal email gets you a graph
of your own, joinable to a company graph later by invite. It also connects your tools via
read-only OAuth and wires up your editors.
How it works
Your tools Align Your agents & you
────────── ─────────── ───────────────────
Git, GitHub, GitLab ─┐ ┌─ align ask "why…"
Jira, Confluence ├─▶ import ─▶ decision graph ─┐ ├─ MCP server (inline)
Linear, Notion │ (read-only) (what/why/who) ├─┤ edit hooks (any agent)
Slack, Teams, Zoom ─┘ + relationships┘ └─ align check (CI)
- Import pulls decisions out of the tools you already use. Read-only, nothing is modified.
- Align links them into a decision graph: what was decided, why, who decided it, and how decisions relate (supersedes, conflicts with, depends on).
- Your agents query and check against it, over MCP, an edit hook, CI, or
align ask.
Your agent checks before it writes
align setup wires Align in four ways, so context fires whether or not the model thinks to ask.
| What you get | |
|---|---|
| MCP server | Claude Code, Cursor, Claude Desktop and Windsurf query the graph inline |
| Edit hooks | Prior decisions reach the model before it writes. Claude Code, pi, Gemini CLI, OpenCode |
| Editor rules | A managed block in CLAUDE.md, AGENTS.md and .cursor/rules/align.md |
Shared .mcp.json |
One committed file wires up the whole team |
The hook is non-blocking and fail-open. It never denies an edit by default, and if Align is missing, slow or unreachable the edit proceeds untouched. It needs no AI provider key.
Cursor and Codex CLI can't do the pre-edit hook, and that's a limit of those hosts. They get the other three. Full per-host matrix: docs/agent-hooks.md.
The first time Claude Code loads a project with a committed hook, it shows a one-time "approve hooks" prompt. Accept it to enable automatic alignment.
Everyday commands
From the project's README.