Align CLIBLOCK
Align CLI - capture decisions, check alignment, and query your decision graph from the terminal
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
[](https://www.npmjs.com/package/@aligndottech/cli) [](https://github.com/aligndottech/align-cli/actions/workflows/ci.yml) [](./LICENSE) [](https://nodejs.org)
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. The first time you run it, align asks which coding agent you use, connects your tools and builds a local graph on your machine. After that, align opens your agent with the graph already wired in.
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. It checks the download against the release's own checksums and says so out loud when it cannot, 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.
On Windows, start with npm. In PowerShell:
npm install -g @aligndottech/cli align
The curl ... | sh line above needs a POSIX shell, so it runs under Git Bash or WSL and not in PowerShell itself. Installing covers the rest, including the manual binary download for a Windows machine with no Node on it.
MIT. No account ne
1ce3bc87dd09OBSERVED · 2026-10-12Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add cli -- npx -y @aligndottech/[email protected]
Exposed tools (1)
1 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
align-decision-graph | read | Align: check the ${event === |
Trust audit
BLOCKgrade F · trust 47/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | FAIL |
| L1 | Static analysis of the code | FAIL |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- none-observed
- Network
- declared (4 observation(s))
- Shell
- declared (1 observation(s))
- Dependencies
- not all pinned
- Secrets in source
- found
Findings (25)
hook-payload.ts
doc = yaml.load(readFileSync(path, 'utf8'))
AWS_SECRET_ACCESS_KEY: 'aws-planted', ALIGN_TOKEN: 'al-planted', ALIGN_LLM_API_KEY: 'llm-planted', DATABASE_URL: 'postgres://u:p@h/db',
export const TOKEN = 'SECRET-TOKEN-0123456789';
for (const bad of [{ token: 'ghp_SECRETVALUE0123456789' }, { api_key: 'sk-ant-SECRETVALUE' }]) {await expect(dispatchTool('align_scope', { action: 'view', token: 'ghp_SECRETVALUE0123456789' }, client, env)).rejects.toThrow(/an unknown property/);try { await dispatchTool('align_scope', { action: 'view', token: 'ghp_SECRETVALUE0123456789' }, client, env); } catch (e) { expect((e as Error).message).not.toContain('SECRETVALUE'); }await expect(runScopeTool({ action: 'set', source: 'jira', projects: ['ALI'], token: 'ghp_SECRETVALUE0123456789' }, localEnv, deps)).rejects.toThrow(/an unknown property \(the name is not printed backexpect(() => normaliseScopeValues('jira', ['ghp_abcdefghijklmnopqrstuvwxyz0123456789'])).toThrow(ScopeValueError);const secret = 'ghp_SECRETVALUE0123456789abcdefABCDEF';
.release-please-manifest.json
hook-payload-agents.test.ts
hook-payload-user-hosts.test.ts
hook-payload.test.ts
share-payload.test.ts
exec(`UPDATE decisions SET tomorrow = 'x' WHERE id = '${id}'`);exec(`INSERT INTO decisions (id, title, summary, platform, source_url) VALUES ('twin', 'second title', 'body', 'github', '${url}')`);exec(`INSERT INTO decisions (id, title, summary, platform) VALUES ('a', 'a', 's', 'cli'), ('b', 'b', 's', 'cli')`);exec(`INSERT INTO decision_audit (id, decision_id, action, actor, detail) VALUES
exec(`PRAGMA user_version = ${SCHEMA_VERSION + 2}`);const hash = createHash('sha1').update(`${cwd}\0${envName}`).digest('hex').slice(0, 16);const marker = path.join(store!, `advisory-${createHash('sha1').update(cwd).digest('hex').slice(0, 16)}.json`);const hash = createHash('sha1').update(cwd).digest('hex').slice(0, 16);return createHash('sha1').update(text).digest('hex');const hash = createHash('sha1').update(`${cwd}\0${envName}`).digest('hex').slice(0, 16);Gates applied: no_behavioural_pass.
1ce3bc87dd09full audit observations/trust-audit/mcp-server/aligndottech__align-cli.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-12 | 1ce3bc87dd09 | BLOCK | F | 47 | first audit |
Questions
What is the @aligndottech/cli MCP server?
Align CLI - capture decisions, check alignment, and query your decision graph from the terminal
What tools does @aligndottech/cli expose?
1 in total: 1 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is @aligndottech/cli safe to connect to an agent?
No — not without reading the findings first. The audit graded it F (47/100) and found 2 critical or high issues in the source. Each one is listed on this page with the file and line it is on.
What credentials does @aligndottech/cli need?
It reads FAKE_BROWSER_TOKEN and GROQ_API_KEY from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does @aligndottech/cli run?
It speaks sse, stdio and streamable-http, so it runs as a local process your client starts. It is published on npm as @aligndottech/cli at 0.51.0.
How current is this page?
The grade is for one exact copy of the source (1ce3bc87dd09), read on 2026-10-12. The repository is watched and re-audited when it changes.