plori CLI
Install the CLI, complete browser login, run an agent, use JSON output in scripts, and keep API-key auth for CI.
Use the plori CLI when you want to create and run your cloud agents from a terminal or a script. It drives the same account and agents as the web app and the MCP server.
Install and sign in
npm i -g @plori/cli
plori login
plori login opens Plori's email-OTP page in your browser. A new email creates an
account inside that flow; an existing email signs back into its account. The CLI returns
when the browser has authorized it.
The browser flow requests the openid offline_access mcp scopes. It stores the public
OAuth client id, short-lived access token, rotating refresh token, expiry, and scopes in
~/.config/plori/config.json (or $XDG_CONFIG_HOME/plori/config.json) with file mode
0600. The CLI refreshes the session there when needed. plori logout removes those
local credentials.
For CI or another headless caller, create an API key in Dashboard → Settings → API keys, then use one of these existing key paths:
plori login --key plori_sk_…
# or, without writing a config file
export PLORI_API_KEY=plori_sk_…
First agent and first run
plori create mate
plori run mate "Research this topic and save the result to work/report.md"
create gets or creates by name, so running it again reuses mate instead of making a
duplicate. run waits for the reply by default. For longer work:
plori run mate "Run the full test suite" --no-wait
plori result mate <run-id> --wait
plori run mate "Build it and stream progress" --follow
Scripts and automation
Every command accepts --json. Output also becomes one JSON document automatically
when stdout is piped; progress and errors stay on stderr.
plori agents --json
plori credits --json
plori workflows list --json
Use plori schedule for one future agent turn and plori workflows for standing
automations. Run plori help for the complete command list.
Credits
plori credits shows the balance and, when it is low, the billing link for the account.
Any command refused with HTTP 402 prints a working billing link too. See
pricing for plan and one-time credit options.