Skip to main content
pome session manages hosted twin sandboxes on the Pome control plane — the same sessions visible on the dashboard Twins page. Requires pome login (or POME_API_KEY). GitHub and Stripe are supported today. Slack is local pome run only.

​
Usage

pome session create [options]
pome session list [options]
pome session stop <session-id> [options]
pome session kill <session-id>   # alias for stop

​
session create

Spin up a hosted sandbox for a twin and print connection details.

​
Options

FlagDefaultDescription
--twin <name>—Required. github or stripe.
--api-url <url>POME_API_URL or https://api.pome.shControl-plane base URL.
--show-secretsoffPrint bearer tokens and API keys. Unsafe on shared terminals.
--format <fmt>textOutput format: text, json, or env (shell export lines).

​
Examples

pome session create --twin github
pome session create --twin stripe --format env
pome session create --twin github --show-secrets --format json
With --format env, output includes lines like: 
export POME_GITHUB_REST_URL=...
export POME_AUTH_TOKEN=...
export POME_STRIPE_API_KEY=...    # stripe sessions only

​
session list

List hosted sessions. Defaults to --state running, matching the dashboard view.

​
Options

FlagDefaultDescription
--state <state>runningFilter: running, ready, done, expired, or all. running matches both server-side ready and running.
--limit <n>20Maximum rows to return.
--format <fmt>texttext or json.
--api-url <url>POME_API_URL or https://api.pome.shControl-plane base URL.

​
Examples

pome session list
pome session list --state all --limit 50
pome session list --format json

​
session stop

Stop a hosted session by id (ses_…).

​
Arguments

ArgumentRequiredDescription
<session-id>YesSession id from session create or session list.

​
Options

FlagDefaultDescription
--api-url <url>POME_API_URL or https://api.pome.shControl-plane base URL.

​
Examples

pome session stop ses_abc123
pome session kill ses_abc123   # same as stop