geethob 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # 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.

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 |