logmind.
v0.1 ⁄ released 2026-05-15 ⁄ MIT

Decisions,
captured.
while you work.

An opinionated decision log for AI-assisted development. One CLI command per architectural choice. Branch-aware by default. AGENTS.md canonical. Plugs into the agents you already use — Claude Code, Cursor, Codex, Cline, Continue — with no per-tool drift.

three principles
i.

branch-aware

Decisions on a feature branch land in docs/decisions-branches/<branch>.md. On PR merge, an action appends a one-line summary to docs/decisions.md with the PR link. No more conflicts on the shared file.

ii.

agents.md-first

A single canonical instruction file. CLAUDE.md, .cursorrules, .windsurfrules, .clinerules, AGENTS.md — nine of them become two-line stubs pointing at the canonical source. No drift, no duplication.

iii.

link integrity

A GitHub Action ships with logmind init: every relative [link](path.md) between docs is verified on every PR. A rename can never silently orphan an agent's context again.

section ii

install.

Three channels. The same package. Pick whichever lives closest to your other dev tools.

01
pip
$ pip install logmind
02
homebrew
$ brew tap thrillmot/logmind && brew install logmind
03
agent skill
$ npx skills add -g thrillmot/logmind-skill

The agent skill is optional but recommended — it teaches Claude Code, Cursor, Codex et al. when and how to call logmind log in any project that has logmind installed.

section iii

quickstart.

Init once per repo. Then log every meaningful choice. Branch routing happens automatically.

~ ⁄ feat__auth
$ logmind init
$ git checkout -b feat/auth
$ logmind log "JWT for stateless API auth" \
    -r "horizontal scaling without session store" \
    -a "server sessions in Redis" \
    -i "rotate signing keys quarterly"
✓ wrote docs/decisions-branches/feat__auth.md

“The why behind the code disappears faster than the what. logmind makes that disappearance expensive on purpose.”

— project README