AmbitGet startedFAQReferenceGlossaryAll docsGitHubLive demo

Security

Reporting

Report vulnerabilities privately through GitHub: Security → Report a vulnerability. Private reporting is enabled on this repository. Please do not open a public issue for anything exploitable.

Ambit is a personal project, not a staffed one — expect a first response in days rather than hours.

What is worth reporting

Ambit reads your agent configuration and, through the visualizer, writes back to it. Four invariants hold that surface, and a break in any of the four is a vulnerability. The servers guide says where each of the four is enforced in code.

Also in scope: anything that causes the engine to execute content from a scanned configuration, an infrastructure manifest or a spec ambit goal --spec reads, the one exception being ambit weigh starting the servers your own user-level configs declare, when you type it; any path by which ambit weigh starts a server from a project's committed config, contacts a remote one, or runs without being typed; and any path by which ambit gate, the Claude Code PreToolUse hook, answers allow, or by which Cursor's ledger hook blocks or allows a call. The gate may only narrow what Claude Code would do: it denies what is forbidden or over budget, asks about the rest of what it can name, and otherwise prints nothing. It reads the call from stdin and the local graph, writes nothing, opens no socket, and on any error prints nothing, so a broken gate leaves Claude Code's own permissions in charge. For a shell call it reads the command to name the programs it runs, and keeps neither the command nor the names.

The control plane's Docker adapter is never the default: a person chooses it with AMBIT_ADAPTER=docker or --adapter=docker, and when Docker cannot run the step it refuses before anything runs. It runs only what the gate already let through, one container per step from the image the person named, never one the request names. What the container gets:

A path that breaks any of those is in scope, as is any path by which the adapter runs a step the gate refused, or by which a Docker refusal ends with the step run in the simulator.

A tech tree overlay (.ambit/techtree.json or .ambit.json in the directory ambit runs from, or AMBIT_OVERLAY_TECHTREE) may add nodes and detection patterns and may narrow the authority the curated tree states, never widen it. A cloned repository can ship either file, so the merge keeps every curated mode, takes the narrower of the curated and the overlay's for each key (forbidden over confirm over autonomous, with override: true no exception), and caps at confirm any mode the curated tree never stated, a node only the overlay names included. Any overlay that yields a grant wider than the shipped tree's is in scope.

What is not

Known limits

Where your data is

The graph is a local SQLite file whose path ambit where prints, and it describes your machines, your credentials-adjacent tooling, and your network reach. ambit graph export and ambit status describe your machine too, so redact before pasting either into a report; the FAQ lists the commands that can move data and what each one sends. The server's read routes (/api/loop, /api/audit, /api/frontier and /api/run) answer from the graph under the same loopback and origin rules, and /api/loop also carries the text of a few install patches shipped in this repository's tree. The infrastructure scan probes only what your own manifest names, as described above, and records nothing: when a device or service was last seen is read from the graph, where only a typed ambit incidents writes it.

See what your own agents can reach

Ambit reads the MCP configs of Claude Code, Cursor, OpenCode and thirteen more agents into one local map: every server, which ones work, what one more step would open, and what breaks if a piece goes.

Open the live demoa sample setup in your browser, nothing to install

On your machine: npx ambit-cli, with Node 22.18 or newer on macOS or Linux.

MIT licensed · one local SQLite file, no telemetry · on npm and in the official MCP registry