shiplog

The captain's log for your codebase. Every decision, discovery, and trade-off — captured in GitHub as you ship.

Quick Install

npx skills add devallibus/shiplog --skill shiplog

Works with Claude Code, Codex, and Cursor. Only requires gh CLI.

Your AI assistant forgets everything between sessions

You brainstormed a design with Claude yesterday. Today, a new session starts from scratch. The reasoning behind that auth middleware? Gone. The three alternatives you rejected? Nowhere to be found. Last week's architectural decision? Buried in a chat log you can't search.

shiplog makes your git history remember everything. Not just what changed — but why it changed, what you considered, and what you discovered along the way.

Brainstorm → Issue → Branch → Commits → PR
    ↑                           ↑
    |         Discoveries → New Issues / Stacked PRs
    |
    └── Search it all later: issues, PRs, commits, memory

What you get

Every brainstorm becomes a GitHub Issue. Design decisions, alternatives considered, and a task list — all searchable forever.

Every commit carries context. Not just "add JWT validation" — but why JWT over sessions, what you tried first, and what to watch out for.

Every PR tells the full story. A timeline of the entire journey: what was planned, what was discovered mid-work, what changed and why.

Nothing falls through the cracks. Find a sub-problem while coding? shiplog routes it — fix inline, stack a prerequisite PR, or spin off a new issue. Your discovery is never lost.

Any model can pick up where another left off. Every artifact is signed with who wrote it (which AI model, which tool). Context handoffs between models are first-class — not copy-paste.

How it works

You say "let's brainstorm auth middleware" and shiplog captures the result as a GitHub issue. When you say "work on #42", it creates an isolated branch in a git worktree. As you commit, it logs the reasoning. When you open the PR, it writes a timeline of the whole journey.

Your existing workflow, with a knowledge trail that persists across sessions, models, and tools.

Two modes

Full Mode (default) — Knowledge goes directly into issues and PRs. Perfect for personal projects and open source.

Quiet Mode — Your team sees clean PRs. The full reasoning lives in a separate --log branch, one click away.

main
  └── feature/auth-middleware            ← Clean PR (team sees this)
        └── feature/auth-middleware--log  ← Knowledge trail (one click away)

Features

Cross-model review