tazuna
| Crates.io | tazuna |
| lib.rs | tazuna |
| version | 0.1.0 |
| created_at | 2026-01-18 12:50:26.691586+00 |
| updated_at | 2026-01-18 12:50:26.691586+00 |
| description | TUI tool for managing multiple Claude Code sessions in parallel |
| homepage | |
| repository | https://github.com/oshiteku/tazuna |
| max_upload_size | |
| id | 2052310 |
| size | 770,856 |
(oshiteku)
documentation
README
tazuna
TUI tool for managing multiple Claude Code sessions in parallel.
Features
- Multiple PTY-based Claude Code sessions
- git worktree integration
- Claude Code hooks-based notifications
- Tab/popup UI with ratatui
Installation
cargo install --path .
Plugin Setup
tazuna uses a Claude Code plugin for hooks integration (notifications, permission requests, etc.).
Installation
-
Add tazuna marketplace:
claude plugin marketplace add oshiteku/tazuna -
Install the plugin:
claude plugin install tazuna -
Verify:
claude plugin marketplace list
Usage
Key Bindings
Global
| Key | Action |
|---|---|
Ctrl+w |
Terminate current session |
Ctrl+n / Ctrl+p |
Switch to next/previous session |
Ctrl+s |
Display workspace popup |
Ctrl+q |
Exit tazuna |
Workspace Popup
| Key | Action |
|---|---|
Ctrl+n |
Next item (cross-section wrap) |
Ctrl+p |
Previous item (cross-section wrap) |
Ctrl+m |
Confirm selection (Enter) |
Ctrl+g |
Cancel (close popup) |
Tab / Shift+Tab |
Switch section |
↑ / ↓ |
Navigate within section |
d |
Delete worktree (Worktrees section) |
p |
Pull worktree (Worktrees section) |
Text Selection
Mouse events are captured by tazuna for tab switching and scrolling. To select and copy text, use Shift+drag (standard terminal emulator behavior).
Configuration
Config file location: ~/.config/tazuna/config.toml
Example
[session]
max_sessions = 10
[worktree]
auto_cleanup = false
branch_prefix = "tazuna/"
base_path = "~/.tazuna/worktrees"
pull_strategy = "merge" # or "rebase"
[notification]
terminal_bell = true
[notification.webhook]
enabled = false
url = ""
[log]
directory = "~/.local/share/tazuna/logs"
[claude]
default_args = []
Options
| Section | Key | Default | Description |
|---|---|---|---|
| session | max_sessions | 10 | Maximum concurrent sessions |
| worktree | auto_cleanup | false | Auto-delete worktree on session end |
| worktree | branch_prefix | "tazuna/" | Prefix for auto-generated branches |
| worktree | base_path | ~/.tazuna/worktrees | Worktree storage location |
| worktree | pull_strategy | "merge" | Pull strategy: "merge" or "rebase" |
| notification | terminal_bell | true | Enable terminal bell |
| notification.webhook | enabled | false | Enable webhook notifications |
| notification.webhook | url | "" | Webhook URL (Slack, Discord, etc.) |
| log | directory | ~/.local/share/tazuna/logs | Session log directory |
| claude | default_args | [] | Default Claude Code CLI arguments |
Development
Pre-commit Hooks
# prek install
cargo install --locked prek
# or: brew install prek
# enable hooks
prek install
Hooks: cargo fmt, cargo clippy, typos, trailing-whitespace, etc.
License
MIT OR Apache-2.0