# @a5c-ai/atlas

> Atlas catalog graph data, SDK, and CLI.

Latest version **6.0.0** (published 2026-06-30) · MIT license · 0 weekly downloads

## Install

```sh
npm install @a5c-ai/atlas
pnpm add @a5c-ai/atlas
yarn add @a5c-ai/atlas
bun add @a5c-ai/atlas
```

Provides the commands `atlas`, `a5c-atlas`.

## Health

**Score 60/100 (C)** — status: active.

Positive: has types; esm support; no vulnerabilities; high maintenance score.

Warnings: low downloads; large bundle.

## Facts

| | |
|---|---|
| Version | 6.0.0 |
| Published | 2026-06-30 |
| First published | 2026-05-08 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 2 |
| Unpacked size | 59.5 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1919 |
| Maintainers | tmuskal, benihak |

## Links

- npm: https://www.npmjs.com/package/@a5c-ai/atlas
- Repository: https://github.com/a5c-ai/babysitter
- Homepage: https://github.com/a5c-ai/babysitter/tree/main/packages/atlas#readme
- Issues: https://github.com/a5c-ai/babysitter/issues
- npm.io page: https://npm.io/package/@a5c-ai/atlas

## Dependencies (2)

- [yaml](https://npm.io/package/yaml.md) ^2.8.3
- [js-yaml](https://npm.io/package/js-yaml.md) ^4.1.1

## Recent versions

- 6.0.0 (latest) — 2026-06-30
- 6.0.3-staging.f5f113c68e2c (staging) — 2026-08-10
- 6.0.3 — 2026-08-10
- 6.0.3-staging.a92992776c25 — 2026-08-10
- 6.0.3-staging.0d4b52140f73 — 2026-08-06
- 6.0.3-staging.f37319247662 — 2026-08-04
- 6.0.3-staging.38b4f082bccd — 2026-08-03
- 6.0.3-staging.8b3609964d6b — 2026-08-03
- 6.0.3-staging.fe0e313bd8d2 — 2026-08-03
- 6.0.3-staging.bf012dbb7bff — 2026-07-25
- 6.0.3-staging.6db27fbdc426 — 2026-07-24
- 6.0.3-staging.06229323d3e1 — 2026-07-24
- 6.0.3-staging.4b5d366a78a4 — 2026-07-24
- 6.0.3-staging.cc429f39a3c5 — 2026-07-24
- 6.0.3-staging.547d8874062b — 2026-07-24
- … 279 more at https://npm.io/package/@a5c-ai/atlas/versions

## README

# @a5c-ai/atlas

Atlas catalog graph package. It ships the generated graph index, SDK helpers for graph interaction, and the `atlas` CLI.

## Usage

```ts
import { getStats, getRecord, searchRecords } from "@a5c-ai/atlas";

console.log(getStats());
console.log(getRecord("some-node-id"));
console.log(searchRecords("codex"));
```

```sh
atlas stats
atlas kinds
atlas get <node-id>
atlas search codex --limit 10
atlas neighbors <node-id> --depth 2
```

## Catalog Runtime

Atlas also ships the catalog runtime API as `@a5c-ai/atlas/catalog`. Use this
subpath for graph-backed agent metadata, discovery snapshots, UI projections,
fallback harness metadata, host detection rules, plugin targets, and
package/process topology.

```ts
import {
  getCatalogDiscoverySnapshot,
  getFallbackHarnessMetadata,
  listPluginTargetDescriptors,
  resolveCatalogAssetPath,
} from "@a5c-ai/atlas/catalog";

const discovery = getCatalogDiscoverySnapshot();
const claude = getFallbackHarnessMetadata("claude-code");
const pluginTargets = listPluginTargetDescriptors();
const assetPath = resolveCatalogAssetPath("discovery-snapshot.json");
```

Build and validate the catalog surface with atlas:

```sh
npm run build --workspace=@a5c-ai/atlas
npm run test:atlas-catalog-contracts
```

## MCP

The Atlas MCP surface is exposed by the Atlas WebUI as a Streamable HTTP endpoint:

```text
http://localhost:3000/api/mcp
```

Start the WebUI locally:

```sh
npm install
npm run dev -w @a5c-ai/atlas-webui
```

Then connect any MCP client that supports Streamable HTTP directly to that endpoint.

Example remote MCP client config:

```json
{
  "agentic-ai-atlas": {
    "url": "http://localhost:3000/api/mcp"
  }
}
```

For clients that only speak stdio, bridge to the remote MCP endpoint with `npx`:

```sh
npx -y mcp-remote http://localhost:3000/api/mcp
```

Example stdio client config through `npx`:

```json
{
  "agentic-ai-atlas": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "http://localhost:3000/api/mcp"
    ]
  }
}
```

Current MCP scope is public Atlas data only:

- graph stats and clusters
- search
- record lookup
- incoming and outgoing neighbors
- node-kind and edge-kind listings
- wiki pages
- OpenAPI discovery for the public REST surface

Authenticated overlays, user-uploaded subgraphs, and other private workspace data are intentionally excluded for now.

---
_Source: https://npm.io/package/@a5c-ai/atlas · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
