English Français العربية

ALIGN

Official registry Developer tools

Your team's confirmed decisions, with receipts, for every coding agent (local stdio server).

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @align-agent/cli
Claude Code 
claude mcp add align -- npx -y @align-agent/cli@0.1.4 mcp
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "align": {
            "command": "npx",
            "args": [
                "-y",
                "@align-agent/cli@0.1.4",
                "mcp"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @align-agent/cli
  2. Install
  3. Commands
  4. What leaves your machine
  5. Uninstall
  6. Six promises
  7. Building and testing from this repository
  8. Licence

@align-agent/cli

The align command: captures the decisions made in your Claude Code, Cursor and Codex sessions, in the repositories you opt in, keeps a receipt for every one, and serves your team's confirmed decisions back to your agents.

This repository is the public source of the npm package. It is published from here by its own workflow with npm's trusted publishing, so every release from 0.1.4 on carries a provenance statement linking it to the commit and workflow run it was built from. (0.0.0 is an empty placeholder that only reserved the name; it is deprecated.)

Install

npx @align-agent/cli init

Releases go out on npm's latest dist-tag; prereleases, when there are any, on next.

init signs you in with a device code, connects the repository you are in, shows exactly what is captured and asks before anything is. Requires Node 22.14 or later on macOS or Linux (Windows through WSL).

Commands

align init, align confirm, align decide, align ask, align verify, align backfill, align pack, align sessions, align export, align mcp, align status, align doctor, align on, align off, align login, align logout and align uninstall. Run align <command> --help for each one's options.

What leaves your machine

  • Your prompts and the agent's replies in opted-in repositories, with secrets removed and fenced code blocks replaced on your laptop, before anything is sent. Text you paste without a code fence is sent after secret redaction.
  • The repository paths the agent touched (never file contents), your commit messages and the decisions you confirm.
  • For align verify: the paths and line numbers where a team check matched, for the commit you share with your remote, never the file contents.

Never sent: file contents, tool outputs, the commands your tools ran, diffs, .env files and paths you deny (.aligndeny), and anything from a repository you have not opted in. Your OS username and your machine's hostname are removed from what is sent.

align status shows what is captured and where; align off stops it at once; align sessions rm <id> deletes a session.

Uninstall

align uninstall          # removes what was added for this repository (hooks restored, local files left alone)
align uninstall --purge --yes   # also deletes everything kept on this laptop

Six promises

  1. Neutral. Every harness, never our own agent. Your harness's memory is one of our sources.
  2. Receipts. No ledger entry without evidence. The database refuses one.
  3. Verified. Checked against what shipped, or marked unverified or stale.
  4. Yours. Export everything, any time, in open formats (the console's export, or align export).
  5. Permanent ids. Decision ids (AL-12) live in your commits and outlive any tool.
  6. Quiet. One comment per PR, batched alerts, no per-developer metrics, ever.

Building and testing from this repository

corepack enable
pnpm install --frozen-lockfile
pnpm typecheck
pnpm test        # the CLI's unit tests (the hook-latency suite: pnpm --filter @align-agent/cli test): synthetic fixtures, temporary home folders, local servers on 127.0.0.1 only
pnpm build       # packages/cli/dist/align.mjs

The release workflow runs the same steps on macOS and Linux with Node 22 and 24 before it builds, packs and smoke-tests the tarball it publishes. The tests and their fixtures are here so you can run them too; none of them is in the npm package, which holds only the bundle, this README and the licence.

Licence

MIT, see LICENSE. It covers everything in this repository, including packages/core/: the parts of ALIGN's shared library the CLI is built from, which the published package bundles.

Frequently asked questions

What is ALIGN?

Your team's confirmed decisions, with receipts, for every coding agent (local stdio server).

How do I install ALIGN?

It runs on your machine. In Claude Code: claude mcp add align -- npx -y @align-agent/cli@0.1.4 mcp. For other clients, paste the JSON configuration from this page into their MCP settings.

Does ALIGN need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is ALIGN open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains ALIGN?

It is published by bharatreachdsp. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.