> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roark.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# roark agent build

> Build a Roark-hosted agent

Creates a new Roark-hosted agent from a one-line job description. Roark authors the system prompt and hosts the config, so the agent is live and self-improvable from creation.

```bash Synopsis theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark agent build [options]
```

> [!NOTE]
>
> Calls `POST /v1/agent/build`

## Options

**--name** `string` *required*

Name of the agent.

**--job-description** `string` *required*

One-line description of what the agent should do. Roark authors the system prompt from this.

**--voice** `string`

Optional voice label for the hosted agent.

## Example

```bash theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark agent build --name <value> --job-description <value>
```

Every command also takes the [global options](/cli-reference/overview.md#global-options) and sets one
of the [exit codes](/cli-reference/overview.md#exit-codes).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.