Codeman
Skip to terminal
00:00:00
0 tasks | $0.00
↻ Watching #0
Orchestrator idle
0%
Ralph / Todo Tracker Idle
⏱0m ✓0/0
▼

0%
Complete
Tasks 0/0
Phrase `--`
Elapsed 0m
Plan
v1

# Codeman

Manage AI Coding tools in persistent tmux sessions.

### Resume Conversation

Or press `Ctrl`+`Enter` to start

Project Insights
Files
Select a session to view files
file.ts
Last Response

### Keyboard Shortcuts

`Ctrl`+`W`
Close Session
`Ctrl`+`Tab`
Next Session
`Alt`+`1-9`
Switch to Tab N
`Ctrl`+`L`
Clear Terminal
`Ctrl`+`+`
Increase Font
`Ctrl`+`-`
Decrease Font
`Ctrl`+`?`
Show Help
`Ctrl`+`Shift`+`V`
Voice Input
`Escape`
Close Panels
Monitor
Tmux Sessions
No mux sessions
Plan Wizard Agents 0 active
No plan agents
Background Agents 0 tracked
No background agents
Background Tasks 0 running
Subagents
No background agents detected
Select an agent to view details

### Session Options

Auto-resume when usage limit resets If Claude pauses on a usage limit ("limit reached · resets 3pm"), Codeman waits for the reset time and automatically continues the work. Independent of the respawn loop below.
Respawn loop
One autonomous work cycle: whenever Claude goes idle, Codeman sends the update prompt, optionally runs /clear + /init, and kickstarts the next round — repeating for the chosen duration. All settings below belong to this loop; configure them, then press Enable.
Duration
min
Presets
Load Preset

Cycle Steps
1. Update Prompt update all the docs and CLAUDE.md
2. Send /clear 3. Send /init Auto-accept prompts
4. Kickstart Prompt Sent only when /init completes but Claude stays idle · Auto-accept presses Enter for plan approvals and default options
Not active
Appearance
Session Name
Custom name shown in the tab (right-click tab to rename inline)
Session Color
Token Management
Auto-Compact
tokens
Summarizes context while preserving key information
Auto-Clear
tokens
Full context reset at threshold (use higher than compact)
File Watching
Image Watcher Auto-popup new images (screenshots, generated files) in this session's directory
Performance
Flicker Filter Buffers output after screen clears to reduce Ink UI flickering (adds ~50ms latency)
Enable Tracker Auto-detects loops and todos in Claude output
Completion Phrase Phrase Claude outputs when loop is complete (without <promise> tags)
Limits
Max Iterations 0 = unlimited
Max Todos Per session
Todo Expiration
min

Select a session to view summary

### Close Session

### App Settings

Appearance
Skin
Input
Local Echo Instant typing feedback with local echo
CJK Input Dedicated IME input field for CJK languages
Extended Keyboard Bar Extra keys: Tab, Esc, arrows, Ctrl+O
Gesture Control (beta) Camera hand-tracking overlay (applied on reload)
Header Displays
Font Controls
System Stats
Token Count
Show Cost ($)
Lifecycle Log
Response Viewer
Multi-monitor Button
Tab Bar
Tall Tabs (Name + Folder)
Panels
Monitor
Project Insights
File Browser
Subagents
Subagent Options
Enable Tracking
Active Tab Only
Image Watcher
Enable Globally
Remote Access
Cloudflare Tunnel
Tunnel URL
Upload URL
Updates
Current Version —
Check for Updates
Update available
Startup Mode
How Claude CLI is started in screen sessions
Allowed Tools Comma-separated list of tools to allow
Enable Ralph / Todo Tracker Auto-enable for new sessions (otherwise auto-enables on Ralph pattern detection)
Claude Permissions
Agent Teams Enable experimental Agent Teams for all new Claude sessions (disabled by default)
Claude Model
Model for new Claude sessions (pinned via the case's .claude/settings.local.json) — takes precedence over the 1M Opus toggle below
1M Opus Context Use 1M token context window (model: opus[1m]) for all new sessions — ignored when a Claude Model is selected above
Thinking Effort
Default effort for new Claude sessions — soft default, switchable anytime in-session via /effort (e.g. /effort ultracode)
Nice Priority
Enable Nice Priority Reduction Lower priority of Claude sessions (reduces system impact, only affects new sessions)
Nice Value Process priority (-20 to 19, higher = lower priority, default: 10)
Codex CLI
Bypass Approvals and Sandbox Start new Codex sessions with --dangerously-bypass-approvals-and-sandbox
Default Model
Model used for execution tasks. Optimizer suggestions are advisory only.
Show Optimizer Recommendations Show what the optimizer recommends (doesn't override your choice)
Agent Type Overrides

Optionally set specific models for each task type. Leave as "Use Default" to use your default model.

Explore Tasks
Quick searches, codebase exploration
Implement Tasks
Code writing, feature implementation
Test Tasks
Writing and running tests
Review Tasks
Code review, quality checks
Default CLAUDE.md Template Used when creating new cases. Leave empty for built-in template.
Default Working Directory Default directory for new sessions.
Master Control
Enable Notifications
Browser
?
For remote access, HTTPS is required. Start with: `codeman web --https`
Push
off
Works through Cloudflare tunnel. Requires HTTPS or localhost. iOS requires PWA (Add to Home Screen).
Alerts
Audio Alerts
Idle Threshold
min
Notification Levels
Critical
Warning
Info
Per-Event Settings
Event
On
Browser
Push
Sound
Permission prompts
Questions from Claude
Session idle
Response complete
Respawn cycles
Task complete
Subagent activity
Provider
Active Provider —
Behavior
Insert mode
Deepgram Nova-3
API Key
Stored locally only, never sent to server. Get a key at console.deepgram.com
Language
Domain Keywords Comma-separated terms to boost recognition accuracy

### Add Case

Case Name Letters, numbers, hyphens, underscores only. Created in ~/codeman-cases/
Description (optional)
Case Name Name to identify this case in Codeman
Folder Path Absolute path to an existing project folder, e.g. /home/you/my-project
Use arrows to reorder. Changes are saved automatically.

### Select Case

### Start Ralph Loop

1 Describe
2 Plan
3 Launch

Describe your task below. Claude will generate an implementation plan with testing steps.

What do you want to build?
Working Directory
Iterations
Starting Opus 4.5... 0s

Initializing deep reasoning model

Auto-launch when plan completes
■ Stopped

Use Back to edit your task, or Next to continue without a plan

Implementation Plan
Detail:
Prompt Preview
Completion Phrase: `COMPLETE`
Max Iterations: 10
Case: testcase
Plan: -
Advanced Options
Enable Respawn Auto-restart sessions when context fills up (usually not needed)

### Kill All Sessions

Choose how to close 0 session(s):

Notifications
No notifications

### Token Usage Statistics

Last 7 Days
Daily Breakdown

### Save Respawn Preset

Preset Name
Description (optional)
Session Lifecycle Log

Time | Event | Session | Reason | Extra
--- | --- | --- | --- | ---

No lifecycle entries found