A local agent lets Dart send work to an AI coding tool running on your own computer, handy when you want to assign work from Dart while keeping the coding session close to your local repository, credentials, and environment. For example, you can assign a task to your local Claude Code or Codex instance.
Before you start
Install and log in to the Dart CLI (pip install dart-tools, then dart login), and make sure the local coding tool you want is installed. Dart currently supports Claude Code, Codex, Gemini, and OpenCode.
Create and connect
Open Agents, then create or open a custom agent.
Choose Local and pick the tool that should run the work.
Copy the
dart agent-connect <agent_id>command and run it in a terminal on the machine where the agent should work.When connected, Dart shows the agent as Connected. Keep the process running to accept work.
You can also run the connection in the background (--background), list connections (dart agent-connections), and disconnect (dart agent-disconnect <agent_id>).
Send work to it
Once connected, assign a task to the local agent, mention it in a comment, or chat with it. Dart routes the work to the connected terminal session and the response appears back where it started.