cr8rcho
alkahest-cli

alkahest-cli

The open-source CLI for Alkahest. Framework adapters from Next.js to SwiftUI and Flutter scan your code into a product map, and an MCP server hands it to your coding agents. No API key.

Node.js
TypeScript
ts-morph
MCP
npm

Key Features

Screen-Level Product Map

alkahest scan reads your routes, navigation and API calls into .alkahest/map.json. The output is deterministic, scans are incremental, and alkahest hook install refreshes it on every commit.

Pluggable Framework Adapters

Next.js, React Router, Remix, Nuxt, Vue Router, Angular, SvelteKit, Astro, React Native, SwiftUI, UIKit, Jetpack Compose, Flutter, Django, Flask, Rails and plain HTML. A new framework is just a new adapter.

MCP Server, No API Key

alkahest mcp gives Claude Code, Codex or Cursor tools like overview, get_screen and who_calls. Your agent reads the map and writes summaries and PRDs back with set_summary and set_prd.

Publish a Shareable Link

Sign in with a token and run alkahest publish. Only the derived map goes up to alkahest.app, never your source files.

Issues and Notes from the Terminal

Create and finish issues on the issue map, write notes on the note map, and import a folder of Markdown files as notes, all from the command line or from your agent.

Comments to GitHub Issues

alkahest comments pull brings map comments down with the files and lines they point at. alkahest comments issue files them as one GitHub issue through gh and links it back.

Tech Stack

TypeScript

Language

ts-morph

Static Analysis

MCP SDK

Agent Protocol

Commander

CLI Framework

Zod

Validation

Project Info

Platform

Node.js 20+

Category

Developer Tools

Languages

EN

Install from npm

Run npm i -g @cr8rcho/alkahest, then alkahest scan in your project. The CLI is MIT-licensed and open source on GitHub.