CLI Reference - 100xprompt

The 100xprompt command line is the front door to everything 100xprompt does. Run it with no arguments to drop into the interactive terminal, or reach for a subcommand to script a one-shot task, manage credentials and models, extend the agent, start a server, wire up integrations, or keep your install healthy. This page is the complete reference: the global options that apply everywhere, then every command grouped by what it’s for, each with its key arguments, important flags, and a short example. This page covers:

Global options - flags that work with any command
Start a session or run one prompt - interactive or one-shot
Connect providers, Extend the agent, Run a server - connect, grow, and serve
Run a swarm, Wire up GitHub, Browse sessions - teammates, integrations, and history
Keep your install healthy - upgrade, uninstall, and troubleshoot

The command surface at a glance

Global options

These options work with any command. They’re parsed before the subcommand runs.

Option	Alias	Description
`--help`	`-h`	Show help for `100xprompt` or any subcommand.
`--version`	`-v`	Print the installed version number.
`--print-logs`		Stream logs to standard error while the command runs.
`--log-level <level>`		Set verbosity: `DEBUG`, `INFO`, `WARN`, or `ERROR`.
`completion`		Print a shell completion script you can source from your shell profile.

# Show the version, then generate completions for your shell
100xprompt --version
100xprompt completion >> ~/.zshrc

Several commands that start a server also accept a shared set of network options - --port, --hostname, --mdns, and --cors. They’re documented on each command that uses them.

Start a session or run one prompt

Start a conversation in your terminal, or send a single prompt and get the result on standard output.

Default (interactive session)

Running 100xprompt with no subcommand launches the interactive terminal in the current directory. Pass a path to start somewhere else.

Argument / Option	Alias	Description
`[project]`		Directory to start 100xprompt in (defaults to the current directory).
`--model <provider/model>`	`-m`	Model to use, in `provider/model` form.
`--continue`	`-c`	Resume your most recent session.
`--session <id>`	`-s`	Open a specific session by id.
`--prompt <text>`		Preload an initial prompt (also accepts piped input on standard input).
`--agent <name>`		Start with a specific agent.
`--port`, `--hostname`, `--mdns`, `--cors`		Expose the session over the network (see network options).

# Start in the current project, continuing your last session
100xprompt --continue

# Open a specific folder with a chosen model
100xprompt ./services/api -m 100xprompt/pro

`run`

Suppose you want 100xprompt inside a script or CI job, not a live terminal. run sends a message (or a slash command) non-interactively and prints the response.

Argument / Option	Alias	Description
`[message..]`		The message to send. Anything piped on standard input is appended.
`--command <name>`		Run a defined command instead of a plain message; `message` becomes its arguments.
`--continue`	`-c`	Continue the last session.
`--session <id>`	`-s`	Continue a specific session.
`--resume`	`-r`	Interactively pick a session to resume.
`--fork <id>`		Fork an existing session by id and run against the copy.
`--fork-message <id>`		Message id to fork at (requires `--fork`).
`--model <provider/model>`	`-m`	Model to use.
`--variant <name>`		Model variant / reasoning effort (e.g. `high`, `max`, `minimal`).
`--agent <name>`		Agent to run the task with.
`--format <default\|json\|text\|stream-json>`		Output format: `default`/`text` (formatted), `json` (raw JSON events), or `stream-json` (newline-delimited JSON events).
`--output-format <text\|json\|stream-json>`		Output-format shorthand; overrides `--format`.
`--file <path>`	`-f`	Attach one or more files to the message (repeatable).
`--title <text>`		Set the session title (uses a truncated prompt if left empty).
`--print`	`-p`	Force non-interactive headless mode (also auto-detected on a non-TTY).
`--max-turns <n>`		Cap the agentic loop to N turns; exits non-zero if the cap is exhausted.
`--allow-tool <pattern>`		Allow a tool permission pattern (repeatable).
`--deny-tool <pattern>`		Deny a tool permission pattern (repeatable).
`--permission-mode <mode>`		Set the session permission mode: `default`, `acceptEdits`, `plan`, `auto`, or `bypassPermissions`.
`--dangerously-skip-permissions`		Alias for `--permission-mode bypassPermissions`.
`--system-prompt <text>`		Text to append to the system prompt for this run.
`--add-dir <path>`		Add an extra directory to the permitted filesystem boundary (repeatable).
`--share`		Share the session and print its link.
`--attach <url>`		Send to a running 100xprompt server instead of a local one.
`--port <number>`		Port for the local server (random by default).

# One-shot task, machine-readable output
100xprompt run "add a health check endpoint" --format json

