[!NOTE] Add .agtx/ to your project's .gitignore to avoid committing worktrees and local task data.

Usage

Keyboard Shortcuts

| Key | Action | |-----|--------| | h/l or ←/→ | Move between columns | | j/k or ↑/↓ | Move between tasks | | o | Create new task | | ↩ | Open task (view Claude session) | | m | Move task forward in workflow | | r | Resume task (Review → Running) | | d | Show git diff | | x | Delete task | | / | Search tasks | | e | Toggle project sidebar | | q | Quit |

Task Workflow

1. Create a task (o): Enter title and description
2. Move to Planning (m): Creates worktree, starts Claude in planning mode
3. Move to Running (m): Claude implements the plan
4. Move to Review (m): Opens PR with AI-generated description
5. Move to Done (m): Cleans up worktree and tmux after PR is merged

Claude Session Features

• Sessions automatically resume when moving Review → Running
• Full conversation context is preserved across the task lifecycle
• View live Claude output in the task popup

Configuration

Config file location: ~/.config/agtx/config.toml

# Default agent for new tasks
default_agent = "claude"

[worktree]
enabled = true
auto_cleanup = true
base_branch = "main"

[theme]
color_selected = "#FFFF99"
color_normal = "#00FFFF"
color_dimmed = "#666666"
color_text = "#FFFFFF"
color_accent = "#00FFFF"
color_description = "#E8909C"

Project Configuration

Per-project settings can be placed in .agtx/config.toml at the project root:

# Files to co...