https://github.com/bradleyoesch/planderson
A terminal user interface (TUI) for reviewing and iterating on Claude's plans before implementation.
https://github.com/bradleyoesch/planderson
claude claude-code plan-mode plugin terminal tmux tui
Last synced: 2 months ago
JSON representation
A terminal user interface (TUI) for reviewing and iterating on Claude's plans before implementation.
- Host: GitHub
- URL: https://github.com/bradleyoesch/planderson
- Owner: bradleyoesch
- License: mit
- Created: 2026-03-10T04:17:12.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-04-01T09:37:54.000Z (3 months ago)
- Last Synced: 2026-04-02T07:57:18.933Z (3 months ago)
- Topics: claude, claude-code, plan-mode, plugin, terminal, tmux, tui
- Language: TypeScript
- Homepage:
- Size: 573 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# Planderson
[](https://github.com/bradleyoesch/planderson/actions/workflows/ci.yml)
[](https://github.com/bradleyoesch/planderson/releases/latest)
[](LICENSE)
A terminal user interface (TUI) for reviewing Claude's plans before implementation. When Claude exits plan mode, Planderson intercepts the request and displays the plan fullscreen in terminal — accept, deny, or provide feedback.
The default plan mode in Claude involves scrolling up/down and copy/pasting parts of the plan to provide feedback in a small text input. This plugin enables a more interactive and user-friendly way to provide inline feedback and approve/deny plans to iterate until satisfied.
The goal is to provide a lightweight TUI to bridge the gap between "pure" terminal interactions and complex external user interfaces to support seamless plan iteration with Claude.
## Prerequisites
- **macOS or Linux** (has not been tested on Windows)
- **tmux 3.0+** (optional, for [tmux integration](./integrations/tmux/README.md))
## Installation
1. **Install the binary:**
```bash
curl -fsSL https://raw.githubusercontent.com/bradleyoesch/planderson/main/install.sh | bash
```
2. **Install the plugin in Claude Code:**
```
/plugin marketplace add bradleyoesch/planderson
/plugin install planderson@planderson
```
3. **Reload plugins or restart claude for plugin to take effect:**
```
/reload-plugins
```
4. **(Optional) Run setup to configure planderson:**
```bash
planderson setup
```
## Usage
Without any further setup or integrations, you may manually trigger the plan TUI. After Claude presents the plan to review, in a separate terminal, launch the TUI:
```bash
planderson tui
```
For more control and seamless integration, set up tmux integration: [integrations/tmux/README.md](./integrations/tmux/README.md).
### Controls
Basic controls while in the plan TUI:
| Key | Action |
| ----------------------- | ------------------------------ |
| `Up`/`Down` | Navigate lines |
| `Shift+Up`/`Shift+Down` | Multi-select lines |
| `c` | Add comment |
| `q` | Add question |
| `Delete` | Mark line for deletion |
| `Enter` | Submit feedback or approve |
| `Esc` | Exit TUI |
| `?` | Show full keybinding reference |
1. Move up and down the plan to review.
2. Add feedback
- Comment - feedback for Claude to address directly
- Question - question to discuss with Claude before returning to plan iteration
- Deletion - delete from the plan completely
3. Hit `Enter` to submit that feedback and wait for Claude to modify plan to iterate again
If no feedback to submit, `Enter` will approve the plan
For details and more keybindings, run `planderson help` or hit `?` while in the TUI.
## Upgrading
To upgrade to latest version, run:
```bash
planderson upgrade
```
### Auto-upgrade
You can opt into automatic upgrades at TUI startup.
Set `autoUpgrade` setting to `always`:
```bash
planderson settings --autoUpgrade always
```
For details, run `planderson settings --autoUpgrade`
## Development
See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup, building, and testing.
## License
MIT