@ashwindojo/codeatlas-core

Annotate your React, Vue, or Svelte components with business context — then query your entire codebase with AI.

CodeAtlas parses @productFlow, @productState, @ownership, and 22 other annotations from your source files, builds a live business-flow graph, and exposes it to Claude, Cursor, and other MCP-compatible AI tools.

Install

npm install @ashwindojo/codeatlas-core

Index your codebase in 30 seconds

npx codeatlas index ./my-app

✓ Indexed 42 files in 68ms
◆ 4 flows: payments, auth, dashboard, onboarding
◆ 31 annotated nodes
Output: .codeatlas/index.json

Annotate your components

Add annotations as comments — no build changes required:

/**
 * @productFlow("payments")
 * @routeHandler("/checkout")
 * @ownership("payments-team")
 */
export default function CheckoutPage() { ... }

// @productState("payments")
// @critical
export const paymentSlice = createSlice({ ... })

// @selector("getPaymentStatus")
export const selectStatus = (state) => state.payments.status

25 built-in annotations

| Category | Annotations | |---|---| | Flow | @productFlow @routeHandler @flowEntry @flowStep @layout | | State | @productState @selector @action | | API | @productApi @integration | | Feature | @productFeature @experiment @permission @analytics | | Component | @provider @consumer @errorBoundary @lazyLoad @crossFlow | | Domain | @domainEntity @ownership @lifecycle @critical @deprecated @mock |

All three styles work: JSDoc blocks, // line comments, and TypeScript decorators.

Add your own annotations

import { indexRepo } from '@ashwindojo/codeatlas-core'

const index = await indexRepo('./my-app', {
  customAnnotations: [
    { name: 'workflow',    description: 'Multi-step business workflow', category: 'flow' },
    { name: 'featureFlag', description: 'Behind a feature flag',        category: 'feature' },
  ],
})

CLI reference

codeatlas index [path]   # scan and write .codeatlas/index.json
codeatlas flows [path]   # print detected flow names

Part of the CodeAtlas ecosystem

| Package | What it does | |---|---| | @ashwindojo/codeatlas-core | Parser, indexer, CLI ← you are here | | @ashwindojo/codeatlas-vite-plugin | Live MCP server inside vite dev | | @ashwindojo/codeatlas-mcp | Standalone MCP server for Claude Desktop & Cursor |

MIT © 2026