Grow a beautiful forest in your terminal with Claude Code!

<div align="center">

Honeytree

Grow a pixel-art forest in your terminal every time you use Claude Code.

Each prompt plants a new tree. Each tree grows over time. Your forest evolves from a clearing into an ancient woodland — and it never resets.

</div>

---

Quick Start

BASH
npm install -g honeytree  
honeytree init  
honeytree  

That's it. Three commands:

1. Install — installs the CLI globally
2. Init — creates your forest and registers a Claude Code hook that plants a tree after every response
3. View — opens the live viewer in your terminal (run this in a separate terminal pane)

After init, trees are planted automatically. No manual steps needed. Just keep using Claude Code and watch your forest grow.

---

How It Works

honeytree init does two things:

1. Creates ~/.honeydew/forest.json — your persistent forest state
2. Adds a Stop hook to ~/.claude/settings.json — runs honeytree plant after every Claude Code response

Every response plants a tree at a random position, with a random species and growth stage. Existing trees grow a little each time too.

Open the viewer (honeytree) in a second terminal to watch it happen in real time. The viewer auto-updates when new trees appear — no refreshing needed.

---

Panning

Your forest is wider than your terminal. Use left/right arrow keys to pan across the full canvas and explore your forest.

When a new tree is planted, the viewer automatically scrolls to show it. A minimap in the stats bar shows your current position.

---

Streaks

Honeytree tracks your coding streak — consecutive days using Claude Code.

• Active streak — displayed in the stats bar (e.g. 7-day streak)
• Broken streak — miss a day and your forest starts wilting: trees desaturate toward brown, fog rolls in
• Recovery — your next prompt clears the wilting immediately

Plant a tree to bring it back to life.

---

Biomes

Your forest evolves visually as it grows:

Trees are never deleted. The forest only grows.

---

Tree Species

Five species, randomly assigned at planting:

Each species has 4 growth stages: seed, sapling, young, full. Existing trees grow a little with each new prompt.

---

Badge

Add a live badge to any repo's README:

BASH
honeytree badge  

Creates honeytree-badge.svg in your current directory. Embed it with:

MARKDOWN
[![honeytree](./honeytree-badge.svg)](https://github.com/Varun2009178/honeytree)  

Re-run honeytree badge to update with latest stats.

---

FOREST.md

Generate a shareable markdown snapshot:

BASH
honeytree md  

Creates FOREST.md with your badge, stats, a plain-text rendering of your forest, and total prompts. Commit it to your repo so your team can see the forest.

---

CLI Reference

---

Stats Bar

The viewer shows a stats bar below your forest:

 honeytree · 42 trees · 7-day streak · ████████░░░░ next: oak [woodland] [═══─────────]  

---

Requirements

• Node.js 18+
• Claude Code (for the automatic hook)

Links

• npm: npmjs.com/package/honeytree
• GitHub: github.com/Varun2009178/honeytree
• Issues: github.com/Varun2009178/honeytree/issues

License

MIT

Source: https://github.com/Varun2009178/honeytree