terminal-plan

HTML agent plans inside your terminal

$curl -fsSL https://terminal-plan.sh/install | bash
~/project
⏵⏵ auto mode on (shift+tab to cycle)
terminal-plan
List all plans
terminal-plan set <file>
Create a plan
terminal-plan open [--split <direction>] [--size <pane size %>]
Open the plan in the terminal

Display rich HTML plans next to your agent

terminal-plan is a CLI that lets your agent open plans written in HTML inside a split screen within your terminal.

Leave comments directly on plans

Highlight text to add comments

Fix the rate limiter

Fix the rate limiter

429s vanish after every deploy · in-memory buckets reset

Bug

Each api pod keeps its token buckets in process memory. A deploy replaces the pods, the buckets reset, and for about a minute every client can burst far past its quota. The 429 rate flatlines while the fleet warms up.

429 responses / min
deploy

Where it breaks

clientreqapi podcheckbuckets · RAM
reset on deploy

Fix

Move the buckets to redis so quota state survives rollouts: one lua script does the check-and-decrement atomically, responses carry X-RateLimit-Remaining, and a regression test rolls a pod mid-run to assert the quota holds.

Open question

Fail open or fail closed when redis is unreachable? Open risks abuse for the outage window; closed turns a redis blip into a full API outage.

Works with every agent

Claude Code
Codex CLI
Cursor CLI
opencode

How does it work

terminal-plan builds on top of terminal-browser to render HTML inside the terminal. You should look into this project if you are interested in the technical details!