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

# pome init

> Scaffold a new Pome project with tasks, examples, and config.

`pome init` creates the local project layout Pome expects: `tasks/`,
`examples/agents/`, `runs/`, and `pome.config.json`. Run it once per agent project,
before your first `pome run`.

Hosted runs also require `pome login` and `pome register agent <name>` to link
runs to a cloud agent on the dashboard.

## Usage

```bash theme={"dark"}
pome init [options]
```

## Options

| Flag           | Default | Description                                                                                                                                                                                        |
| -------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--sdk <name>` | —       | Scaffold for a specific agent SDK. Supported values: `claude`, `claude-managed`. Both are gated on upcoming npm publishes — the command prints a deferral message and exits without writing files. |

## What it creates

| Path               | Purpose                                                                                            |
| ------------------ | -------------------------------------------------------------------------------------------------- |
| `tasks/`           | Your task markdown files (copy from the bundled library with `pome tasks <twin> --copy`).          |
| `examples/agents/` | Example agent implementations.                                                                     |
| `runs/`            | Default artifacts directory for `pome run`.                                                        |
| `pome.config.json` | Agent command, artifacts dir, and pass threshold. Written only if the file does not already exist. |

Default `pome.config.json` agent command:

```text theme={"dark"}
npx tsx examples/agents/scripted-triage-agent.ts
```

## Typical setup flow

```bash theme={"dark"}
pome init
pome login
pome register agent my-triage-bot
pome tasks github --copy
pome run tasks/01-bug-happy-path.md
```

## Examples

```bash theme={"dark"}
# Basic scaffold
pome init

# Attempt Claude SDK scaffold (deferred until adapter publishes to npm)
pome init --sdk claude
```

## Related commands

| Command                      | Purpose                                                                                                                           |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `pome login`                 | Sign in and store a `pme_…` API key (Keychain or `~/.pome/credentials.json`).                                                     |
| `pome register agent <name>` | Create a cloud agent; writes `agentId` and `agentSlug` to `pome.config.json`. Both keys are load-bearing — do not hand-edit them. |

<Note>
  Agent skills are not installed by the CLI. Get the coach skills with
  `npx skills add pome-sh/digital-twins` and connect the MCP with
  `claude mcp add --transport http pome https://mcp.pome.sh/mcp` — see the
  [Quickstart](/quickstart/claude-code).
</Note>

### `pome login` options

| Flag                    | Default               | Description                                 |
| ----------------------- | --------------------- | ------------------------------------------- |
| `--api-url <url>`       | `https://api.pome.sh` | Control-plane base URL.                     |
| `--dashboard-url <url>` | `https://app.pome.sh` | App URL for Clerk sign-in.                  |
| `--key-name <name>`     | `pome login`          | Label for the API key minted by this login. |

### `pome register agent` options

| Flag              | Default               | Description                                            |
| ----------------- | --------------------- | ------------------------------------------------------ |
| `--api-url <url>` | `https://api.pome.sh` | Control-plane URL.                                     |
| `--force`         | off                   | Overwrite an existing `agentId` in `pome.config.json`. |