lets bee friends 🐝
Claude CLI That Works When Claude Doesn't

The secret sauce: Intelligent background processing that recovers from Claude usage limits.
Voice-activated automation with 95+ tools, natural language scheduling, and adaptive retry logic.

npm install -g @calmhive/calmhive-cli
View on GitHub β†’
Terminal
$ calmhive chat "hello world"

Why Calmhive?

Core features that make development faster

πŸ”„

Smart Retry

Never lose work to rate limits. Automatic exponential backoff keeps your tasks running.

πŸŽ™οΈ

Voice Control

Say "hey friend" to activate. Control Claude with natural speech commands.

πŸƒ

Background AFk

Run long tasks in the background while you focus on other work. Multi-iteration support.

πŸ–₯️

Beautiful TUI

Monitor all your sessions in one place with our terminal UI. Vim-style navigation included.

🧰

MCP Ready

Optional access to 95+ tools when you need them. Sequential thinking, GitHub, and more.

πŸ“…

Natural Scheduling

Schedule tasks with "daily at 9am" or "every Monday". Natural language to cron conversion.

πŸ“‹

Task Templates

5 built-in templates for bug-fix, feature development, refactoring, testing, and optimization.

πŸ“ˆ

Progress Tracking

Real-time progress monitoring for AFk sessions with iteration summaries and milestones.

πŸ› οΈ

Open Source

MIT licensed. Contribute, customize, and extend as needed for your workflow.

See It In Action

TUI

πŸ–₯️ Beautiful TUI

$ calmhive tui

β”Œβ”€ Active Sessions ─────────────┐
β”‚ afk-abc123: refactor (23/50) β”‚
β”‚ afk-def456: add tests (5/10) β”‚
β”‚ afk-xyz789: docs (complete)  β”‚
└─ j/k: navigate | Enter: logs β”˜
Voice

πŸŽ™οΈ Voice Control

$ calmhive voice

πŸŽ™οΈ Voice mode activated
Say "hey friend" to start...
> "hey friend, refactor the auth system"
🐝 Got it! Starting refactor...
AFk

πŸƒ AFk Background

$ calmhive afk "big task" --iterations 20

🐝 Starting AFk session...
Session: afk-12345678
β˜• Sleep prevention enabled
Running in background...
TUI

TUI Navigation

β”Œβ”€ Session Details ────────────┐
β”‚ ID: afk-abc123               β”‚
β”‚ Task: refactor auth system   β”‚
β”‚ Progress: β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–‘β–‘ 45%     β”‚
β”‚ Logs: Press Enter to view    β”‚
β”‚ Stop: Press 's'              β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
TUI

TUI Vim Commands

TUI Keyboard Shortcuts:
j/k - Move up/down
gg  - Jump to top
G   - Jump to bottom
/   - Search sessions
q   - Quit TUI
TUI

TUI Live Updates

β”Œβ”€ Real-time Status ──────────┐
β”‚ ● afk-123: Running...       β”‚
β”‚   └─ Iteration 15/30        β”‚
β”‚   └─ Processing file.js     β”‚
β”‚   └─ ETA: ~12 minutes       β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
Auto

Smart Retry

⚠️ Rate limit at iteration 10
⏳ Waiting 60s...
⏳ Waiting 120s...
βœ… Resumed automatically!
No manual intervention needed
Auto

Context Compression

⚠️ Context limit approaching
πŸ—œοΈ Auto-compressing...
βœ… Compressed successfully!
Continuing seamlessly...
AFk

AFk Management

$ calmhive afk tail abc-123

πŸ“œ Live logs streaming...
[14:23:15] Processing auth.js
[14:23:18] Found 3 issues
[14:23:21] Applying fixes...
AFk

Session Cleanup

$ calmhive afk cleanup 3

🧹 Cleaning old sessions...
Removed: 8 sessions (120MB)
Active sessions preserved
Pro

Quick Aliases

$ calmhive a "fix bug"  # afk
$ calmhive c -c         # continue
$ calmhive t            # tui
$ calmhive v            # voice

🐝 Save keystrokes!
Auto

