Lodestar — a head start for your next session

Less rediscovery

Good work should
carry forward.

Every new session needs its bearings. What matters in this project? Which decision still stands? What changed since the last run?

Lodestar gives your agent a current starting point and a clear way to correct it. You stay in charge of the work.

01 / ORIENT

Find your bearings.

Start in your project directory. Get the relevant saved context, decisions, and unfinished work alongside the sources your agent needs to inspect.

lodestar start --cwd .

02 / CHECK

Notice what changed.

Local source checks flag evidence that needs another look. A saved claim remains an observation, with its source and scope attached.

lodestar find "release process"

03 / CONTINUE

Leave a useful next step.

Keep consequential decisions, corrections, and actual outcomes. Checked updates preserve history and surface conflicts for a deliberate correction.

lodestar put --file update.json

The premise

Useful enough to reach for.
Clear enough to trust.

Automatic orientation when your host loads the skill. Native instructions and your decisions keep their authority. Missing optional context never becomes a reason to stop well-grounded work.

Read the operating boundaries

Updated for the way agents work

What changed in 2.1?

Read-only startup, fresh local source checks, and one checked update contract replace the older hook-driven workflow. Native setup now owns its installed copies and reports conflicts. The result is easier correction, clearer recovery, and less repeated discovery.

Version 2.1.4 fixes startup of the optional Codex plugin after installation. The plugin now keeps the complete shared runtime in its cache. Automatic skill selection remains enabled, and your own instructions and settings remain in place.

Read the changes and upgrade notes

Get started

One local tool.
Your existing workflow.

Native skill installation for Codex, Claude Code, OpenCode, and Hermes. A CLI for scripts and other agents. The optional Codex plugin adds structured tools.

Requires Node.js 24.15.0 or newer. Windows and WSL share one Windows-owned database.

Installation and host setup

New installationv2.1.4

# Install and inspect the setup plan
npm install --global lodestar-agent-context@2.1.4
lodestar setup --target all

# Apply the selected setup, then initialize
lodestar setup --target all --apply
lodestar init
lodestar start --cwd .

Already have a registry? Follow the upgrade and recovery instructions before converting an older store.

Explore the source Release notes & downloads Package on npm

Good work should carry forward.