Get Started

Up and running in under 2 minutes. Pick your tool.

Install Lodestar

Choose your preferred install method:

npm (recommended)

npm install -g lodestar

Homebrew

brew install lodestar

Binary

curl -fsSL kylex.io/install | sh

Run the setup wizard

The wizard configures your AI provider and auto-connects to Claude Code:

lodestar init

The wizard will:

✓ Ask which AI provider you use (Anthropic, OpenAI, or Ollama)

✓ Walk you through API key setup

✓ Validate your key with a test call

✓ Auto-configure Claude Code's MCP settings

✓ Offer to bootstrap your existing project

✓ Install git hooks (optional)

Start using it

Three commands — that's the entire workflow:

Start of session — load previous context

lodestar start

Or just tell Claude: "lodestar start"

Mid-session — save a checkpoint

lodestar save

You'll be prompted for optional notes. Hit Enter to skip.

End of session — synthesize + commit

lodestar end

Synthesizes context, commits .lodestar.md, done.

Review your project dashboard

See your project status, decisions, and architecture at a glance:

lodestar review

Opens a browser-based dashboard with feature progress, decisions, patterns, and Mermaid architecture diagrams.

Optional: Install git hooks

Auto-update feature status on every commit (no LLM cost). Commit .lodestar.md on push.

lodestar hooks

Coming Soon

Cursor Integration

Lodestar works with Cursor today via MCP. A dedicated guide with Cursor-specific setup is coming soon.

Works now — manual MCP config

lodestar init

Select Cursor during tool setup

Coming Soon

VS Code Extension

A VS Code extension with sidebar integration, inline context display, and one-click synthesis is in development.

Want early access? Join Pro Early Access

All Commands

Command	What it does	Cost
lodestar init	First-time setup wizard	Free
lodestar start	Load previous session context	Free
lodestar save	Mid-session checkpoint (full synthesis)	~$0.01
lodestar end	Synthesize + commit — end session	~$0.01
lodestar review	Open project dashboard in browser	Free
lodestar bootstrap	Capture existing project structure	Free
lodestar hooks	Install git hooks (auto-update on commit)	Free

All commands default to the current directory. No path needed.