pome init

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

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:

npx tsx examples/agents/scripted-triage-agent.ts

Typical setup flow

pome init
pome login
pome register agent my-triage-bot
pome tasks github --copy
pome run tasks/01-bug-happy-path.md

Examples

# Basic scaffold
pome init

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

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.

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.

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`.

Start

Guides

CLI

MCP

Usage

Options

What it creates

Typical setup flow

Examples

`pome register agent` options

​Usage

​Options

​What it creates

​Typical setup flow

​Examples

​Related commands

​pome login options

​pome register agent options

Usage

Options

What it creates

Typical setup flow

Examples

Related commands

`pome login` options

`pome register agent` options