Skip to content

Background tasks

A background task is a command that keeps running while the model continues. Use it for a dev server, watcher or long test run.

For example, ask:

Run the test suite in the background and investigate the failing parser test while it runs.

Press Ctrl+B while a shell command runs to move it to the background. This moves the command; it does not interrupt it. The model can also start one directly with the bash tool’s run_in_background option.

Use /tasks to list tasks and their status. Open a task to watch its output, or use /tasks <id> to open it directly. /tasks stop <id> stops a running task.

The model can check output and stop tasks too. When a task finishes, Tatu notifies the conversation.

Tasks are not persistent services. /new, /resume and /fork stop the tasks of the session you leave. Quitting the agent stops its tasks too; resuming a saved session does not restart them.

Print mode (-p) has no background tasks: it runs the prompt and exits.