Reference
phloem CLI
#Install
curl -fsSL https://dl.phloem.ai/cli/install.sh | shirm https://dl.phloem.ai/cli/install.ps1 | iexThen phloem login to sign in, and phloem update to stay current.
#Commands
status | What this device is and how it is doing |
login | Sign in to your Phloem account in the browser (or with --api-key in CI) |
logout | Sign out: revoke this machine's sign-in and forget it here |
update | Update the CLI to the latest signed release (`--check` only says whether there is one) |
whoami | Who the cloud says you are |
device | Your organization's devices: enrol a headless machine (an admin approves it), or remove one |
runs | Your organization's runs in the cloud, across every device |
reservoir | Reservoir, your organization's data lake: read-only SQL over everything recorded |
config | A device's or a fleet's configuration, kept in the cloud and applied to the device |
mcp | Connect an AI coding tool (Claude Code, Cursor, Codex) to your organization's MCP server |
time | Epoch-millisecond arithmetic: now, parse an instant, build a window |
asset | Assets: the equipment your data is about, and when each channel was about it |
connector | Cloud connectors (databases, ticketing, CAD…): list, add, run an operation, remove |
session | Ask Hamming, Phloem's agent, a question and print its answer |
field | Run fields: what an operator is asked for before a run's first step |
doctor | Check this machine's setup; `--bundle DIR` writes a signed bundle for support |
audit | Compare what was captured with what reached the cloud, for a window (`--last 1h`, or `--from`/`--to`) |
tail | Live records as they arrive (a glob narrows: `tail 'ni/**'`) |
peer | LAN peers: discover, pair, approve and list other machines running Phloem |
export | Export channels for a window (or a run) to a folder |
import | Import a recording file through its connector, attached to a named asset |
apply | Apply a configuration document (YAML or JSON): connectors, then settings, then inputs |
project | Projects on this machine: list, inspect, verify, create, switch, save, back up and restore |
profile | Profiles: published project versions in your organization's library |
run | Runs on this device: start and stop a manual run, list runs, show one |
layout | How the active project's screens are arranged: Live's and Replay's tabs and tiles |
trellis | Trellis: arm the stand with a test, run recipes, stop, reset and inspect |
release | Signed release files: load connectors onto a machine without internet |
extension | Connectors installed on this machine: list, install, remove, reset |
source | The active project's inputs, one at a time (`apply` sets them all from a document) [alias: input] |
pipeline | Temporary derived channels a tool adds to the pipeline (never saved into the project) |
cal | Calibration records, and which channel each one applies to |
function | This device's function library: promote a function into it |
#Global options
Accepted by every command.
--on <TARGET> | Which machine's Phloem: `local` (default), or another machine's read address (`http://stand-b:8078`) |
--via <ROUTE> | How to reach a LAN peer (`--device`): `auto` (Phloem on this machine if it answers, else the CLI's own node), `daemon`, `node` |
--api <URL> | The cloud API for cloud commands: `https://api.<org>.phloem.ai` (default: your sign-in's, else this machine's pairing) |
-f, --format <FORMAT> | `table` for people, `json` for scripts [default: table] |
-h, --help | Print help |
-V, --version | Print version |