dores-agent Tool Tutorial

dores-agent Tool Tutorial

dores-agent is the bridge tool that lets Dores drive Claude Code and Codex for programming tasks.

After dores-agent is installed and running, Dores can send coding tasks from the chat window to the local bridge service. The bridge receives a websocket task, checks the requested runner, and then dispatches the task to the matching coding tool:

runner: "claude" -> Claude Code execution
runner: "codex" -> Codex execution

Use this tool if you want commands such as /claude and /codex in Dores to create independent programming tasks instead of normal chat messages.

1. Install And Start

Install the official npm package:

npm install -g dores-agent

If you want to pin the current release version:

npm install -g [email protected]

On macOS, installation automatically registers and starts the resident service by default.

The default service behavior is:

mode=client
upstream=ws://127.0.0.1:8765

This means dores-agent runs in the background and connects to the local Dores websocket service.

If you disabled automatic installation or need to start the resident service manually, run:

dores-agent install

You can check whether the service is running with:

dores-agent status

After the service is running, return to Dores and use:

/claude your programming task
/codex your programming task

2. Uninstall

To remove the resident service:

dores-agent uninstall

This stops and unregisters the macOS background service used by Dores to drive Claude Code and Codex.