How fynnfluegge/agtx works
agtx is a terminal-native kanban and orchestration environment for coding agents. A user creates and organizes project tasks on the TUI board; workflow phases and plugins guide agent selection, while the app provisions worktrees and tmux sessions, hands work to agents, and tracks progress for review and merging. SQLite stores board state. MCP and the optional mobile server provide alternate ways to inspect or operate the board. The README documents additional skills and orchestration features; unsampled wiring is shown only where documented or supported by the tree.
Main entry points: app.rs Board app · routes.rs HTTP routes · tmux/mod.rs Session control · db/mod.rs Board database
Components 26
Board workflow
- Task actions
src/core/actions.rs - Workflow config
src/config/mod.rs - Agent skills
src/skills.rs
Agent execution
- Agent registry
src/agent/operations.rs - Agent specs
src/agent/spec.rs - Git worktrees
src/git/worktree.rs - Session control
src/tmux/mod.rs - Agent status hooks
src/agent/hook_status.rs
Board interfaces
- CLI entry
src/main.rs - Board app
src/tui/app.rs - Kanban views
src/tui/board.rs - MCP server
src/mcp/server.rs - Mobile server
src/web/mod.rs - HTTP routes
src/web/routes.rs - Mobile writes
src/web/writes.rs - Mobile board
web/app.js - Mobile API
web/api.js - Live terminal stream
src/web/ws.rs
Project state
- Board database
src/db/mod.rs
External integrations
- Git operations
src/git/operations.rs - GitHub operations
src/git/provider.rs - Coding agent CLIs
- tmux server
- Git repository
Other components
- Developer
- Mobile user
Connections 33
- Developer → CLI entry: runs
- CLI entry → Board app: starts
- CLI entry → MCP server: starts MCP
- CLI entry → Mobile server: starts server
- Board app → Kanban views: renders
- Board app → Task actions: dispatches actions
- Board app → Board database: reads and writes
- Board app → Workflow config: loads settings
- Board app → Agent registry: selects agent
- Board app → Git worktrees: provisions worktree
- Board app → Session control: controls sessions
- Board app → Agent skills: uses skills
- Agent registry → Agent specs: builds commands
- Agent registry → Coding agent CLIs: launches
- Session control → tmux server: controls
- Git worktrees → Git repository: creates worktrees
- Git operations → Git repository: operates on
- Agent status hooks → Board database: records status
- MCP server → Board database: reads and writes
- MCP server → Session control: inspects sessions
- MCP server → Git operations: checks repository
- Mobile user → Mobile board: uses board
- Mobile board → Mobile API: requests data
- Mobile API → HTTP routes: calls endpoints
- Mobile server → HTTP routes: serves routes
- HTTP routes → Board database: reads board
- HTTP routes → Git operations: reads diffs
- HTTP routes → Session control: reads sessions
- HTTP routes → Mobile writes: dispatches writes
- Mobile writes → Board database: updates board
- Mobile board → Live terminal stream: opens live stream
- Live terminal stream → Session control: streams pane
- Board app → GitHub operations: uses PR operations