geethob 0.1.0 → 0.1.1

package/.claude-plugin/marketplace.json

@@ -0,0 +1,12 @@
+{
+  "name": "hemant1996",
+  "description": "Hemant Bangar's Claude Code plugins.",
+  "owner": { "name": "Hemant Bangar" },
+  "plugins": [
+    {
+      "name": "geethob",
+      "source": { "source": "url", "url": "https://github.com/hemant1996/geethob.git" },
+      "description": "Turn git history into prose narrative. CLI + skill, local-only, BYO API key."
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,12 @@
+{
+  "name": "geethob",
+  "description": "Turn git history into prose narrative. Use when the user asks 'what changed in this repo,' 'summarize these commits,' 'narrate the history of <feature>,' or 'what did <person> ship last week.' Local-only, BYO API key.",
+  "version": "0.1.0",
+  "author": {
+    "name": "Hemant Bangar"
+  },
+  "homepage": "https://github.com/hemant1996/geethob",
+  "repository": "https://github.com/hemant1996/geethob",
+  "license": "MIT",
+  "keywords": ["git", "github", "narrative", "changelog", "ai", "claude", "skill"]
+}

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+## v0.1.1
+
+- Slim the npm package from ~70 MB to ~700 KB by excluding the compiled Bun binary (`dist/geethob`) from the published tarball. The binary still ships via GitHub Releases for the single-binary install path; npm users only need the JS bundle.
+- Ship the Claude Code plugin manifest (`.claude-plugin/`) and the bundled skill (`skills/narrate/`) inside the npm package, so a global install also lights up the plugin path once Claude Code's HTTPS-source bug lands a fix.
+- Include `assets/logo.svg` in the package so README rendering doesn't 404 if viewed from the npm tarball.
+
+## v0.1.0
+
+Initial release.
+
+- `geethob story <scope>` — narrate the history of a local path or a public GitHub repo (`<owner>/<name>` form).
+- `geethob digest --since 7d` — narrate recent activity for the current working tree, a single remote repo (`--repo`), or a GitHub user (`--author`, falls back to public events when no local repo applies).
+- `geethob configure` — write `~/.config/geethob/config.toml` (mode 0600) with an Anthropic API key. Skipped automatically when `ANTHROPIC_API_KEY` is in the environment.
+- Single-binary builds for macOS arm64, macOS x64, Linux x64 via `bun build --compile`.
+- npm package (`bun add -g geethob` or `npm install -g geethob`) for Node ≥20.
+- Claude Code skill via `skill/install.sh` and `skill/SKILL.md`.
+- Hard cap of 200 commits per invocation (`--max-commits` to override), plus a token-budget pass that sheds oldest commits when the assembled prompt would exceed 150K tokens.
+- Six documented exit codes (0 success, 1 usage, 2 no-git, 3 no-key, 4 model error, 5 GitHub auth/rate).

package/assets/logo.svg

@@ -0,0 +1,55 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" width="256" height="256" role="img" aria-label="geethob logo: a smiling speech-bubble blob with a tiny git-graph inside">
+  <title>geethob</title>
+  <defs>
+    <linearGradient id="bodyGrad" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#FFB199"/>
+      <stop offset="100%" stop-color="#FF7A7A"/>
+    </linearGradient>
+  </defs>
+
+  <!-- speech-bubble blob body -->
+  <path d="
+    M 56 36
+    C 100 16, 156 16, 200 36
+    C 232 56, 240 96, 232 132
+    C 224 172, 188 200, 144 204
+    L 132 232
+    L 116 204
+    C 72 200, 36 172, 28 132
+    C 20 96, 28 56, 56 36
+    Z"
+    fill="url(#bodyGrad)"
+    stroke="#3D2B3D"
+    stroke-width="6"
+    stroke-linejoin="round"/>
+
+  <!-- left eye (smiling, commit-node shaped) -->
+  <circle cx="96" cy="110" r="10" fill="#FFFAF5"/>
+  <circle cx="98" cy="112" r="5" fill="#3D2B3D"/>
+
+  <!-- right eye -->
+  <circle cx="160" cy="110" r="10" fill="#FFFAF5"/>
+  <circle cx="162" cy="112" r="5" fill="#3D2B3D"/>
+
+  <!-- cheek dots (subtle warmth) -->
+  <circle cx="70" cy="140" r="6" fill="#FF5A5A" opacity="0.35"/>
+  <circle cx="186" cy="140" r="6" fill="#FF5A5A" opacity="0.35"/>
+
+  <!-- happy smile -->
+  <path d="M 100 152 Q 128 174, 156 152"
+        fill="none"
+        stroke="#3D2B3D"
+        stroke-width="6"
+        stroke-linecap="round"/>
+
+  <!-- tiny git-graph above the head: three commit nodes connected by a curve -->
+  <path d="M 86 64 Q 128 44, 170 64"
+        fill="none"
+        stroke="#3D2B3D"
+        stroke-width="4"
+        stroke-linecap="round"
+        opacity="0.85"/>
+  <circle cx="86"  cy="64" r="6" fill="#FFFAF5" stroke="#3D2B3D" stroke-width="3"/>
+  <circle cx="128" cy="50" r="6" fill="#FFFAF5" stroke="#3D2B3D" stroke-width="3"/>
+  <circle cx="170" cy="64" r="6" fill="#FFFAF5" stroke="#3D2B3D" stroke-width="3"/>
+</svg>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "geethob",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Turn git history into prose narrative. Open-source CLI + AI-harness skill.",
   "type": "module",
   "module": "src/cli.ts",
@@ -8,10 +8,14 @@
     "geethob": "./dist/cli.js"
   },
   "files": [
-    "dist/",
+    "dist/cli.js",
     "skill/",
+    "skills/",
+    ".claude-plugin/",
+    "assets/logo.svg",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "dev": "bun run src/cli.ts",

package/skills/narrate/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: narrate
+description: Turn git history into prose narrative via the geethob CLI. Use when the user asks "what changed in this repo," "summarize these commits," "narrate the history of <feature>," "what did <person> ship last week," or any "tell me the story of …" question against a git repository or a GitHub user. Two modes — `story` (history of a repo/path) and `digest` (a developer's recent activity). Output is prose, not bullet lists.
+---
+
+# narrate (geethob)
+
+You have access to the `geethob` CLI, which turns git history into prose narrative. Use it whenever the user asks for a story-grained summary of code changes, instead of reading individual commits or diffs yourself.
+
+## When to invoke
+
+Invoke geethob for any of these:
+
+- "What changed in `<repo or path>` lately?"
+- "Summarize the last N commits / week / month."
+- "Tell me the story of how `<feature>` was built."
+- "What did `<author>` ship this week?"
+- Before extending an existing feature — pull a narrative of its history first to ground your work.
+
+Do **not** invoke geethob for:
+
+- Reading a specific PR or diff line-by-line — use `gh pr view` / `git show` instead.
+- File-level code questions ("what does this function do") — read the file directly.
+- Anything outside a git repository.
+
+## Usage
+
+The binary lives on the user's `$PATH` as `geethob`. Run it via shell tool.
+
+### `geethob story <scope>`
+
+Narrate the history of a path or repo.
+
+```bash
+# Local repo, whole history (capped at 200 commits)
+geethob story /path/to/repo
+
+# Local repo, restricted to a subpath
+geethob story /path/to/repo --path src/auth --since 30d
+
+# Public GitHub repo
+geethob story bun-sh/bun --max-commits 50
+
+# Stream off (one-shot, useful if you're capturing output)
+geethob story . --no-stream
+```
+
+### `geethob digest`
+
+Narrate a developer's recent work.
+
+```bash
+# Current working tree, last 7 days
+geethob digest --since 7d
+
+# A single remote repo
+geethob digest --repo facebook/react --since 14d
+
+# A specific developer's public activity (when no local repo applies)
+geethob digest --author tj --since 7d
+```
+
+### `geethob configure`
+
+Writes `~/.config/geethob/config.toml` with an Anthropic API key. Skip if `ANTHROPIC_API_KEY` is already in the environment.
+
+## Auth
+
+- **Model API:** `ANTHROPIC_API_KEY` env var, or the stored config file.
+- **GitHub (for remote scopes):** `gh auth status` session OR `GH_TOKEN` env var. Optional for `story` against a local clone.
+
+## Exit codes
+
+- 0 — Success (including empty commit range, which is not an error)
+- 1 — Usage error
+- 2 — Not a git repo or `git` missing
+- 3 — Missing/invalid Anthropic key
+- 4 — Model API error after one retry
+- 5 — GitHub auth required, rate limited, or repo not found
+
+## Notes for the agent
+
+- Output is **prose**, not structured data. Don't post-process it into bullet lists.
+- For long histories, geethob truncates to the most recent N commits and prints a warning. If the user needs older history, they should pass `--since <ref>` or raise `--max-commits`.
+- geethob never sees the full diff — only commit messages + diffstats. This keeps narratives at the story grain. If the user needs line-level analysis, read the diff yourself.
+- The `geethob` binary must already be on `$PATH`. If it's not, suggest the user install it via `npm install -g geethob` or the single-binary download from https://github.com/hemant1996/geethob/releases.