🍯 honey-stack
An always-on workflow layer for Claude Code and Codex that learns from every session.
honey-stack combines the best of Superpowers, Ponytail, Matt Pocock's skills, pstack and gstack in one small layer, then adds RSI (recursive self-improvement): it learns from your corrections and can apply validated improvements on its own.
- Small: ~2 KB of always-on rules, not ~25 KB of stacked prompts.
- Disciplined: sizes each task, makes the smallest complete change and proves it before "done".
- Self-improving: turns your corrections into rules and evaluated skill patches.
- Local and reversible: Honey state stays in
~/.honey/; honey uninstall restores everything. External history integrations are optional.
Quick start
Needs Claude Code and/or Codex, python3 3.9+ and git on macOS or Linux.
1. Install. This clones the repo and shows a dry run; then run the install command it prints.
curl -fsSL https://raw.githubusercontent.com/umararshad4/honey-stack/main/install.sh | bash
2. Activate. Claude Code: start a new session or run /reload-plugins. Codex: open /hooks and trust the honey entries.
3. Check. Run honey doctor. Replies now start with 🍯 HONEY · direct.
Manual and plugin-only installs, hook troubleshooting and the hooks unverified label are covered in the setup guide.
Everyday use
Work as usual: honey sizes each task and picks the right skill. To steer it, send one of these as the whole message:
| Say | What it does |
|---|
honey direct · honey balance · honey explain | Concise (default), moderate or detailed replies. Append default to save. |
honey off · honey on | Pause or resume honey for this session. The safety guard stays on. |
honey status | Show the active mode. |
remember: when X, Y | Teach a rule now. Scope it with (project), (claude), (codex) or (skill:<name>). |
rsi off · rsi on | Pause or resume learning for this session. |
update hooks | Update now and review honey's hooks in Codex. |
Modes change how much is explained, not how carefully work is done. Sizing, verification and safety apply in every mode.
Skills
Flow: grill → plan → execute → verify → review → ship. Bugs start at debug.
| Invoked | Skills |
|---|
| Automatic | grill plan execute debug tdd verify review ship deploy test-design tooling database perf observability api-design upgrade incident frontend stageshow qa security docs |
| On demand | honey rsi unslop reverse-engineer handoff delta prototype architecture domain teach write-skill principles opensrc project-verify triage research statechart |
Call a skill with /honey:<skill> in Claude Code or $<skill> in Codex. See docs/skills.md for focused workflows and browser QA.
Delta: pick up where you left off
Honey integrates with Delta to find decisions in earlier conversations and carry their context into a new session. Use it to recover a decision, check what was already tried, or attach conversation history to a handoff. Honey keeps working normally without Delta.
Install Delta
Install the optional Delta app and CLI on each computer where you want to use history. On macOS or Linux:
curl -fsSL https://delta.dev/install.sh -o delta-install.sh
sh delta-install.sh
delta auth login
delta --version
honey delta status
Use Delta 0.22.0 or newer. If it is already installed, check for updates with delta update --check and install an available update with delta update. The official installation guide covers other platforms.
Use your history
Ask for /honey:delta in Claude Code or $delta in Codex, or run these commands in your terminal:
| You want to… | Run |
|---|
| Check installation, sign-in and capture settings | honey delta status |
| Find an earlier decision | honey delta recall cache expiry |
| Find conversations that touched a file | honey delta search authentication --edited-path 'src/**' |
| Read a specific conversation | honey delta read THREAD_ID --messages 1-1 |
| Check whether its summary is current | honey delta summary THREAD_ID |
Replace THREAD_ID with an ID returned by search, or use a Delta join link. Reads start with one message so short conversations work. Choose a larger range when needed, up to 20 messages per call. History results are JSON and default to at most 12,000 characters; shortened results say truncated: true.
For handoffs, Honey can attach a verified thread reference, the current Git state and test-report fingerprints to your local summary. Restoring it checks what changed and keeps the summary usable if Delta is unavailable. See the Delta guide for attach, restore, readiness fields and troubleshooting.
Record new conversations, optionally
History lookup works in both Claude Code and Codex. To record new Claude Code sessions, install Delta's separate official plugin:
claude plugin marketplace add zed-industries/delta-claude
claude plugin install delta@zed-industries
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
