AI now writes code faster than humans can review it. A 2,000-line AI-generated PR is hard to read at the diff grain — but the value is at the story grain: what was attempted, what changed mid-flight, what shipped. geethob reads a repository and produces prose someone would actually forward.

Two modes in v0.1:

• geethob story <repo> — narrate the history of a feature, module, or the whole repo.
• geethob digest --since 7d — narrate a developer's recent work, formatted to paste cleanly into Slack or a PR comment.

Local-only. Bring your own model key. No server. Same binary works as a CLI for humans and a skill for AI harnesses.

Install

Claude Code (recommended — works everywhere)

npm install -g geethob && geethob skill install

Two things happen: the geethob binary lands on your $PATH, and the bundled skill is dropped into ~/.claude/skills/geethob/. Restart Claude Code (or reload skills) and ask a story-grained question about any repo.

Requires Node ≥20 or Bun ≥1.1. If you don't have either, use the single-binary install below.

Claude Code — plugin marketplace (alpha)

/plugin marketplace add hemant1996/geethob
/plugin install geethob@hemant1996

This is the standard Claude Code plugin install pattern, but current Claude Code versions clone via SSH on the install step. If you have a GitHub SSH key configured, it works. If you don't, either use the npm path above or run this once to tell git to use HTTPS for GitHub:

git config --global url."https://github.com/".insteadOf "[email protected]:"

Cursor / Codex / Hermes / OpenClaw / plain terminal

npm install -g geethob

After install, geethob is on $PATH for any harness with shell-tool access. To wire the skill into a specific harness, copy skills/geethob/SKILL.md into that harness's skills directory. PRs welcome with verified one-liners for harnesses you've tested.

Single-binary (no runtime needed)

Download from the latest release, drop on your $PATH, chmod +x:

# macOS arm64
curl -L https://github.com/hemant1996/geethob/releases/latest/download/geethob-darwin-arm64 -o /usr/local/bin/geethob && chmod +x /usr/local/bin/geethob

# macOS x64
curl -L https://github.com/hemant1996/geethob/releases/latest/download/geethob-darwin-x64 -o /usr/local/bin/geethob && chmod +x /usr/local/bin/geethob

# Linux x64
curl -L https://github.com/hemant1996/geethob/releases/latest/download/geethob-linux-x64 -o /usr/local/bin/geethob && chmod +x /usr/local/bin/geethob

After installing the binary, run geethob skill install to wire it into Claude Code.

geethob serve (MCP server mode) is on the v0.2 roadmap.

Configure

export ANTHROPIC_API_KEY=sk-ant-…

Or persist it on disk (file mode 0600):

geethob configure

For private GitHub repos, geethob also reads gh auth status (the GitHub CLI) or GH_TOKEN from the environment.

Use

# Narrate the history of a feature
geethob story . --path src/auth --since 30d

# Narrate a public repo
geethob story bun-sh/bun --max-commits 50

# Your week, as a story
geethob digest --since 7d

# Someone else's public activity
geethob digest --author tj --since 14d

--max-commits defaults to 200. If the prompt would overflow Claude Sonnet's context window, geethob sheds the oldest commits to fit and prints a warning.

Exit codes

| Code | Meaning | | --- | --- | | 0 | Success (including empty commit range — that's not an error) | | 1 | Usage error (bad flags) | | 2 | git not on $PATH or scope is not a git repository | | 3 | Missing or invalid Anthropic API key | | 4 | Model API error (after one retry on 5xx) | | 5 | GitHub API auth required, rate-limited, or repository not found |

Build from source

git clone https://github.com/hemant1996/geethob && cd geethob
bun install
bun run dev story .

To produce a single binary:

bun run build:bin  # current platform
bun run build:bin:darwin-arm64
bun run build:bin:darwin-x64
bun run build:bin:linux-x64

Design

See DESIGN.md for the full scope, premises, and rationale behind v0.1. The short version: v1 ships two modes (story, digest) because we want to validate the prose-quality thesis before building a structured two-pass engine. PR-review narrative, multi-provider, multi-format, named voices, and MCP server mode are all v0.2+.

License

MIT.