Thor

Git worktree dashboard with AI agent coordination.

Features

• Worktree Management - List, create, switch, and remove git worktrees
• Agent Coordination - Monitor and control AI agents working in worktrees
• Notification Inbox - Receive task completion reports from agents
• Tmux Integration - Popup support, pane discovery, jump to agent panes
• Shell Integration - Automatic cd to selected worktree

Install

cargo install thor

Shell Integration

Add to your ~/.zshrc:

source /path/to/thor/scripts/thor.zsh

This enables:

• thor - Launch TUI with cd integration
• thor-popup - Tmux popup launcher

Tmux Integration

Add to your ~/.tmux.conf:

bind g display-popup -E -w 80% -h 70% -T " thor " "thor popup"

Usage

thor                   # Open TUI
thor popup             # Open as tmux popup

# Worktree workflow
thor wt list           # List worktrees
thor wt new <branch>   # Create worktree (--track, --base)
thor wt go <query>     # Navigate: fuzzy match, index (1-9), or "-" for previous
thor wt remove <branch> # Remove worktree (--force)
thor wt done [target]  # Finish branch: merge or --pr, then cleanup
thor wt pull           # Pull --rebase (--all for all worktrees)
thor wt rebase [base]  # Fetch + rebase onto origin/{base}
thor wt exec "<cmd>"   # Run command in every worktree
thor wt clean          # Prune stale refs (--merged to delete merged branches)

# Agent management
thor agent register    # Register agent session
thor agent list        # List active agents
thor agent complete    # Mark agent done

# Task management
thor task sync         # Sync tasks from stdin
thor task list         # List tasks
thor task update       # Update task status

# Signal control
thor signal pause      # Pause agent
thor signal resume     # Resume agent
thor signal abort      # Abort agent
thor signal check      # Check for signals (for agents)

# Queue operations
thor queue question    # Add question to queue
thor queue gate        # Request gate approval (--wait to block)
thor queue answer      # Answer a question
thor queue list        # List pending items

# Notifications
thor notify send       # Send a notification
thor notify list       # List notifications

TUI Keybindings

Configuration

~/.config/thor/config.toml:

[theme]
preset = "nord"  # nord, catppuccin, tokyo-night, dracula, solarized

Claude Code Integration

Thor integrates with Claude Code via hooks. See scripts/claude-hooks.json for the hook definitions to add to your .claude/settings.json. Hooks automatically register agents, sync tasks, route questions, and send completion notifications — all outside the token budget.

Data Locations

• Config: ~/.config/thor/config.toml
• Agents: ~/.local/share/thor/agents/
• Tasks: ~/.local/share/thor/sessions/{session}/tasks/
• Queue: ~/.local/share/thor/queue/

Project Structure

grove/
├── crates/
│   ├── thor-core/     # Git operations, tmux bridge, agent coordination
│   ├── thor-wt/       # Worktree workflow commands
│   ├── thor-notify/   # Notification schema and inbox
│   ├── thor-tui/      # Ratatui TUI interface
│   └── thor-cli/      # CLI entry point
└── scripts/
    ├── thor.zsh       # Shell wrapper for cd integration
    ├── _thor          # Zsh completion script
    └── claude-hooks.json  # Claude Code hook bridge

License

MIT