ππΌββοΈ The blackboard for coding agents - agentic development environment for claude code, codex, cursor, opencode, grok and more.
Rust adeai-agentsclaudeclaude-codecodexcursorgeminigrokopencodespec-driven-developmentvibe-codingvim
AGENTS.md
This file provides guidance to AI coding agents (Claude Code, Codex, Gemini, Copilot, OpenCode, Cursor, etc.) when working with the agtx codebase.
What is agtx?
A terminal-native kanban board for managing multiple coding agent sessions in parallel. Each task gets its own git worktree, tmux window, and agent session. Written in Rust.
Build & Test
cargo build --release
cargo test --features test-mocks
Key Architecture
src/
βββ main.rs # CLI entry point, AppMode routing
βββ lib.rs # Module exports
βββ tui/app.rs # Main TUI app (largest file β board, popups, key handling)
βββ db/schema.rs # SQLite operations (tasks, projects, notifications)
βββ db/models.rs # Task, Project, TaskStatus structs
βββ mcp/server.rs # MCP server (JSON-RPC over stdio)
βββ tmux/ # Tmux session/window management
βββ git/ # Worktree creation, conflict detection
βββ agent/ # Agent detection, spawn commands
βββ config/ # GlobalConfig, ProjectConfig, WorkflowPlugin
βββ skills.rs # Skill deployment to agent-native paths
See CLAUDE.md for the full architecture reference including common task patterns, code conventions, and testing approach.
Core Concepts
- Tasks move through:
Backlog β Planning β Running β Review β Done - Each task gets a git worktree + tmux window + agent session
- Plugins (TOML) customize the task lifecycle per phase
- MCP server (
agtx mcp-serve) exposes the board as tools over stdio - Global MCP (
agtx mcp-serve, no args) serves all projects via~/.config/agtx/index.db - Project MCP (
agtx mcp-serve <path>) serves a single project (used by the orchestrator)
Sweep Skill
If you want to sweep this conversation into agtx tasks, use the sweep skill:
@skills/sweep/SKILL.md
Follow the Sweep workflow in that file.
Rules
- Edit
src/for behavior changes β never edit generated or compiled artifacts - Run
cargo test --features test-mocksbefore considering any change done - Database migrations use
ALTER TABLE ... ADD COLUMN(errors ignored if column exists) - Mock-dependent tests use
#[cfg(feature = "test-mocks")] - See CLAUDE.md for adding new fields, agents, plugins, shortcuts