Skip to content

LodeGit tells you what changed. Lode tells your next coding agent why.

Install, run the demo, capture one session, then query one decision with cited local evidence.

For Technical Professionals: Roll Work Up, Drill Down

Roll work up for reporting. Drill down to verify.

Lode turns scattered work from AI collaboration into report-ready, verifiable outcomes. When questions arise, trace each outcome back to decisions, tradeoffs, and evidence.

text
Report upward: session signals → work streams → outcomes and impact
Verify downward: outcomes and impact → decisions and tradeoffs → source refs

This use case is for developers, tech leads, and small technical teams that need to explain technical work. Activity counts measure record coverage; they do not prove outcomes by themselves. Lode does not expand into generic meetings, approvals, or employee monitoring.

Skills

Each skill maps to a habit you already have. Activate it with a namespaced command.

SkillWhenWhat it does
/lode:cold-start-interviewFirst runCreates ~/.lode/config.yaml with vault path, project identity, and report preferences
/lode:captureWrap-up or checkpointQuietly captures session depth, stage progress, and artifacts
/lode:queryTargeted follow-upAnswers "why did we choose this?" with cited decision replay evidence
/lode:recallSession start, after history existsRecalls recent decisions, risks, open questions, and relevant docs
/lode:roadmapAfter multiple decisionsGenerates narrative decision roadmap with accumulating risks
/lode:dailyDaily, on demandUpdates Obsidian daily notes from raw entries and git history
/lode:weeklyWeekly, on demandBuilds weekly outline from raw entries with conditional hard-stuff section
/lode:monthlyMonthly, on demandGenerates monthly review and candidate rules from repeated evidence

The Replay Loop

text
install → demo → capture one session → query one decision

This is the first value path. Weekly, monthly, recall, and roadmap outputs are compounding layers on top of the same local record. Skills are independent, but they share one storage convention so downstream views reuse earlier evidence.

Decision Replay

Lode dogfoods a derived decision replay index for its own project history. Raw entries remain the source of truth; {vault}/raw/decisions/{slug}.json gives coding agents compact evidence packs for targeted "why did we choose this?" queries.

See the dogfood proof on GitHub.

Install

bash
codex plugin marketplace add KKenny0/Lode
codex plugin add lode@lode

Update:

bash
codex plugin marketplace upgrade lode
codex plugin add lode@lode

Only use the legacy fallback when codex plugin add is unavailable:

bash
npx @lode/cli install-codex-plugin

Then run the demo, run /lode:cold-start-interview once, capture one real session with 收工, and query one decision with /lode:query.

No vault? No problem. 收工 outputs structured Markdown directly in the conversation. With a vault, capture writes quietly by default; use /lode:capture checkpoint during long sessions.

Released under the MIT License.