Claude Workbench

English | Deutsch

---

English

A Rust-based TUI (Terminal User Interface) multiplexer designed for AI-assisted development workflows. Provides an integrated development environment with file browser, syntax-highlighted preview pane, and multiple embedded PTY terminals.

Features

Pane	Key	Description
File Browser	F1	Navigate directories, git status integration, file operations (F9), toggle visibility
Preview	F2	Syntax highlighting (500+ languages), Markdown rendering, built-in editor
Claude Code	F4	Embedded Claude CLI terminal with startup prefixes
LazyGit	F5	Integrated Git TUI (restarts in current directory)
Terminal	F6	General-purpose shell (syncs to current directory)

Highlights:

• Full PTY emulation with 256-color support and 1000-line scrollback
• Search & Replace (MC Edit style) with regex support
• Terminal selection mode (Ctrl+S or Alt+Click) with intelligent filtering
• Drag & Drop files into terminals
• Git remote change detection with pull prompts
• Claude fullscreen mode when all panes hidden (F1/F2/F5/F6 toggles)
• Mouse and keyboard navigation throughout

Quick Start

# Download for your platform from Releases
# https://github.com/eqms/claude-workbench/releases

# Or build from source
git clone https://github.com/eqms/claude-workbench.git
cd claude-workbench
cargo build --release
./target/release/claude-workbench

See INSTALL.md for detailed platform-specific installation instructions.

Essential Shortcuts

Key	Action
F1-F6	Switch between panes
F9	File menu (new, rename, delete, etc.)
F12	Help (full shortcut reference)
Ctrl+P	Fuzzy file finder
Ctrl+Q	Quit
E	Edit file (in Preview)
Ctrl+S	Selection mode (in Terminal/Preview)
Ctrl+C	Copy selection to System Clipboard

See USAGE.md for complete keyboard shortcuts and detailed usage guide.

Configuration

Configuration files are loaded in priority order:

1. ./config.yaml (project-local, highest priority)
2. ~/.config/claude-workbench/config.yaml (user config)

terminal:
  shell_path: "/opt/homebrew/bin/fish"
  shell_args: ["-l"]

ui:
  theme: "default"

layout:
  claude_height_percent: 40
  file_browser_width_percent: 20
  preview_width_percent: 50
  right_panel_width_percent: 30

file_browser:
  show_hidden: false
  show_file_info: true
  date_format: "%d.%m.%Y %H:%M:%S"
  auto_refresh_ms: 2000

# Optional: Claude startup prefixes
claude:
  startup_prefixes:
    - name: "Code Review"
      prefix: "/review"
      description: "Review code changes"

Tech Stack

• Ratatui - TUI framework
• Crossterm - Terminal handling
• portable-pty - PTY management
• vt100 - Terminal emulation
• syntect - Syntax highlighting
• tui-textarea - Text editor widget
• tui-markdown - Markdown rendering

License

MIT License - Copyright (c) 2025 Martin Schmid

See LICENSE for details.

---

Deutsch

Ein Rust-basierter TUI (Terminal User Interface) Multiplexer für KI-unterstützte Entwicklungsworkflows. Bietet eine integrierte Entwicklungsumgebung mit Dateibrowser, Syntax-hervorgehobener Vorschau und mehreren eingebetteten PTY-Terminals.

Funktionen

Bereich	Taste	Beschreibung
Dateibrowser	F1	Verzeichnisnavigation, Git-Status-Integration, Dateioperationen (F9), ein-/ausblenden
Vorschau	F2	Syntax-Hervorhebung (500+ Sprachen), Markdown-Rendering, Editor
Claude Code	F4	Eingebettetes Claude CLI Terminal mit Startup-Präfixen
LazyGit	F5	Integrierte Git-TUI (startet im aktuellen Verzeichnis neu)
Terminal	F6	Allgemeines Shell-Terminal (wechselt ins aktuelle Verzeichnis)

Highlights:

• Volle PTY-Emulation mit 256-Farben und 1000 Zeilen Scrollback
• Suchen & Ersetzen (MC Edit Stil) mit Regex-Unterstützung
• Terminal-Auswahlmodus (Ctrl+S oder Alt+Klick) mit intelligentem Filtering
• Drag & Drop von Dateien in Terminals
• Git Remote-Änderungserkennung mit Pull-Aufforderung
• Claude Vollbildmodus wenn alle Bereiche ausgeblendet (F1/F2/F5/F6 Umschaltung)
• Maus- und Tastaturnavigation durchgehend

Schnellstart

# Binary für Ihre Plattform von Releases herunterladen
# https://github.com/eqms/claude-workbench/releases

# Oder aus Quellcode bauen
git clone https://github.com/eqms/claude-workbench.git
cd claude-workbench
cargo build --release
./target/release/claude-workbench

Siehe INSTALL.md für detaillierte plattformspezifische Installationsanleitungen.

Wichtige Tastenkürzel

Taste	Aktion
F1-F6	Zwischen Bereichen wechseln
F9	Datei-Menü (neu, umbenennen, löschen, etc.)
F12	Hilfe (vollständige Shortcut-Referenz)
Ctrl+P	Fuzzy-Dateisuche
Ctrl+Q	Beenden
E	Datei bearbeiten (in Vorschau)
Ctrl+S	Auswahlmodus (in Terminal/Vorschau)
Ctrl+C	Auswahl in System-Clipboard kopieren

Siehe USAGE.md für alle Tastenkürzel und detaillierte Bedienungsanleitung.

Konfiguration

Konfigurationsdateien werden in Prioritätsreihenfolge geladen:

1. ./config.yaml (projektlokal, höchste Priorität)
2. ~/.config/claude-workbench/config.yaml (Benutzerkonfiguration)

terminal:
  shell_path: "/opt/homebrew/bin/fish"
  shell_args: ["-l"]

ui:
  theme: "default"

layout:
  claude_height_percent: 40
  file_browser_width_percent: 20
  preview_width_percent: 50
  right_panel_width_percent: 30

file_browser:
  show_hidden: false
  show_file_info: true
  date_format: "%d.%m.%Y %H:%M:%S"
  auto_refresh_ms: 2000

# Optional: Claude Startup-Präfixe
claude:
  startup_prefixes:
    - name: "Code Review"
      prefix: "/review"
      description: "Code-Änderungen überprüfen"

Technologie-Stack

• Ratatui - TUI-Framework
• Crossterm - Terminal-Handhabung
• portable-pty - PTY-Verwaltung
• vt100 - Terminal-Emulation
• syntect - Syntax-Hervorhebung
• tui-textarea - Texteditor-Widget
• tui-markdown - Markdown-Rendering

Lizenz

MIT-Lizenz - Copyright (c) 2025 Martin Schmid

Siehe LICENSE für Details.