# tanomis agent new

Reference for tanomis agent new: scaffold a new agent from a harness template.

Generated from the <code>tanomis</code> command tree on 2026-10-01. Flags and defaults match the binary; run <code>tanomis agent new --help</code> for the version you have installed.

## Usage

```text title="Usage"
tanomis agent new NAME [flags]
```

## Description

Scaffold a new agent from a harness template into `<agents-root>`/``.

`--agents-root` defaults to dev/agents (the monorepo convention) but accepts any path, absolute or relative, including a directory outside this repo (e.g. an external agent repo cloned on its own). The generated agent is self-contained (agent.yaml, Python source, pyproject.toml, README, .gitignore, .tanomisignore) and has no monorepo-only assumptions, so it deploys with 'tanomis agent deploy' unmodified.

The manifest is production-ready as generated: it carries a live authorization contract (a scope_ceiling declaring the agent's own model, plus allowed_audiences). Golden snapshots are platform-managed to accelerate startup. Dependencies are locked with uv when it is available, which a remote build requires.

## Flags

| Flag | Type | Description |
|---|---|---|
| `--agents-root` | string | Target agents directory; any path, including one outside this repo. Default `dev/agents`. |
| `--description` | string | Manifest description. |
| `--harness` | string | Agent harness/framework. Default `claude-agents-sdk`. |
| `--model` | string | Model id. |
| `--overwrite` | bool | Overwrite an existing agent directory. |

<details>
<summary>Global flags</summary>

| Flag | Type | Description |
|---|---|---|
| `--config` | string | Config file path. |
| `--context` | string | Config context to use. |
| `-o`, `--output` | string | Output format: table\|json. |
| `--tenant` | string | Tenant id (X-Tenant-ID). |
| `--verbose` | bool | Verbose output. |

</details>

## Examples