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.
I love efficient coding, but I grew tired of bloated IDEs. Visual Studio Code felt too heavy, and other tools often came with baggage I simply didn't need for my daily workflow. What I truly wanted was an environment as fast as my thought process — built on the stability of Rust and bringing the power of Claude directly into the shell.
Over the 2025/2026 New Year, I turned that vision into reality: Claude Workbench.
It's not a traditional IDE; it's a high-performance TUI (Terminal User Interface). Built on the Fish shell and Rust, it seamlessly integrates tools like lazy-git and provides everything you need for a frictionless workflow — from an intelligent file browser and live Markdown rendering to direct Claude integration.
No overhead. Maximum performance. Built by a developer, for developers.
- The Problem: Modern IDEs have become bloated, filled with features that distract rather than help.
- The Search: After testing alternatives like Zed or Google IDX, they lacked the "Shell-First" philosophy I crave.
- The Goal: Create a portable, lightning-fast solution that feels like a natural extension of the terminal.
- Rust: Chosen for uncompromising performance, safety, and stability.
- Fish Shell (4.x): The core for a modern, user-friendly command-line experience.
- Claude Integration: Deep integration of Claude (e.g., via Claude Code) for AI-assisted development without leaving the terminal.
- Automation: Hosted on GitHub with automated release workflows (compiling) and integrated self-update logic.
| 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
- Character-level mouse selection - click and drag to select text, auto-copies to clipboard
- Keyboard selection mode (Ctrl+S) 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)
- Interactive pane resizing - drag pane borders with mouse
- Horizontal scrolling - in Preview and Edit mode for long lines
- F9 Copy Last N Lines - copy last N terminal lines to clipboard (configurable, default 50)
- Self-update - automatic update check from GitHub Releases
- App Dropdown - auto-detect installed browsers/editors in Settings (macOS + Linux)
- Ctrl+X Markdown Export - export as Markdown copy or PDF (native Typst engine, no external tools needed)
- Ctrl+V Paste - clipboard paste in all input dialogs
- Mouse and keyboard navigation throughout
# Install via Homebrew (macOS / Linux)
brew install eqms/claude-workbench/claude-workbench
# Or use the installer script
curl -fsSL https://raw.githubusercontent.com/eqms/claude-workbench/main/scripts/install.sh | bash
# Or build from source
git clone https://github.com/eqms/claude-workbench.git
cd claude-workbench && cargo build --release
./target/release/claude-workbenchSee INSTALL.md for detailed platform-specific installation instructions.
| Key | Action |
|---|---|
| F1-F6 | Switch between panes |
| F9 | File menu in File Browser / Copy last N lines to clipboard in Terminal panes |
| F12 | Help (full shortcut reference) |
| Ctrl+P | Fuzzy file finder |
| Ctrl+Q | Quit |
| E | Edit file (in Preview) |
| Ctrl+X | Export Markdown/PDF (format chooser) |
| Ctrl+E | Open in External Editor (context-aware) |
| 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.
- Cross-File Link Resolution — HTML export now auto-converts referenced
.mdfiles and rewrites links. When README.md links to USAGE.md or INSTALL.md, all files are converted to HTML with working links.
- HTML Anchor Links Fixed — Internal anchor links (
[text](#heading)) now work in browser preview and HTML export. Headings get auto-generatedidattributes via sharedslugify()function.
- Unified Export System — All export paths (PDF, Markdown preview, Syntax preview) now share the same configurable values. 14 hardcoded values replaced by config fields.
- 7 New Document Settings — Table Font Size, Header Font Size, Line Height, Code Block BG, Heading Separator, Table Cell Padding, Blockquote Border now editable in F8.
- Consistent Preview Filenames — Browser previews use
{project}-{file}-{date}.htmlnaming instead of random temp names. - Bug Fix —
pre codeCSS incorrectly used table font size instead of code font size.
- Configurable Font Sizes — Body Font Size and Code Font Size are now editable in Document Settings (F8 → Document). Code blocks use their own size independently from tables.
- PDF Code Font from Config — The
Code Fontsetting (F8 → Document) is now applied to code blocks and tables in PDF export. Previously hardcoded to Consolas/Courier New.
- Async PDF Export — PDF generation runs in background with yellow progress indicator. UI stays responsive.
- PDF Internal Links — Markdown anchor links (
[text](#heading)) now work as clickable navigation in PDF. - PDF Font Fix — Header/footer now use configured Carlito/Calibri font instead of Typst default.
- Linux Clipboard — Wayland support via
wayland-data-control, OSC 52 dual-terminator (BEL + ST) for broader terminal compatibility. - Linux Rendering Fix — Fixed severe pane overlap/ghosting when scrolling on Linux terminals. Added
Clearbefore pane rendering, zero-area guards, and proper None-cell clearing.
- PDF Export Fix — Fixed "file not found" error when exporting Markdown with local images. Remote image URLs are now rendered as links in PDF.
- Export Flash Message — Footer shows "PDF exported" / "Markdown exported" after successful export.
- Templates Tab Removed — Removed non-functional Templates tab from Settings (no persistence, no effect).
- Native Typst PDF Engine — PDF export now uses pure Rust Typst rendering. No external tools (Chrome, wkhtmltopdf) required. Bundled Carlito font (Calibri-compatible) for consistent cross-platform rendering.
- Page Numbers — Every PDF page shows "Seite X von Y" with three-column footer (Company | Date | Page) and header with document title.
- Central DocumentConfig — New
document:section inconfig.yamlfor unified branding: company name, fonts (Calibri default), colors (#D5E8F0 table headers), font sizes (Word-standard hierarchy), PDF page settings (A4, 2.5cm margins). - CSS Template Module — Shared styling across all HTML preview and PDF templates via configurable
TemplateContext.
- F9 Menu Export — File Menu (F9 in File Browser) now has an "Export Markdown/PDF" entry (
xkey) as a direct alternative to Ctrl+X. - Ctrl+E Context-Aware — Opens the file currently shown in the Preview pane when Preview is active.
Remote Control Fix — The remote-control subcommand was removed (not a valid Claude CLI command). When Remote Control is enabled, the workbench now automatically sends a Space key 2 seconds after Claude starts, triggering the QR code display for remote access.
Remote Control Toggle — The Permission Mode dialog now includes a Remote Control checkbox below the 5 permission modes. When enabled, the QR code for remote access is automatically displayed after Claude starts. Toggle with Space, the setting is persisted in config.yaml.
claude:
remote_control: true # Enable remote control mode (default: false)F9 „Copy Last N Lines" — Press F9 in any terminal pane (Claude, LazyGit, Terminal) to copy the last N lines of output to the system clipboard. Configurable via pty.copy_lines_count (default: 50). Footer shows a green „✓ N lines" flash for 2 seconds. F9 in the File Browser still opens the file menu as before.
pty:
copy_lines_count: 50 # Increase for longer outputs, e.g. 100 or 200Configuration files are loaded in priority order:
./config.yaml(project-local, highest priority)~/.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 and remote control
claude:
remote_control: false # Auto-show QR code for remote access after start
startup_prefixes:
- name: "Code Review"
prefix: "/review"
description: "Review code changes"
# Document export settings (PDF uses native Typst, no external tools needed)
document:
company:
name: "My Company" # Shown in PDF footer and author
footer_text: "Generated by {company_name}"
fonts:
body: "Calibri, -apple-system, sans-serif"
colors:
table_header_bg: "#D5E8F0"
pdf:
page_size: "A4"
margin: "2.5cm"- Ratatui - TUI framework
- Crossterm - Terminal handling
- portable-pty - PTY management
- vt100 - Terminal emulation
- syntect - Syntax highlighting
- Typst - Native PDF generation (pure Rust, no external binaries)
- tui-textarea - Text editor widget
- tui-markdown - Markdown rendering
MIT License - Copyright (c) 2025 Martin Schmid
See LICENSE for details.
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.
Ich liebe effizientes Programmieren, aber ich hatte genug von aufgeblähten IDEs. Visual Studio Code fühlte sich zu schwer an, und andere Tools brachten oft Ballast mit, den ich für meinen täglichen Workflow schlicht nicht brauchte. Was ich wirklich wollte, war eine Umgebung, die so schnell ist wie mein Denkprozess — aufgebaut auf der Stabilität von Rust und mit der Kraft von Claude direkt in der Shell.
Über Silvester 2025/2026 habe ich diese Vision Wirklichkeit werden lassen: Claude Workbench.
Es ist keine traditionelle IDE; es ist ein hochperformantes TUI (Terminal User Interface). Aufgebaut auf der Fish Shell und Rust, integriert es nahtlos Werkzeuge wie lazy-git und bietet alles, was man für einen reibungslosen Workflow braucht — von einem intelligenten Dateibrowser und Live-Markdown-Rendering bis hin zur direkten Claude-Integration.
Kein Overhead. Maximale Performance. Von einem Entwickler, für Entwickler.
- Das Problem: Moderne IDEs sind aufgebläht, vollgestopft mit Features die ablenken statt zu helfen.
- Die Suche: Nach dem Testen von Alternativen wie Zed oder Google IDX fehlte ihnen die "Shell-First"-Philosophie, die ich brauche.
- Das Ziel: Eine portable, blitzschnelle Lösung schaffen, die sich wie eine natürliche Erweiterung des Terminals anfühlt.
- Rust: Gewählt für kompromisslose Performance, Sicherheit und Stabilität.
- Fish Shell (4.x): Der Kern für ein modernes, benutzerfreundliches Kommandozeilen-Erlebnis.
- Claude-Integration: Tiefe Integration von Claude (z.B. via Claude Code) für KI-unterstützte Entwicklung ohne das Terminal zu verlassen.
- Automatisierung: Gehostet auf GitHub mit automatisierten Release-Workflows (Kompilierung) und integrierter Selbst-Update-Logik.
| 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
- Zeichenweise Mausauswahl - Klicken und Ziehen zum Markieren, kopiert automatisch ins Clipboard
- Tastatur-Auswahlmodus (Ctrl+S) 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)
- Interaktives Pane-Resizing - Bereichsgrenzen per Maus ziehen
- Horizontales Scrollen - in Vorschau und Editor für lange Zeilen
- F9 Letzte N Zeilen kopieren - letzten N Terminal-Zeilen ins Clipboard kopieren (konfigurierbar, Standard 50)
- Selbst-Update - automatische Update-Prüfung von GitHub Releases
- App-Dropdown - automatische Erkennung installierter Browser/Editoren in Settings (macOS + Linux)
- Ctrl+X Markdown-Export - Export als Markdown-Kopie oder PDF (native Typst-Engine, keine externen Tools nötig)
- Ctrl+V Einfügen - Clipboard-Paste in allen Eingabedialogen
- Maus- und Tastaturnavigation durchgehend
# Installation via Homebrew (macOS / Linux)
brew install eqms/claude-workbench/claude-workbench
# Oder Installer-Skript verwenden
curl -fsSL https://raw.githubusercontent.com/eqms/claude-workbench/main/scripts/install.sh | bash
# Oder aus Quellcode bauen
git clone https://github.com/eqms/claude-workbench.git
cd claude-workbench && cargo build --release
./target/release/claude-workbenchSiehe INSTALL.md für detaillierte plattformspezifische Installationsanleitungen.
| Taste | Aktion |
|---|---|
| F1-F6 | Zwischen Bereichen wechseln |
| F9 | Datei-Menü im Dateibrowser / Letzte N Zeilen kopieren in Terminal-Bereichen |
| F12 | Hilfe (vollständige Shortcut-Referenz) |
| Ctrl+P | Fuzzy-Dateisuche |
| Ctrl+Q | Beenden |
| E | Datei bearbeiten (in Vorschau) |
| Ctrl+X | Markdown/PDF exportieren (Format-Auswahl) |
| Ctrl+E | In externem Editor öffnen (kontextabhängig) |
| Ctrl+S | Auswahlmodus (in Terminal/Vorschau) |
| Ctrl+C | Auswahl in System-Clipboard kopieren |
Siehe USAGE.md für alle Tastenkürzel und detaillierte Bedienungsanleitung.
- Cross-File Link-Aufloesung — Der HTML-Export konvertiert jetzt automatisch referenzierte
.md-Dateien mit und schreibt die Links um. Wenn README.md auf USAGE.md oder INSTALL.md verlinkt, werden alle Dateien zu HTML konvertiert und die Links funktionieren.
- HTML Anker-Links repariert — Interne Anker-Links (
[text](#heading)) funktionieren jetzt in der Browser-Vorschau und im HTML-Export. Ueberschriften erhalten automatischid-Attribute ueber eine gemeinsameslugify()-Funktion.
- Einheitliches Export-System — Alle Export-Pfade (PDF, Markdown-Vorschau, Syntax-Vorschau) nutzen jetzt die gleichen konfigurierbaren Werte. 14 hardcoded Werte durch Config-Felder ersetzt.
- 7 neue Document Settings — Tabellen-Schriftgroesse, Header-Schriftgroesse, Zeilenhoehe, Code-Block-Hintergrund, Ueberschrift-Trennlinie, Tabellen-Zellenabstand, Blockquote-Rahmen jetzt in F8 editierbar.
- Konsistente Vorschau-Dateinamen — Browser-Vorschauen verwenden
{Projekt}-{Datei}-{Datum}.htmlstatt zufaelliger Temp-Namen. - Bug-Fix —
pre codeCSS nutzte faelschlicherweise Tabellen- statt Code-Schriftgroesse.
- Konfigurierbare Schriftgroessen — Body Font Size und Code Font Size sind jetzt in den Document Settings (F8 → Document) editierbar. Code-Bloecke verwenden eine eigene Groesse unabhaengig von Tabellen.
- PDF Code-Font aus Config — Die
Code Font-Einstellung (F8 → Document) wird jetzt auf Code-Blöcke und Tabellen im PDF-Export angewendet. Zuvor fest auf Consolas/Courier New verdrahtet.
- Async PDF-Export — PDF-Generierung im Hintergrund mit gelbem Fortschrittsindikator. UI bleibt reaktiv.
- PDF Interne Links — Markdown-Anker-Links (
[text](#heading)) funktionieren als klickbare Navigation im PDF. - PDF Schriftart-Fix — Header/Footer verwenden jetzt konfigurierte Carlito/Calibri-Schrift statt Typst-Default.
- Linux Clipboard — Wayland-Support via
wayland-data-control, OSC 52 Dual-Terminator (BEL + ST) fuer breitere Terminal-Kompatibilitaet. - Linux Rendering-Fix — Schweres Pane-Overlap/Ghosting beim Scrollen unter Linux behoben. Clear vor Pane-Rendering, Zero-Area-Guards, und korrektes None-Cell-Clearing.
- PDF-Export Fix — Fehler „file not found" bei Markdown-Dateien mit lokalen Bildern behoben. Remote-Bild-URLs werden als Links im PDF dargestellt.
- Export Flash-Nachricht — Footer zeigt nach erfolgreichem Export „PDF exported" / „Markdown exported".
- Templates-Tab entfernt — Nicht-funktionaler Templates-Tab aus Settings entfernt (keine Persistierung, keine Wirkung).
- F9-Menü Export — Das Datei-Menü (F9 im Dateibrowser) hat jetzt einen „Export Markdown/PDF"-Eintrag (
x-Taste) als direkte Alternative zu Ctrl+X. - Ctrl+E kontextabhängig — Öffnet die aktuell in der Vorschau angezeigte Datei, wenn der Vorschau-Bereich aktiv ist (bisher nur die im Dateibrowser markierte Datei).
- Behoben: Settings Auto-Save bei Esc — Der Settings-Dialog speichert Änderungen jetzt korrekt beim Schließen mit Esc.
- Behoben: Tab-Vervollständigung in allen Pfad-Dialogen — Tab vervollständigt Pfade in allen Dialogen (Ctrl+O, Export-Verzeichnis, Browser/Editor-Pfade).
- Behoben: Browser-Auswahl für Exporte — Der konfigurierte Browser wird jetzt korrekt für die Markdown-zu-HTML-Export-Vorschau verwendet.
- App-Dropdown für Browser/Editor — Settings → Paths erkennt jetzt automatisch installierte Browser und Editoren. Auswahl per Dropdown statt manuelle Pfadeingabe. macOS (App-Bundle-Erkennung) und Linux (which-basiert). "Custom path..." Fallback für manuelle Eingabe.
- Ctrl+X: Markdown-Export — Aktuelle Markdown-Datei als Markdown-Kopie oder PDF exportieren. Format-Auswahl-Dialog, konfigurierbares Export-Verzeichnis (Settings → Paths → Export Directory, Standard: ~/Downloads). PDF via Chrome headless oder wkhtmltopdf.
- Ctrl+V Einfügen in Dialogen — Clipboard-Paste funktioniert jetzt in allen Eingabedialogen (Ctrl+O, Dateioperationen, Settings-Felder).
- Command-Splitting Bugfix — Browser/Editor-Befehle wie
open -a "Brave Browser"funktionieren jetzt korrekt.
Remote Control Fix — Der remote-control Subcommand wurde entfernt (kein gültiger Claude CLI-Befehl). Bei aktiviertem Remote Control wird nun automatisch 2 Sekunden nach Claude-Start die Leertaste gesendet, um den QR-Code für den Remote-Zugriff anzuzeigen.
Remote Control Toggle — Der Berechtigungsmodus-Dialog enthält nun eine Remote Control Checkbox unterhalb der 5 Modi. Wenn aktiviert, wird der QR-Code für den Remote-Zugriff automatisch nach dem Claude-Start angezeigt. Umschalten mit Leertaste, die Einstellung wird in config.yaml gespeichert.
claude:
remote_control: true # Remote Control Modus aktivieren (Standard: false)F9 „Letzte N Zeilen kopieren" — F9 in einem Terminal-Bereich (Claude, LazyGit, Terminal) kopiert die letzten N Ausgabe-Zeilen in die Zwischenablage. Konfigurierbar über pty.copy_lines_count (Standard: 50). Der Footer zeigt 2 Sekunden lang einen grünen „✓ N Zeilen"-Flash. F9 im Dateibrowser öffnet weiterhin das Datei-Menü.
pty:
copy_lines_count: 50 # Für längere Ausgaben erhöhen, z.B. 100 oder 200Konfigurationsdateien werden in Prioritätsreihenfolge geladen:
./config.yaml(projektlokal, höchste Priorität)~/.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 und Remote Control
claude:
remote_control: false # QR-Code für Remote-Zugriff automatisch anzeigen
startup_prefixes:
- name: "Code Review"
prefix: "/review"
description: "Code-Änderungen überprüfen"- Ratatui - TUI-Framework
- Crossterm - Terminal-Handhabung
- portable-pty - PTY-Verwaltung
- vt100 - Terminal-Emulation
- syntect - Syntax-Hervorhebung
- tui-textarea - Texteditor-Widget
- tui-markdown - Markdown-Rendering
MIT-Lizenz - Copyright (c) 2025 Martin Schmid
Siehe LICENSE für Details.