Get started with Fleet

Fleet runs on its own, with no thurbox. These steps take it from nothing to a coding agent working on a Task. You need tmux (psmux on Windows), git, and a coding-agent CLI that is installed and logged in (Agents).

1. Install Fleet #

bash
curl -fsSL https://raw.githubusercontent.com/Thurbeen/thurbox/main/scripts/install.sh | sh -s -- --fleet-only

This puts fleet, the shipped runtime runtime-mux and the shipped workspace provider workspace-git in ~/.local/bin. Windows, a 2.x note and a service for fleet up are on Install Fleet.

2. Set it up and start the manager #

bash
fleet init     # writes ~/.config/fleet/config.toml, offline
fleet doctor   # checks each agent's program and the runtime
fleet up       # the manager: keep it running in its own terminal

fleet up keeps every Task moving until you press Ctrl+C. The sessions keep running when it stops, and the next fleet up picks them up again.

3. Apply a first Task #

A Task is a JSON file. This one runs Claude Code in a new worktree of a local repository:

fix-login.json
{
  "apiVersion": "fleet/v1alpha1",
  "kind": "Task",
  "metadata": {"name": "fix-login"},
  "spec": {
    "harness": "claude",
    "brief": "Fix the login redirect and run the tests.",
    "workspace": ["git+file:///home/me/app"],
    "dispatch": true
  }
}
bash
fleet apply -f fix-login.json

harness names the agent, brief is its first prompt, and workspace lists what it works in (file:// for a directory as it is). Nothing starts while dispatch is false. Every field is in the Task resource.

4. Follow it, talk to it, read its result #

bash
fleet list task                          # every Task and its phase
fleet watch --json                       # one event per change, until Ctrl+C
fleet send fix-login "Run the tests too" # a message for its agent
fleet status task fix-login --json       # status.result once the agent records one
fleet delete task fix-login              # stop it and remove its worktree

The agent reports its answer with fleet result, which fills status.result. fleet attach fix-login prints the command that opens its terminal, and fleet --help lists every command. Next: how Fleet works, and the Thurbox interface to watch every session at once.