🍯 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

This is the beginning of the README. Read the rest at the original. Read the full README ↗