Home

Claude Code + Tmux: Skeptic's Dream Workflow

Vibrant tmux setup with Claude Code, Neovim, and shell panes for ultimate AI dev workflow

Claude Code + Tmux: Skeptic's Dream Workflow Unleashed

Hey devs, tired of bloated AI tools that promise the world but deliver config hell? Imagine ditching Aider's endless tweaks for a dead-simple terminal setup that just works—Claude Code humming in tmux tabs alongside Neovim and your shell. A former AI skeptic did exactly that, and now it's my go-to for steady, burn-free productivity. Stick to Sonnet, skip Opus limits, and watch minimalism unleash max output.

The Hook: Why This Matters for Real Coders

You've got projects piling up, deadlines looming, and AI hype fatigue. Tools like Aider sound great until you're wrestling configs for hours. Enter Claude Code + tmux: a lightweight terminal powerhouse where AI builds your code while you review it in Neovim. No GUIs, no distractions—just pure flow.

Why care? It scales from quick fixes to full apps without burning premium tokens. One skeptic swapped complexity for tabs: Claude on left, shell on right, Neovim for diffs. Result? Faster iterations, less context-switching, and code you actually trust. In a world of over-engineered IDEs, this is the minimalist rebellion devs crave.

TL;DR Key Takeaway

Three tmux panes (Claude, shell, Neovim) + Sonnet model = skeptic-proof AI coding that respects your time and wallet.

Your New Best Friend: The Tmux Setup

Fire up tmux and split into tabs or panes. Typical layout from the pros:

  • Left pane: Claude Code session (chat, plan, execute).
  • Right pane: Shell for git, builds, tests.
  • Bottom or tab: Neovim for code review and edits.

Here's a quick config to get you started. Add this to your ~/.tmux.conf for auto-splits:

# tmux.conf snippet for Claude workflow
set -g mouse on
set -g history-limit 50000  # Big buffer for Claude logs
 
# Split panes for Claude magic
bind-key C-c new-window -c '#{pane_current_path}' 'claude'  # Quick Claude window
bind-key C-n split-window -h -c '#{pane_current_path}' 'nvim'  # Neovim pane
bind-key C-s split-window -v -c '#{pane_current_path}' 'bash'  # Shell pane
 
# Reload with: tmux source ~/.tmux.conf

Reload tmux (tmux source ~/.tmux.conf), hit Ctrl+b C-c for Claude, C-n for Neovim, C-s for shell. Boom—your cockpit is ready.

Pro tip: Use Sonnet 3.5 for consistent speed without Opus rate limits. It's steady for 80% of tasks.

Code Example 1: Kickoff a Project with Claude

In your Claude pane, prompt like a boss:

Plan and build a todo CLI app in Rust. Use Clap for args, Serde for JSON storage. Include add/list/delete. Commit to git after each major step.

Claude thinks step-by-step: plans, writes Cargo.toml, scaffolds code. Watch it cargo build in the shell pane. Meanwhile, split to Neovim (nvim src/main.rs) to tweak the AI's output live. Approve hooks as they pop (permissions for file writes, executes).

Why this matters: AI handles boilerplate; you focus on logic. No copy-paste marathons.

Practical Use Case: Multi-Agent Madness

Scale up! Tmux shines for agentic workflows. Spin separate sessions for a "company": President delegates, workers code.

Setup script (setup.sh):

#!/bin/bash
# Create tmux sessions for AI agents
tmux new-session -d -s president 'bash'
tmux new-session -d -s boss1 'bash'
tmux new-session -d -s worker1 'bash'
tmux new-session -d -s worker2 'bash'
tmux new-session -d -s worker3 'bash'
 
# Attach to president
echo "Sessions created! Attach with: tmux attach -t president"

Run ./setup.sh, attach to president, init Claude: "You are President. Build a todo website—delegate to boss1, who assigns to workers."

Watch the magic: Agents message via agent-send.sh, build frontend/backend in parallel panes. Approve deploys. It's like having a dev team in your terminal.

Use case win: Prototyping full-stack apps autonomously. Perfect for spikes or MVPs.

Code Example 2: Git Diff Review Workflow

Claude generates? Pipe to git diff in shell pane:

# In shell pane
git diff HEAD~1  # Review last commit
nvim +/diff $(git diff --name-only HEAD~1)  # Jump to changed files

Tell Claude: "Review this diff and fix bugs." It iterates without leaving tmux. Big scrollback captures everything for later journaling.

Why it rocks: Seamless feedback loop. AI learns from your reviews; you stay in flow.

Code Example 3: 24/7 Autonomous Builder

For long hauls (ray tracing, tests), let it run backgrounded.

# In tmux tab: Persistent Claude session
tmux new-session -d -s builder 'claude --model sonnet-3.5 "Build ray tracer in Zig. Run tests every 15min, update me."'
 
# Check progress
tmux attach -t builder

It self-checks todos, schedules phases. You peek via desktop apps or mirrors if fancy.

Real talk: Handles complex scopes better than one-shot prompts.

Why Skeptics Love It (And You Will Too)

Minimal config = max output. No VS Code bloat, just terminal purity. Boosts productivity 2x by parallelizing AI + human smarts. Saves tokens, respects your stack (Ghostty, Helix, whatever). Even for content: Claude summarizes sessions into tutorials.

Try It Yourself: Next Steps

  1. Install Claude Code CLI ( Anthropic docs).
  2. Tmux + above config.
  3. Prompt a toy app: "CLI weather fetcher in Go."
  4. Review, iterate, ship.

Skeptic no more—your terminal's now an AI superpower. What's your first build? Drop it in comments!