Skip to main content
Reference for current pool commands and visible flags. For workflow guidance, start with Poolside Agent CLI.

​
pool

pool starts the interactive client by default. Arguments after -- are forwarded to the configured ACP agent server. For MCP server input variables, the interactive client passes through shell environment variables to the ACP server process.
FlagShortDescription
--directory-CWorking directory for the ACP session
--resume-rResume a previous session by ID, or use -r alone to open the session picker
--model-mOverride the saved model preference for the ACP session
--agent-serverACP agent server to use from pool.json
--unsafe-auto-allowAutomatically approve all tool calls without confirmation
--version-vShow the current pool version and exit
KEY=VALUE pool

​
pool exec

pool exec runs one non-interactive turn. Provide the prompt with --prompt, --prompt-file, or standard input. Files passed after -- are added as context for the run. For MCP server input variables, start pool exec with matching shell environment variables.
FlagShortDescription
--prompt-pPrompt to execute. Use - to read the prompt from standard input.
--prompt-file-fFile containing the prompt to execute
--directory-dWorking directory to operate in. Defaults to the current directory.
--agent-name-aAgent to use in tenant mode
--api-urlOpenAI-compatible API URL to use in standalone mode
--output-oOutput format: markdown or json. JSON output is newline-delimited JSON.
--unsafe-auto-allowAutomatically approve tool actions without confirmation
--verbosePrint verbose tool result output
--continueContinue a previous conversation. Provide a run ID, or use the flag alone to continue the last run.
KEY=VALUE pool exec -p "test"

​
Exit codes

CodeMeaning
0Task completed successfully
4The agent ran but reported that it could not complete the task
OtherUnexpected CLI or request error

​
pool acp

pool acp starts the Agent Client Protocol server for Poolside’s coding agent over standard input and standard output. For MCP server input variables, pool acp reads matching shell environment variables from the ACP server process.
FlagDescription
--reasoning <level>Set reasoning effort: xhigh, high, medium, low, minimal, or none
--version, -vShow the current pool acp version and exit
KEY=VALUE pool acp

​
pool acp setup

Use pool acp setup to add Poolside ACP entries to Zed or JetBrains configuration.
FlagDescription
--editor <editor>Editor to configure. Required. Supported values: zed and jetbrains
--forge-path <path>Path to a local forge checkout for development configuration

​
pool acp logs

pool acp logs reads the ACP debug log from /tmp/pool-acp-debug.log.
FlagShortDescription
--follow-fFollow log output
--pretty-pPretty-print log output

​
Setup and authentication

​
pool setup

pool setup runs the interactive setup flow.
  • Without --api-url, it configures standalone mode, opens Poolside’s platform in a browser, and prompts you to paste an API key.
  • With --api-url, it configures tenant mode and lets you choose browser login or direct token entry.
FlagDescription
--api-url <url>Configure tenant mode with the given API URL

​
pool login

pool login logs in to a Poolside deployment in tenant mode. If you omit --api, pool uses the configured API URL or prompts for one.
FlagShortDescription
--api <url>-aAPI URL to use

​
pool logout

pool logout removes stored credentials for the selected API URL. In standalone mode, it removes the stored standalone API key.
FlagShortDescription
--api <url>-aAPI URL to use

​
Configuration and updates

​
pool config

Prints the log, trajectory, and config directories, plus the credentials file path.

​
pool config settings

Opens settings.yaml in VISUAL, EDITOR, or vi, validates the file, and then saves it.

​
History

​
pool history logs

Use pool history logs [log-file-substring] to list recent log files or show one matching file.
FlagShortDescription
--all-aShow all log files instead of the most recent 20
--latest-lShow the most recent log file and write its filename to standard error
--pretty-pPretty-print log contents with colors and formatting
--follow-fFollow log output like tail -f

​
pool history trajectories

Use pool history trajectories [trajectory-file-substring] to list recent trajectory files or show one matching file.
FlagShortDescription
--all-aShow all trajectory files instead of the most recent 20
--latest-lShow the most recent trajectory file

​
pool history sessions

pool history sessions lists recent sessions.
FlagShortDescription
--all-aShow all sessions instead of the most recent 20
pool history sessions
pool history logs --latest --pretty
pool history trajectories --latest

​
MCP servers and secrets

​
pool mcp list

Lists configured MCP servers. Sensitive header values and environment values are masked in the output.

​
pool mcp get

Use pool mcp get <name> to inspect one MCP server configuration. Sensitive header values and environment values are masked in the output.

​
pool mcp remove

Use pool mcp remove <name> to remove an MCP server from settings.yaml.

​
pool mcp add

Use pool mcp add <name> [command] [args...] to add an MCP server. Use --transport to add a remote server. Without --transport, pool expects a command-based server and requires a command after --.
FlagShortDescription
--transport <type>-tTransport type for remote servers: http or sse
--env <key=value>-eEnvironment variable to store with the server. Repeat as needed.
--header <header>-HHTTP header for HTTP or SSE transport. Repeat as needed.

​
pool secrets list

Lists stored secrets and their source.

​
pool secrets add

Use pool secrets add <name> to store a secret in the system keychain.
FlagShortDescription
--description <text>-dDescription for the secret

​
pool secrets edit

Use pool secrets edit <name> to update a stored secret.
FlagShortDescription
--name <name>Rename the secret
--description <text>-dUpdate the description

​
pool secrets get

Use pool secrets get <name> to inspect a stored secret.
FlagDescription
--show-valueShow the stored secret value

​
pool secrets delete

Use pool secrets delete <name> to remove a secret from the keychain.