devallibus/shiplog

shiplog keeps a project's discussion, decisions, and work context in GitHub issues and PRs, so you can recall what you said and the next agent session can pick up the work. It is a skill (plain markdown instructions) for Claude Code, Codex, and Cursor, for people who plan and build with coding agents and want that history to outlive the chat window.
## Install
bash
npx skills add devallibus/shiplog --skill shiplog
The skill directory is self-contained: a skill-only install has every procedure it needs. Add --agent claude-code, --agent codex, or --agent cursor to target one agent; run npx skills update to refresh.
As a Claude Code plugin, which also adds the slash commands /shiplog:plan, /shiplog:start, /shiplog:capture, /shiplog:commit, /shiplog:pr, /shiplog:lookup, /shiplog:hunt, /shiplog:resume, /shiplog:review, and /shiplog:models:
bash
/plugin marketplace add devallibus/shiplog
/plugin install shiplog@shiplog
From a local checkout: claude --plugin-dir .. The slash commands are short entry points to the same procedures in skills/shiplog/; plain requests ("save this idea", "resume #42") work without them.
## What you get: three records
1. The original discussion, verbatim. Your messages are copied in order, unedited, with who said them and who recorded them. Rejected ideas and doubts stay in. Corrections are added as new entries; earlier wording is never rewritten. A source entry, posted as an issue comment:
markdown
Source: Codex session, messages 2-3. Recorded by: assistant.
Coverage: available messages only.
### Message 2
Speaker: user
text
but i wouldn't want to lose the things i said as a human, you know
2. One current summary in the tracking issue body: goal, current decisions (each linked to its source entry), tasks, checks, and next action. It is edited when facts change, not appended to.
markdown
## Goal
A small core that preserves human discussion and compact retrieval.
## Current decisions
Routing stays as an option, off by default (source).
## Tasks
[x] T1: Capture discussion verbatim
[ ] T2: Make resume read the summary first
## Next action
Implement T2.
3. A small retrieval index. New records start with the short envelope shown above. The helper skills/shiplog/scripts/shiplog-read.sh returns those compact fields first, and full text only when the question needs it:
bash
shiplog-read.sh index # one line per open issue and PR: kind, tasks, labels, title, summary
shiplog-read.sh show 42 # #42's envelope, computed tasks, open tasks, one line per enveloped comment
shiplog-read.sh source 42 # exact text of the kind: source comments on #42
shiplog-read.sh search "auth" # matching issues, PRs, and local commits, one line each
Add -R OWNER/REPO before the command to read another repository. Task counts are computed from the checkboxes; no copies of derived state are stored. Only records from accounts GitHub marks as OWNER, MEMBER, or COLLABORATOR count as project records; envelopes from anyone else are shown as untrusted, with author and link only. Byte and API-call measurements for the helper are in tests/reader/MEASUREMENTS.md.
## A day with it
1. "Save this idea": the discussion becomes an issue with a source entry. No branch needed.