# Pipe a diff in and ask about it, attaching a spec file
git diff | 100xprompt run "review this change" -f spec.md

Tips:

Add --format json (or --format stream-json for line-delimited events) to get raw events you can parse in a pipeline.
Reach for --continue to run a follow-up against the same session.
Use --command <name> to invoke a defined command instead of free text.
Cap runaway loops in CI with --max-turns; it exits non-zero when the cap is hit.

`generate`

Print the 100xprompt server’s API specification as JSON - the full OpenAPI document, annotated with client code samples - to standard output. Redirect it to a file to feed SDK generators or API tooling.

100xprompt generate > openapi.json

Connect providers and pick a model

Connect providers and see which models you can use.

`auth`

Manage the credentials 100xprompt uses to reach model providers. Requires a subcommand.

Subcommand	Alias	Description
`auth login [url]`		Log in to a provider. Runs an interactive picker, or point it at a provider URL for a well-known auth flow.
`auth logout`		Remove credentials for a configured provider.
`auth list`	`ls`	List stored credentials and any provider environment variables that are set.

# Interactively add a provider credential
100xprompt auth login

# See what's connected
100xprompt auth list

`models`

List every model available to you across your connected providers.

Argument / Option	Description
`[provider]`	Filter to a single provider id.
`--verbose`	Include per-model metadata such as costs.
`--refresh`	Refresh the models cache before listing.

# List every model, then include per-model metadata like cost
100xprompt models
100xprompt models --verbose

Extend the agent

Add agents, plugins, and external tools to grow what 100xprompt can do.

`agent`

Create and inspect agents. Requires a subcommand.

Subcommand	Description
`agent create`	Scaffold a new agent. Interactive by default; supply every flag for non-interactive use.
`agent list`	List all available agents with their mode and permissions.
`agent edit <name>`	Open a custom agent’s file in your `$EDITOR`.
`agent delete <name>`	Delete a custom agent (built-in agents can’t be deleted). Pass `-y` to skip the prompt.

agent create options

Option	Alias	Description
`--description <text>`		What the agent should do.
`--mode <all\|primary\|subagent>`		How the agent can be used.
`--tools <list>`		Comma-separated tools to enable (defaults to all).
`--model <provider/model>`	`-m`	Model the agent should use.
`--path <dir>`		Directory to write the agent file into.

# Guided creation
100xprompt agent create

# List agents and their permissions
100xprompt agent list

`plugin`

Install and manage marketplace plugins - bundles of commands, agents, skills, hooks, and MCP servers. Requires a subcommand.

Subcommand	Alias	Description
`plugin list`	`ls`	List installed plugins and whether each is enabled.
`plugin install <source>`	`add`	Install from a source spec (`github:owner/repo[/subdir][@ref]`, a git URL, or a local path) or a marketplace name. Use `--from-marketplace` to resolve `<source>` as a plugin name.
`plugin enable <name>`		Enable an installed plugin.
`plugin disable <name>`		Disable a plugin without removing it.
`plugin remove <name>`	`rm`, `uninstall`	Uninstall a plugin.
`plugin marketplace`	`market`, `mp`	Manage plugin marketplaces (see below).

plugin marketplace subcommands

Subcommand	Alias	Description
`marketplace add <source>`		Add a marketplace source (git, local, or URL).
`marketplace remove <source>`	`rm`	Remove a marketplace source.
`marketplace list`	`ls`	List added marketplace sources.
`marketplace browse`		List every plugin available across your marketplaces.

# Add a marketplace, browse it, and install something
100xprompt plugin marketplace add github:acme/plugins
100xprompt plugin marketplace browse
100xprompt plugin install github:acme/plugins/formatter

`mcp`

Manage Model Context Protocol servers that give 100xprompt access to external tools and data. Requires a subcommand.

Subcommand	Alias	Description
`mcp add`		Add an MCP server interactively (local command or remote URL) and write it to an `.mcp.json` file.
`mcp list`	`ls`	List configured servers and their connection status.
`mcp get <name>`		Show the resolved config and live status for one server.
`mcp remove <name>`	`rm`	Remove a server from its config file.
`mcp auth [name]`		Authenticate with an OAuth-enabled remote server. `mcp auth list` shows OAuth-capable servers and their status.
`mcp logout [name]`		Remove stored OAuth credentials for a server.
`mcp debug <name>`		Diagnose an OAuth connection for a server.

mcp add option

Option	Alias	Description
`--scope <project\|user\|local>`	`-s`	Where to write the entry: `project` (`.mcp.json`), `user` (your global config), or `local` (a gitignored `.mcp.local.json`). Defaults to `project`.

