ix from last week") - **Project inference** — automatic detection of which projects you've worked on, with categories and aliases - **Episode extraction** — automatic detection of problem→fix sequences in your sessions - **Conversation segments** — topic-level clustering (stories, design discussions, debugging, planning) so recall finds the *why*, not just the *what* - **Git-aware project recall** — ask "where did we leave off on X" and get recent commits, unresolved issues, last session outcome in one call - **Git commit extraction** — structured extraction of every git commit, push, merge, checkout from sessions, linked to episodes - **MCP server** — 16 tools that let Claude query Longhand directly during live conversations - **Auto-ingest hook** — drops into Claude Code's `SessionEnd` hook so new sessions are indexed automatically - **Context injection** — `UserPromptSubmit` hook auto-injects relevant past context before Claude sees your message (configurable threshold and size cap) - **Configurable** — `longhand config` to tune injection relevance, token budget, and behavior without editing code --- ## Install ```bash pip install longhand longhand setup ``` That's it. `longhand setup` backfills your existing Claude Code history, installs the hooks that keep it updated automatically, registers Longhand as an MCP server for Claude Code, and verifies everything works. About two minutes the first time, zero maintenance after that. To upgrade later: `pip install -U longhand`. ### Developer install (from source) ```bash git clone https://github.com/Wynelson94/longhand.git cd longhand pip install -e . longhand setup ```

Or run the individual commands yourself

```bash longhand ingest # ingest all your existing Claude Code history longhand analyze --all # run analysis (projects, outcomes, episodes, segments) longhand hook install # auto-ingest every future session longhand prompt-hook install # (optional) auto-inject past context into new prompts longhand mcp install # let Claude Code call Longhand as MCP tools longhand config # view/tune hook behavior (relevance threshold, injection size) longhand doctor # verify everything is wired up ```

--- ## Quick Start ```bash # What's in the archive? longhand stats longhand sessions longhand projects # Daily-use commands longhand recap # what have I been up to longhand recap --days 30 --project bsoi # filtered recap longhand continue # pick up where I left off (session-scoped) longhand status # where did we leave off on a project (git-aware) longhand patterns # what bugs do I keep fixing longhand history src/app/route.ts # every edit ever to a file # Semantic search longhand search "race condition" longhand search "stripe webhook" --tool Edit longhand search "why did we" --type assistant_thinking # Proactive recall (the fun one) longhand recall "that clerk type error I fixed a couple weeks ago" longhand recall "the python missing module bug last month" # Session inspection longhand timeline longhand replay /path/to/file.ts longhand diff # Git history longhand git-log # recent git operations across all sessions longhand git-log # git ops in a specific session longhand git-log --type commit # only commits longhand git-log --query "fix parser" # search commit messages # Export longhand export latest-fix # most recent resolved episode longhand export ep_ --out fix.md # specific episode to file longhand export # full session timeline # Configuration longhand config # show current hook settings longhand config --set hook.min_relevance=3.0 # tune injection threshold longhand config --set hook.max_inject_chars=1000 # cap t

Longhand

Tools

Server Config