> ## 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 twin

> Start, reset, and inspect a standalone local digital twin.

`pome twin` runs a digital twin on its own, outside a run. Use it when you want to
point an agent, a test, or `curl` at a twin and drive it by hand.

A run does not need this: `pome run` boots the twin it needs, and hosted runs
provision one per sandbox.

## Usage

```bash theme={"dark"}
pome twin start <name> [options]
pome twin reset [name]
pome twin status
```

## `twin start`

Starts a standalone twin as a long-lived foreground server. Press `Ctrl-C` to
stop it.

### Arguments

| Argument | Required | Description                                        |
| -------- | -------- | -------------------------------------------------- |
| `<name>` | Yes      | `github`, `slack`, `stripe`, `gmail`, or `linear`. |

### Options

| Flag            | Default                                                           | Description   |
| --------------- | ----------------------------------------------------------------- | ------------- |
| `--port <port>` | `$PORT`, else `3336` for `gmail` (`GMAIL_TWIN_PORT`), else `3333` | Port to bind. |

## `twin reset`

Resets standalone twin state back to its declared starting point.

| Argument | Required | Description                                                 |
| -------- | -------- | ----------------------------------------------------------- |
| `[name]` | No       | Twin to reset. Omit it to reset standalone state generally. |

## `twin status`

Prints the standalone twin status. Takes no arguments.

## Examples

```bash theme={"dark"}
# Serve the GitHub twin on the default port
pome twin start github

# Two twins side by side
pome twin start github --port 3333
pome twin start slack --port 3334

# Back to a clean starting state
pome twin reset github

# What is running?
pome twin status
```

## See also

* [`pome endpoints`](./endpoints) — what a twin serves.
* [`pome sandbox`](./sandbox) — the hosted equivalent, with a bearer and a TTL.