# Add a server, then check status
100xprompt mcp add
100xprompt mcp list

# Inspect and authenticate a remote OAuth server
100xprompt mcp get my-server
100xprompt mcp auth my-server

Run a server or open an interface

Run 100xprompt as a service, open the browser experience, or connect an editor.

The server-starting commands (serve, web, acp, spawn, and the interactive session) share these network options:

Option	Description	Default
`--port <number>`	Port to listen on.	random / `0`
`--hostname <host>`	Interface to bind to.	`127.0.0.1`
`--mdns`	Enable mDNS service discovery (binds to `0.0.0.0`).	off
`--cors <domain>`	Additional domains to allow for CORS (repeatable).	none

`serve`

Start a headless 100xprompt server with no interface - the backend for the web UI, the SDK, editors, and remote sessions.

100xprompt serve --port 4096
100xprompt serve --hostname 0.0.0.0 --mdns

`web`

Start a server and open the web interface in your browser. Prints local and network access URLs.

# Open locally
100xprompt web

# Serve on your network for remote access
100xprompt web --hostname 0.0.0.0

`acp`

Start an Agent Client Protocol server over standard input/output so a compatible editor can drive 100xprompt.

Option	Description
`--cwd <dir>`	Working directory for the session.
`--port`, `--hostname`, `--mdns`, `--cors`	Network options (see above).

100xprompt acp --cwd ./my-project

`spawn`

Launch a fresh interactive session backed by its own server process, optionally in a given project directory. Handy for opening a clean session from a script or wrapper.

Argument / Option	Description
`[project]`	Path to start 100xprompt in.
`--port`, `--hostname`, `--mdns`, `--cors`	Network options (see above).

100xprompt spawn ./services/worker

`attach`

Attach the interactive terminal to an already-running 100xprompt server.

Argument / Option	Alias	Description
`<url>`		Server URL to attach to, e.g. `http://localhost:4096`.
`--dir <path>`		Directory to run in.
`--session <id>`	`-s`	Session to continue.

100xprompt attach http://localhost:4096 -s ses_123

Run a swarm

Coordinate several 100xprompt processes at once. swarm spawns teammate agents into split terminal panes and lets them exchange messages, so you can fan a big job out across multiple agents working in parallel. Requires a subcommand.

Swarm runs on macOS and Linux. It uses your terminal multiplexer - an iTerm2 or tmux pane where available, otherwise a headless teammate - detected automatically.

Subcommand	Description
`swarm spawn <prompt...>`	Spawn a teammate agent in a split pane with the given task.
`swarm list`	List live swarm peers and any pending messages.
`swarm send <target> <message...>`	Send a message to a peer by name or process id (`*` broadcasts to all).

swarm spawn options

Option	Alias	Description
`--name <name>`		Teammate name - used as the pane title and message address.
`--model <provider/model>`	`-m`	Model for the teammate.
`--agent <name>`		Agent for the teammate.
`--dir <path>`		Directory the teammate works in (defaults to the current directory).
`--attach <url>`		Create the teammate’s session on a running 100xprompt server.

# Spawn a teammate to tackle part of the work, then message it
100xprompt swarm spawn "port the auth module to the new API" --name auth
100xprompt swarm list
100xprompt swarm send auth "prioritize the token refresh path first"

Wire up GitHub

Bring 100xprompt into your GitHub workflow.

`github`

Set up and run the GitHub agent, which responds to issues and pull requests. Requires a subcommand.

Subcommand	Description
`github install`	Install the GitHub app and add a workflow file to your repository.
`github run`	Run the GitHub agent for the current event (used inside the workflow).

github run options

Option	Description
`--event <json>`	A mock event to run the agent against (for local testing).
`--token <token>`	A GitHub personal access token.

# One-time setup in a repo
100xprompt github install

`pr`

Fetch and check out a pull request branch, then open 100xprompt on it - including importing any shared session linked in the PR description.

Argument	Description
`<number>`	The pull request number to check out.

100xprompt pr 482

pr uses the GitHub CLI under the hood, so make sure gh is installed and authenticated.

Browse and move sessions

Browse, measure, and move your session history.

`session`

Manage your sessions. Requires a subcommand.

Subcommand	Description
`session list`	List your top-level sessions.
`session fork <id>`	Fork a session into a new copy, optionally at a specific message (`-m <messageID>`).

session list options

Option	Alias	Description
`--max-count <n>`	`-n`	Limit to the N most recent sessions.
`--format <table\|json>`		Output as a table (default) or JSON.

