<!-- GENERATED by scripts/build-docs.mjs from the live Commander tree (src/cli/program.ts). Do not edit by hand. -->

# pai launch

> Start the Claude Code harness on any provider/model from workers.yaml.

No args, in a terminal: pick from a numbered table. --list (or piped/non-
interactive output): print the table and exit.
--provider <name> [--model <model>]: start directly, no prompt.
A running claude process cannot switch provider — this always starts a NEW
session in the current terminal. Claude Code's own /model command only shows
the CURRENT endpoint's models; `pai launch --list` (or the /providers skill)
shows every provider configured here.
Extra arguments after the options are passed to claude verbatim, e.g.
`pai launch --provider glm -- --resume <id>`.
The `glm`/`kimi` shell shims are thin aliases of `pai launch --provider <name>`.

## Synopsis

```
pai launch [args...] [options]
```

## Arguments

| Argument | Kind | Description |
|----------|------|-------------|
| `[args...]` | variadic | extra claude arguments, e.g. --resume <id> |

## Options

| Option | Description | Default |
|--------|-------------|---------|
| `--provider <name>` | Provider to start on (default: prompt from the table) |  |
| `--model <model>` | Model id for that provider (default: the provider's default model) |  |
| `--list` | Print the provider/model table and exit |  |
| `--current` | With --list, also detect and mark this session's own provider/model |  |
| `--dry-run` | Print the resolved command and environment (key masked); do not exec |  |

## See also

[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)

Run `pai help <area>` to read any of these in the terminal.