ASTELAR
★ GitHub
AI-native · Open source

The documentation engine
that understands your code.

Astelar turns specs, architecture and APIs into one living, cinematic narrative. CLI-first. MCP-native. API-driven. Your system, finally readable.

$ npx astelar init ⧉ copy
astelar — zsh
What makes it different

Docs that behave like a product

Not a static site generator. An engine that reads your repo, understands it, and renders depth on demand.

⌘

CLI-first

Scaffold, build and deploy from the terminal. astelar init · build · deploy.

◈

MCP-native

Connects to your MCP servers so an agent reads your live system, not stale markdown.

↯

API-driven

Projects, docs, builds and a search index — all behind a clean REST API + webhooks + SDK.

✦

AI-based depth

Reader modes re-weight the same doc for investor, engineer or customer — automatically.

◱

Motion-first

Diagrams that animate as data moves. Living architecture, not screenshots.

⬡

Open source

Astro under the hood. Own your docs, self-host anywhere, no lock-in.

CLI · MCP · API

One engine, three surfaces

Wire Astelar into your workflow however you build.

~/.astelar/mcp.jsonMCP
// connect a live MCP so docs read your real system
{
  "mcpServers": {
    "astelar": {
      "command": "npx",
      "args": ["astelar", "mcp"],
      "env": { "ASTELAR_TOKEN": "ast_live_…" }
    }
  }
}
fetch the rendered narrativeAPI
await fetch("https://api.astelar.dev/v1/docs", {
  headers: { Authorization: `Bearer ${token}` }
})
  .then(r => r.json())
  // → { sections, graph, searchIndex, readerModes }

// or stream a section for an agent
astelar api docs/architecture --mode engineer
Engineering is already beautiful.
Documentation should reveal it.