# The 10 most recent sessions as JSON
100xprompt session list -n 10 --format json

`stats`

Show token usage and cost statistics across your sessions, with tool and model breakdowns.

Option	Description
`--days <n>`	Limit to the last N days (default: all time).
`--tools <n>`	Show the top N tools (default: all).
`--models [n]`	Show model statistics; pass a number to show the top N.
`--project <id>`	Filter by project id; pass an empty string for the current project.

# Cost and usage for the last 30 days, with model breakdown
100xprompt stats --days 30 --models

`export`

Export a session on standard output - as JSON (the default) or as a readable Markdown transcript. With no id, pick one interactively.

Argument / Option	Alias	Description
`[sessionID]`		Session to export (prompts if omitted).
`--format <json\|markdown>`	`-f`	Output format. Defaults to `json`.
`--thinking`		Include reasoning blocks in Markdown output.
`--tool-details`		Include full tool inputs and outputs in Markdown output.
`--metadata`		Include assistant metadata (model, duration) in Markdown output. On by default.

# Full JSON dump
100xprompt export ses_123 > session.json

# A readable transcript with reasoning included
100xprompt export ses_123 --format markdown --thinking > session.md

`import`

Import a session from a JSON file or a share URL.

Argument	Description
`<file>`	Path to a JSON file, or a share URL.

100xprompt import ./session.json

Keep your install healthy

Keep your install up to date, or remove it cleanly.

`upgrade`

Upgrade 100xprompt to the latest release or a specific version. The installation method is detected automatically.

Argument / Option	Alias	Description
`[target]`		Version to upgrade to (e.g. `0.1.48` or `v0.1.48`); defaults to the latest.
`--method <method>`	`-m`	Installation method: `curl`, `npm`, `pnpm`, `bun`, or `brew`.

# Upgrade to the latest
100xprompt upgrade

# Pin a specific version via a specific method
100xprompt upgrade 0.1.48 --method brew

`uninstall`

Remove 100xprompt and its related files. Shows a summary and asks for confirmation first.

Option	Alias	Description
`--keep-config`	`-c`	Keep configuration files.
`--keep-data`	`-d`	Keep session data and snapshots.
`--dry-run`		Show what would be removed without removing anything.
`--force`	`-f`	Skip confirmation prompts.

# Preview what would be removed
100xprompt uninstall --dry-run

# Remove everything but keep your config
100xprompt uninstall --keep-config

Start with --dry-run to see exactly which directories and files will be touched before committing to an uninstall.

`debug`

Troubleshooting tools for when something isn’t behaving. Requires a subcommand.

Subcommand	Description
`debug doctor`	Run health checks on your environment and configuration.
`debug config`	Print the fully resolved configuration 100xprompt is using.
`debug paths`	Show where 100xprompt keeps its data, config, cache, and state.
`debug lsp`	Inspect language-server integration.
`debug file <path>`	Show how 100xprompt reads and resolves a file.
`debug snapshot`	Inspect the session snapshot state.
`debug skill`	Inspect discovered skills.

# Check your setup, then see where things live
100xprompt debug doctor
100xprompt debug paths

Next steps

Quickstart: go from an empty terminal to your first shipped change.
Terminal: master slash commands, keys, and the interactive flow.
Workflows: put run and the GitHub agent to work in scripts and CI.

Quickstart

Go from an empty terminal to your first shipped change in five minutes.

Terminal

Get the most out of the interactive session - slash commands, keys, and flow.

Workflows

Put run and the GitHub agent to work in scripts and CI.

​The command surface at a glance

​Global options

​Start a session or run one prompt

​Default (interactive session)

​run

​generate

​Connect providers and pick a model

​auth

​models

​Extend the agent

​agent

​plugin

​mcp

​Run a server or open an interface

​serve

​web

​acp

​spawn

​attach

​Run a swarm

​Wire up GitHub

​github

​pr

​Browse and move sessions

​session

​stats

​export

​import

​Keep your install healthy

​upgrade

​uninstall

​debug

​Next steps

​Related

Quickstart

Terminal

Workflows

The command surface at a glance

Global options

Start a session or run one prompt

Default (interactive session)

`run`

`generate`

Connect providers and pick a model

`auth`

`models`

Extend the agent

`agent`

`plugin`

`mcp`

Run a server or open an interface

`serve`

`web`

`acp`

`spawn`

`attach`

Run a swarm

Wire up GitHub

`github`

`pr`

Browse and move sessions

`session`

`stats`

`export`

`import`

Keep your install healthy

`upgrade`

`uninstall`

`debug`

Next steps

Related