opschain academy status
packs:academy
opschain academy status [flags]
Prints what the installed agent knows about itself: the lane, its
registration and label, the data directory and store, the cached packs and
the size of the offline evidence queue. opschain academy show is the
product-side view (what is pinned and installed, how the agent is
launched); this is the agent's own.
The launcher wires the product in before the agent starts: the targeted
OpsChain server (--server, OPSCHAIN_SERVER or the active context —
never local mode) becomes the agent's OPSCHAIN_SERVER, and its
OPSCHAIN_ACADEMY_TOKEN is a scoped API token minted under your stored
opschain login session for that server (the session proved first, an
expired login refused by name, the token revoked when the agent exits —
"The credential" in opschain docs cli/academy-serve) — or the
OPSCHAIN_ACADEMY_TOKEN you set, handed over as given. The agent only
ever reads with it. Without an installed agent, a server target or a
credential the command refuses by name. The agent runs in the foreground on this
command's streams; an interrupt, a termination or a hangup is relayed so
it ends on its own terms (see opschain docs cli/academy-serve), and its
exit status becomes this command's.
status reads the agent's data directory and talks to no Academy Server,
so the launcher does not ask for --academy-server. The agent release
this build pins still refuses to start without one (no Academy Server URL); until an agent release lifts that, pass --academy-server <url>
or set ACADEMY_AGENT_SERVER as for serve.
Flags
Every flag maps onto the agent's own flag of the same meaning and its
ACADEMY_AGENT_* environment variable (a flag wins over the environment;
only flags you set are passed). --academy-server is the Academy Server,
distinct from the global --server, the OpsChain server the agent reads;
status does not need one.
| Flag | Meaning |
|---|---|
--academy-server <url> | the Academy Server base URL (ACADEMY_AGENT_SERVER) |
--listen <addr> | address the learner pages listen on (default 127.0.0.1:8070; ACADEMY_AGENT_LISTEN) |
--data-dir <dir> | directory for the agent's store, deployment key and pack cache (default <opschain home>/academy; ACADEMY_AGENT_DATA_DIR) |
--grant-file <path> | file holding the registration grant, read at first run (ACADEMY_AGENT_GRANT_FILE) |
--key-file <path> | file holding the deployment key seed; default <data-dir>/deployment.key (ACADEMY_AGENT_KEY_FILE) |
--single-learner | the learner-local lane: one learner signing evidence with their own key (ACADEMY_AGENT_SINGLE_LEARNER) |
--label <text> | label shown to Academy administrators for this agent (ACADEMY_AGENT_LABEL) |
--session-ttl <duration> | browser sign-in lifetime, e.g. 12h (ACADEMY_AGENT_SESSION_TTL) |
--sync-interval <duration> | offline queue push and pack refresh interval, e.g. 30s (ACADEMY_AGENT_SYNC_INTERVAL) |
| `--tutor-provider anthropic | openai` |
--tutor-model <id> | the tutor model id; the provider's default when empty (ACADEMY_AGENT_TUTOR_MODEL) |
--tutor-base-url <url> | the tutor provider base URL; the provider's default when empty (ACADEMY_AGENT_TUTOR_BASE_URL) |
--tutor-key-env <name> | the environment variable holding the tutor model key (default ACADEMY_AGENT_TUTOR_KEY; ACADEMY_AGENT_TUTOR_KEY_ENV) |
--secure-cookies | mark the learner session cookie Secure, behind TLS (ACADEMY_AGENT_SECURE_COOKIES) |
Examples
$ opschain academy status
Exit codes: the agent's own exit status (128 plus the signal number when a signal ended it); 2 when no agent is installed, no server is targeted or no credential is available (the message names the fix).
See also
opschain docs cli/academy— the command family and a first session.opschain docs packs-academy— the lanes, the evidence model and the tutor.