Atlas
Multi-repo navigation and multi-agent coordination for AI tooling.
The manifest folder that scopes AI agents to the relevant repos in your project, with a coordination layer so parallel agents don't step on each other.
npm install -g @cidx-dev/atlasBuilt for AI agents that ship code
Atlas solves the “which repo?” and “who's working on this?” problems that come up the moment you point an AI agent at a real multi-repo codebase.
Multi-repo navigation
One manifest folder maps which repos belong to which product. Agents read it and stay scoped to the relevant subset, so no more lost-in-50-repos sessions.
How atlas scopes agents →Multi-agent coordination
Claim and release with TTL and path-level granularity. Parallel agents don't overwrite each other's work; conflicts return a clean exit code and surface the holding agent.
Claim / release flow →Auto-claim agent flow
Agents read AGENTS.md instructions and auto-claim work at task start, releasing at task end. The human never types /atlas-claim manually; it's the agent's job.
Agent-driven flow →Versioned schema with migrations
Manifest format is versioned. Structural changes ship with migrations. Folders track their own revision counter, so you see exactly what changed since the last update.
Schema and versioning →Reference, never invent
Atlas references existing scripts in each repo (npm scripts, Makefile targets, docker-compose). Source of truth stays in the repo; atlas is the cross-repo index.
CLI reference →Health checks built-in
atlascli doctor validates structure, schema versions, missing files, and broken references. Catches drift before agents start working in a half-broken atlas.
atlascli doctor →Get started in three steps
From zero to a working multi-agent atlas in under a minute.
- 1
Install
Get the CLI and slash commands installed globally.
Full install guide →npm install -g @cidx-dev/atlas atlascli install - 2
Bootstrap an atlas
From the parent dir of your repos, open Claude Code and run /atlas-init. It surveys your sibling repos and walks you through grouping them into products.
Bootstrap walkthrough →cd /path/to/your/projects claude > /atlas-init - 3
Use it
Agents auto-claim work via atlascli claim and release at the end. You can inspect with /atlas-status, sync new repos with /atlas-update, or run a health check with /atlas-doctor.
CLI reference →atlascli status atlascli doctor atlascli version
Open source. MIT.
Atlas is built in the open. Issues, PRs, and feedback welcome. We're shaping the multi-agent coordination layer with you.