geethob 0.1.0 → 0.1.2

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,27 @@
+# Changelog
+
+## v0.1.2
+
+- New `geethob skill install` subcommand wires the bundled skill into Claude Code in one step. The full install is now `npm install -g geethob && geethob skill install` — no GitHub SSH key required (unlike the `/plugin install` path on current Claude Code versions).
+- Renamed the bundled skill from `narrate` to `geethob` so the package name and the skill name match. Invocation slash form is now `/geethob:geethob` (or the agent auto-invokes via the Skill tool).
+- Dropped the legacy `skill/` directory; `skills/geethob/SKILL.md` is the single source of truth.
+- Fixed the hardcoded `0.1.0` version string in `--version` output.
+
+## 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/README.md

@@ -13,37 +13,59 @@ 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 (Claude Code today; Hermes, OpenClaw, Cursor, MCP servers as adapters land).
+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)
+
+```bash
+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](#single-binary-no-runtime-needed) 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:
+
+```bash
+git config --global url."https://github.com/".insteadOf "git@github.com:"
+```
+
+### Cursor / Codex / Hermes / OpenClaw / plain terminal
+
+```bash
+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`](./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 the binary for your platform from [the latest release](https://github.com/hemant1996/geethob/releases/latest), drop it on your `$PATH`, and `chmod +x`:
+Download from [the latest release](https://github.com/hemant1996/geethob/releases/latest), drop on your `$PATH`, `chmod +x`:
 
 ```bash
 # 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
+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
+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
+curl -L https://github.com/hemant1996/geethob/releases/latest/download/geethob-linux-x64 -o /usr/local/bin/geethob && chmod +x /usr/local/bin/geethob
 ```
 
-### From npm
-
-Requires Node ≥20 or Bun ≥1.1.
+After installing the binary, run `geethob skill install` to wire it into Claude Code.
 
-```bash
-npm install -g geethob
-# or
-bun add -g geethob
-```
+`geethob serve` (MCP server mode) is on the v0.2 roadmap.
 
 ## Configure
 
@@ -77,39 +99,6 @@ 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.
 
-## Use from your AI harness
-
-geethob ships as a skill that any compatible AI harness can invoke.
-
-### Claude Code — plugin install (recommended)
-
-Inside Claude Code, run:
-
-```
-/plugin marketplace add hemant1996/geethob
-/plugin install geethob@hemant1996
-```
-
-The plugin bundles the `narrate` skill, which Claude Code's Skill tool will invoke automatically whenever you ask story-grained questions about a repo's history. You can also invoke it explicitly via `/geethob:narrate`.
-
-### Claude Code — manual install (legacy)
-
-If you prefer a shell-based install:
-
-```bash
-./skill/install.sh
-```
-
-This drops `SKILL.md` into `~/.claude/skills/geethob/`. Restart Claude Code (or reload skills) and the `geethob` skill is invokable from the Skill tool.
-
-### Hermes / OpenClaw / Cursor
-
-Manual until v0.2 ships adapters. Each harness has a skills directory; copy `skill/SKILL.md` into it and adjust the invocation paths to point at the `geethob` binary on your `$PATH`. PRs welcome with one-line install snippets for any harness you've tested.
-
-### MCP server (v0.2)
-
-`geethob serve` will expose `story` and `digest` as MCP tools so any MCP-compatible host can invoke them without shelling out. Not in v0.1.
-
 ## Exit codes
 
 | Code | Meaning |

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>