# editor.start

> Talos next · Since next

[disk (starts an editor)] Start an editor on this project and wait for its control endpoint and first build ([editor], build.*, play.*, ui.* tools): the fix for a no-editor refusal.

None started if one runs. A refusal quotes the editor's output. With no display (or headless: true) it starts the workspace service alone, and play.* runs in a headless engine.

| | |
|---|---|
| Title | Start an editor |
| Mode |  |
| Token cost | about 235 tokens (in the default list, paid on every call) |
| Toolset | core |

## Arguments

| Argument | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `agent` | `string` | no |  |  | The name of the agent making the call, when several agents share one connection: each named agent is its own actor and plays its own game. Leave it out when there is one agent. |
| `binary` | `string` | no |  |  | Beside this agent or ARGUS_EDITOR_BIN when absent |
| `headless` | `boolean` | no | `false` |  | No editor: the workspace service alone, as with no display; play.* runs in a headless engine |
| `project` | `string` | no |  |  | The project folder; the session's when absent |
| `timeoutSeconds` | `integer` | no | `60` |  |  |

## Example

An MCP `tools/call` with the required arguments (placeholders in angle brackets).

```json
{
  "name": "editor.start",
  "arguments": {}
}
```