Merge pull request #3451 from docker/feat/board-kanban-tui

feat: add docker agent board, a Kanban TUI for orchestrating agents

Author: dgageot

cmd/root/board.go

@@ -0,0 +1,36 @@
+package root
+
+import (
+	"github.com/spf13/cobra"
+
+	boardtui "github.com/docker/docker-agent/pkg/board/tui"
+	"github.com/docker/docker-agent/pkg/telemetry"
+)
+
+// newBoardCmd creates the `docker agent board` command: a Kanban TUI that
+// orchestrates one agent per card, each running in a tmux session on an
+// isolated git worktree. Projects and column prompts are configured in the
+// user's global config file, or from the TUI itself.
+func newBoardCmd() *cobra.Command {
+	cmd := &cobra.Command{
+		Use:   "board",
+		Short: "Orchestrate agents on a Kanban board",
+		Long: `Board is a Kanban TUI for orchestrating agents. Each card launches an agent
+in a tmux session on an isolated git worktree, and moving a card forward
+through the pipeline (Dev → Review → Push → Done) sends the
+destination column's prompt to its agent.
+
+Projects and column prompts are stored in the global config file
+(~/.config/cagent/config.yaml) and can be managed from the TUI.`,
+		Example:      `  docker-agent board`,
+		Args:         cobra.NoArgs,
+		GroupID:      "core",
+		SilenceUsage: true,
+		RunE: func(cmd *cobra.Command, _ []string) error {
+			telemetry.TrackCommand(cmd.Context(), "board", nil)
+			applyTheme("")
+			return boardtui.Run(cmd.Context())
+		},
+	}
+	return cmd
+}

cmd/root/root.go

@@ -168,6 +168,7 @@ We collect anonymous usage data to help improve docker agent. To disable:
 		newDebugCmd(),
 		newAliasCmd(),
 		newSandboxCmd(),
+		newBoardCmd(),
 		newServeCmd(),
 		newAskpassCmd(),
 	)

docs/features/board/index.md

@@ -0,0 +1,83 @@
+---
+title: "Kanban Board"
+description: "Orchestrate multiple agents from a Kanban TUI: each card runs an agent in a tmux session on an isolated git worktree."
+keywords: docker agent, ai agents, features, board, kanban, orchestration
+linkTitle: "Kanban Board"
+weight: 15
+canonical: https://docs.docker.com/ai/docker-agent/features/board/
+---
+
+_Board is a Kanban TUI for orchestrating agents. Each card launches an agent
+in a tmux session on an isolated git worktree, and moving a card forward
+through the pipeline sends the destination column's prompt to its agent._
+
+## Launching the board
+
+```bash
+$ docker agent board
+```
+
+Requirements: `tmux` and `git` must be installed.
+
+## How it works
+
+- **Cards run agents.** Creating a card (`n`) launches `docker agent run` in
+  a dedicated tmux session, working in a fresh git worktree branched from the
+  project's upstream default branch. The card's title, running/idle status,
+  and failures are mirrored live from the agent's control plane.
+- **Columns are a pipeline.** The default pipeline is
+  Dev → Review → Push → Done. Moving a card forward (`]`)
+  sends the destination column's prompt to the card's agent; moving it back
+  (`[`) sends nothing.
+- **Attach anytime.** Press `enter` (or double-click a card) to attach your
+  terminal to the agent's session and interact with it directly; `ctrl+q`
+  detaches and returns to the board.
+- **Everything is recoverable.** Quitting the board leaves agents running in
+  tmux; restarting it reattaches to them. If an agent process dies, the board
+  relaunches it and resumes the same conversation and worktree.
+
+## Key bindings
+
+| Key           | Action                                              |
+| ------------- | --------------------------------------------------- |
+| `n`           | Create a card (project + prompt)                    |
+| `enter`       | Attach to the card's agent (`ctrl+q` detaches)      |
+| `d`           | View the card's worktree diff                       |
+| `o`           | Open the card's worktree in `$BOARD_EDITOR` (`code`) |
+| `[` / `]`     | Move the card back / forward                        |
+| `x`           | Delete the card, its session, worktree, and branch  |
+| `p`           | Manage projects                                     |
+| `e`           | Edit the selected column's prompt                   |
+| `←↓↑→` `hjkl` | Navigate                                            |
+| mouse         | Click selects, double-click attaches, wheel scrolls |
+| `?`           | Help                                                |
+| `q`           | Quit (agents keep running)                          |
+
+## Configuration
+
+Everything is configured in the global config file
+(`~/.config/cagent/config.yaml`) or through the TUI itself (`p` for projects,
+`e` for column prompts):
+
+```yaml
+board:
+  projects:
+    - name: my-app
+      path: /Users/me/src/my-app
+      agent: coder # any agent ref; defaults to the built-in agent
+  columns:
+    - id: dev
+      name: Dev
+      emoji: 🔨
+    - id: review
+      name: Review
+      emoji: 🔍
+      prompt: Review the local changes and fix any issues you find.
+    - id: done
+      name: Done
+      emoji: ✅
+```
+
+Omitting `columns` keeps the default pipeline. When a card enters a column
+with a `prompt`, that prompt is delivered to the card's agent as its next
+message.