Get Started

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

1

Install Lodestar

One command. macOS, Linux, Intel or Apple Silicon.

curl -fsSL kylex.io/install | sh
2

Run the setup wizard

Navigate to your project directory, then run init:

cd ~/your-project
lodestar init
The wizard will:
✓ Check git is installed (offers to install via Homebrew if not)
✓ Set up your AI provider (Anthropic, OpenAI, Google, Azure, or Ollama)
✓ Validate your API key
✓ Ask if this is a new or existing project
✓ Bootstrap existing projects (quick scan or full AI analysis)
✓ Auto-install git hooks + session hooks

Sessions are fully automatic after init. Context loads on open, saves on close.

3

Start coding

That's it. Open Claude Code and start working. When you're done, check the dashboard:

lodestar review

Opens a browser dashboard with feature progress, decisions, architecture diagrams, and session history.

1

Install Lodestar

One command. macOS, Linux, Intel or Apple Silicon.

curl -fsSL kylex.io/install | sh
2

Run the setup wizard

Navigate to your project directory, then run init:

cd ~/your-project
lodestar init

The wizard auto-configures Claude Desktop's MCP settings.

3

Restart Claude Desktop

Quit and reopen Claude Desktop to activate the MCP connection. Then set your project directory:

1. Select <your-project-folder> in the bottom-left
2. In the bottom-right, deselect worktree and select Local
3. Verify <your-project-folder> appears under Settings → Developer → MCP servers
Claude Desktop showing project selector with Local mode selected
4

Start coding

Sessions are automatic — context loads when you open Claude Desktop, saves when you close it. Check the dashboard anytime:

lodestar review
Optional: MCP tools in conversation
"Load my lodestar context" — reload context mid-session
"Synthesize this session" — manual save mid-session
"Check lodestar status" — check if synthesis is running
1

Install Lodestar

One command. macOS, Linux, Intel or Apple Silicon.

curl -fsSL kylex.io/install | sh
2

Run the setup wizard

Navigate to your project directory and run init. Select OpenAI as your provider (works with ChatGPT and Codex):

cd ~/your-project
lodestar init
The wizard will:
✓ Set up OpenAI as your synthesis provider
✓ Validate your API key
✓ Bootstrap your project (quick scan or full AI analysis)
✓ Install git hooks for automatic mid-session updates
3

Use with ChatGPT or Codex

Start and end sessions with simple CLI commands. Git hooks handle mid-session updates automatically on every commit.

lodestar start — load context before you begin
... code with ChatGPT / Codex ...
lodestar end — synthesize + commit when done

Git hooks auto-update feature progress on every commit — no extra commands needed mid-session.

lodestar review — open the dashboard anytime
1

Install Lodestar

One command. macOS, Linux, Intel or Apple Silicon.

curl -fsSL kylex.io/install | sh
2

Run the setup wizard

Navigate to your project directory and run init. Select Google as your provider:

cd ~/your-project
lodestar init
The wizard will:
✓ Set up Google (Gemini) as your synthesis provider
✓ Validate your API key
✓ Bootstrap your project (quick scan or full AI analysis)
✓ Install git hooks for automatic mid-session updates
3

Use with Gemini

Start and end sessions with simple CLI commands. Git hooks handle mid-session updates automatically on every commit.

lodestar start — load context before you begin
... code with Gemini ...
lodestar end — synthesize + commit when done

Git hooks auto-update feature progress on every commit — no extra commands needed mid-session.

lodestar review — open the dashboard anytime
1

Install Lodestar

One command. macOS, Linux, Intel or Apple Silicon.

curl -fsSL kylex.io/install | sh
2

Run the setup wizard

Navigate to your project directory and run init. Pick any provider you prefer:

cd ~/your-project
lodestar init
The wizard will:
✓ Set up your preferred AI provider for synthesis
✓ Validate your API key
✓ Bootstrap your project (quick scan or full AI analysis)
✓ Install git hooks for automatic mid-session updates
3

Use with Cursor

Start and end sessions with simple CLI commands. Git hooks handle mid-session updates automatically on every commit.

lodestar start — load context before you begin
... code with Cursor ...
lodestar end — synthesize + commit when done

Git hooks auto-update feature progress on every commit — no extra commands needed mid-session.

lodestar review — open the dashboard anytime

What happens automatically

With git hooks installed, Lodestar manages your sessions regardless of which AI coding tool you use.

Event What Lodestar does
You run lodestar startLoads context + prints session summary
You commit codeUpdates feature progress automatically
You run lodestar endSynthesizes session + commits context

Optional commands

You only need these when you want to.

Command What it does
lodestar saveMid-session checkpoint with optional notes
lodestar reviewOpen project dashboard in browser

That's it. Everything else is automatic.