orke employee list

Read AI employees, their states, and pending request counts.

Command referenceEnglish

When to use it

Read the AI employee list, current states, and pending request counts. This also supplies the value for --slug in other employee commands.

Usage

Syntax · [ ] marks optional arguments
orke employee list

Options

OptionsRequired?Value and description
——No command-specific options. Only common options (--json, --timeout) apply.

Common management options and errors →

Example

Terminal
orke employee list
orke employee list --json

Without --json, output is indented JSON for easier reading.

What to check in the result

items: slug · name · phase · running · meeting · pendingRequests · needsHelp · shiftStartedAt · nextShiftAt · rest · consecutiveFailures. phase can be draft, stopped, working (on shift), resting, meeting (in a meeting), retryWaiting (waiting to retry), or configError (configuration error).

Behavior and states to watch

  • Read only. This does not change an employee's state.
  • running indicates whether “Start work” is enabled; needsHelp indicates whether a person needs to act, such as signing in.
  • This is a human (operator) command. Calls from an AI employee on shift are rejected with control_forbidden.

Search documentation

The page could not be displayed. Reload ×