Sleep Prevention

β˜• Caffeinate active (PID: 12345)
Mac stays awake for AFk
Perfect for overnight tasks
Auto-disabled when done
Workflow

Morning Routine

$ calmhive c -c  # Continue from AFk

🐝 What did you accomplish overnight?

βœ… Refactored auth system (12/20)
βœ… Added TypeScript types (complete)
βœ… Fixed 8 test failures (complete)
⏸️ Paused at API documentation
Voice

Complex Voice Commands

πŸŽ™οΈ "Start an AFk session to analyze
the database performance issues in
the user service and create a detailed
optimization report with 15 iterations"

🐝 Starting AFk: performance analysis...
Session ID: afk-perf-analysis
TUI

TUI Search

Search: /auth
β”Œβ”€ Filtered Sessions (2/5) ───────┐
β”‚ ● afk-auth-fix: Running (12/20)β”‚
β”‚ β—‹ auth-tests: Complete         β”‚
β”‚                                β”‚
β”‚ ESC: Clear | Enter: Select     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
Recovery

Smart Error Recovery

⚠️ Error at iteration 8/20
πŸ”„ Auto-retry in 30s...
πŸ”„ Retry attempt 1 of 3...
βœ… Recovered! Continuing from 8/20

No manual intervention needed
Config

One-Command Setup

$ calmhive config install

πŸ“‹ Installing enhanced CLAUDE.md...
βœ… Backup created: ~/.claude/CLAUDE.md.bak
βœ… Framework v11.0.0 installed
🐝 lets bee friends framework active
Pro

Parallel Sessions

$ calmhive afk "tests" -i 5 &
$ calmhive afk "docs" -i 8 &
$ calmhive tui

β”Œβ”€ 2 Active Sessions ─────────┐
β”‚ ● tests: Running (3/5)      β”‚
β”‚ ● docs: Running (5/8)       β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
v14

πŸ“… Natural Scheduling

$ calmhive schedule create "daily at 9am" \
  "calmhive run 'analyze security logs'"

🐝 Creating schedule...
βœ… Schedule created: daily-security-check
Cron: 0 9 * * *
Next: Tomorrow 9:00 AM
πŸš€ Scheduler daemon running
v14

πŸ“‹ Task Templates

$ calmhive template use bug-fix auth-issue

🐝 Using template: bug-fix
Variables: {{ISSUE}} = auth-issue
πŸš€ Starting AFk session (8 iterations)
Session: afk-bug-fix-auth-issue
v14

πŸ“ˆ Progress Tracking

$ calmhive progress afk-123

πŸ“ˆ Progress Report: feature-dev
Iterations: 8/12 (67%)
βœ… Authentication implemented
βœ… Tests added and passing
πŸ”„ Currently: API documentation
⏱️ ETA: ~15 minutes

Terminal UI Deep Dive

Your command center for managing all Claude sessions

Keyboard Shortcuts

Navigation

j/k Move up/down
gg Jump to top
G Jump to bottom
↑/↓ Arrow navigation

Session Management

Enter View logs/details
s Stop session
r Resume session
n New session

System

/ Search sessions
l View logs
c Cleanup old sessions
q Quit TUI

Ecosystem Integration

Calmhive works seamlessly with the broader Claude ecosystem

πŸ–₯️

Claude Desktop

Import MCP tools from Claude Desktop to supercharge your CLI workflows with 95+ tools.

⚑

Claude Code CLI

Built on top of the official Claude CLI, extending it with background processing and voice control.

Built With Love

Join the growing community of developers enhancing their Claude CLI experience

--
GitHub Stars
100%
Open Source
MIT
Licensed

Built on top of Claude CLI with love. No ads, no tracking, no monetization.

Just a better way to use Claude.

Get Started in 60 Seconds

1

Prerequisites

Make sure you have Node.js 18+ and Claude CLI installed

node --version # Should be 18+
2

Install Calmhive

One command to enhance your Claude CLI

npm install -g @calmhive/calmhive-cli
3

Start Using

Run your first command and see the difference

calmhive chat "hello world"