{
  "markdown": "# Caelus\n\nClean-room astrology computation monorepo. MIT, no Swiss Ephemeris code, no\nAGPL, no ephemeris files. Caelus computes ephemeris positions, charts, events,\nhellenistic timing techniques, Vedic methods, citable chart facts, sky-view\nimage-prompt frames, and the MCP tools around them. Live at\n[ephemengine.com](https://www.ephemengine.com).\n\n## Packages\n\n| Path | npm | Description |\n|------|-----|-------------|\n| `packages/caelus` | [`caelus`](https://www.npmjs.com/package/caelus) | TypeScript engine (~153 KB gzipped total, zero deps) |\n| `packages/caelus-mcp` | [`caelus-mcp`](https://www.npmjs.com/package/caelus-mcp) | MCP server: charts, transits, synastry, events, eclipses |\n| `packages/caelus-delineations-pd` | — | Public-domain interpretation corpus + default validation set for `interpret()` |\n| `packages/birth` | [`caelus-birth`](https://www.npmjs.com/package/caelus-birth) | Birth time + place → UT (timezone and DST resolution) |\n| `packages/wheel` | [`caelus-wheel`](https://www.npmjs.com/package/caelus-wheel) | React SVG chart wheel, zero runtime deps |\n| `apps/web` | — | Next.js site: playground, validation, edge `/api/chart` |\n| [`caelus-starter`](https://github.com/heavyblotto/caelus-starter) | — | Next.js starter app (separate repo) |\n\nThe Python reference engine and data-fitting pipeline live in `python/`;\nthey mint the coefficient data and golden fixtures and are not a runtime\ndependency.\n\n## Docs\n\n- [ARCHITECTURE.md](./ARCHITECTURE.md) — layout, durability decisions, product strategy\n- [MCP_SPEC.md](./MCP_SPEC.md) — MCP tool contract\n- [docs/gap-analysis.md](./docs/gap-analysis.md) — Swiss Ephemeris comparison (closed at 0.5.0)\n- [docs/agents.md](./docs/agents.md) — pitfalls for coding agents building on Caelus\n- [docs/releasing.md](./docs/releasing.md) — release process\n\n## Quick start\n\n```bash\nnpm install\nnpm run build\nnpm test\nnpm run dev -w web\n```\n\nhttp://localhost:3000 — live chart in the browser.\nEdge API: `GET /api/chart?date=…&lat=…&lon=…`.\n\n## Branches\n\n- `main` — stable releases\n- `dev` — active development\n",
  "bytes": 2074,
  "sha": "d97f71e870273b33ce79823a45a0c6b6c4206346d3de621260b432ebd867e0b9",
  "repo_slug": "heavyblotto/caelus",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_heavyblotto_caelus_mcp_735f65ea/readme"
}