dumb

A lightweight, no-nonsense tmux layout manager for terminal-based development.

Instead of building yet another bloated Electron-based coding interface, dumb is a simple Go CLI tool that configures your tmux session into an efficient, multi-pane development cockpit. It renames your tmux window to the current directory name and splits the window into a highly practical three-pane layout.

How It Works

When run inside a tmux session, dumb structures your window like this:

+---------------------------------------+---------------------------------------+
|                                       |                                       |
|                                       |                                       |
|             AI Tool Pane              |            Diff Tool Pane             |
|              (AI_TOOL)                |             (DIFF_TOOL)               |
|                                       |                                       |
|                                       |                                       |
+---------------------------------------+---------------------------------------+
|                                                                               |
|                            Active Shell (20% height)                          |
|                                                                               |
+---------------------------------------+---------------------------------------+

1. AI Pane (Top-Left): Runs your terminal-based AI assistant (defaults to opencode).
2. Diff Pane (Top-Right, 50% width): Runs your diffing or file-watching tool (defaults to differ).
3. Shell Pane (Bottom, 20% height): A standard shell prompt for building, testing, and executing commands.

Focus is automatically placed in the AI Pane so you can start working right away.

---

Installation

Ensure you have tmux installed on your system before installing dumb.

Homebrew (macOS / Linux)

You can install dumb from the official tap:

brew install dpuwork/tap/dumb

mise

If you use mise, install the plugin and use it:

mise plugins install dumb https://github.com/dpuwork/dumb.git
mise use -g dumb@latest

Manual Installation

1. Clone the repository:

   git clone https://github.com/dpuwork/dumb.git
   cd dumb

2. Build and install the binary:

   go build -o dumb main.go
   sudo cp dumb /usr/local/bin/dumb

---

Usage

Start or attach to a tmux session:

tmux new -s dev

Inside your tmux session, navigate to your project directory and run:

dumb [ai-tool] [diff-tool]

By default, running dumb without arguments is equivalent to running dumb opencode differ.

Suggested Tools

You can pass any interactive command or terminal tool you like. Here are some popular suggestions:

AI Tools (Left Pane)

• opencode (Default)
• Claude Code (claude): Anthropic's interactive CLI agent.
• Codex (codex): Fast and lightweight terminal AI assistant.
• Pi (pi): A minimal terminal coding harness.

Diff & Status Tools (Right Pane)

• differ (Default): A lightweight terminal side-by-side diff tool.
• hunk: An interactive terminal diff viewer.
• lumen: A minimal terminal UI for git.
• monocle: A file-monitoring and task-running dashboard.
• tuicr: A sleek terminal-based code review interface.
• git diff / git status: Standard git utilities.

Examples:

• Default configuration (opencode and differ):

  dumb

• Claude Code with Hunk:

  dumb claude hunk

• Codex with standard git diff:

  dumb codex "git diff"

Command Options

• --version / -v: Show the current version of dumb.

---

Visuals