Zellij Backend

How It Works

1. Creates a git worktree in ~/.clauderon/worktrees/<session-name>/
2. Creates a new Zellij session
3. Starts the chosen agent with your prompt

Creating Sessions

Zellij is the default backend:

clauderon create --repo ~/project --prompt "Explore the codebase"

# Explicitly
clauderon create --backend zellij --repo ~/project --prompt "Task"

Attaching to Sessions

clauderon attach <session-name>

# Or directly via Zellij
zellij attach clauderon-<session-name>

Key Bindings

• Ctrl+p - Zellij mode selection
• Ctrl+p then d - Detach
• Ctrl+p then q - Quit

Troubleshooting

Problem	Fix
Session not found	zellij list-sessions to check; clauderon reconcile to sync DB
Env not set	Session may have started without daemon. Delete and recreate.
Zellij not found	brew install zellij (macOS) or cargo install zellij (Linux)