@epochtm/v12-cli

Official command-line client for Epoch V12 mission and worker operations.

Use the CLI from a terminal, CI job, or worker host to inspect missions, create governed work, and inspect registered workers.

Install

npm install -g @epochtm/v12-cli
pnpm add -g @epochtm/v12-cli
bun add -g @epochtm/v12-cli

Configure

# PowerShell
$env:EPOCH_V12_API_URL = "http://localhost:3011"
$env:EPOCH_V12_API_KEY = "your-workspace-scoped-key"
$env:EPOCH_V12_WORKSPACE_ID = "workspace-id"

The API key is sent as a bearer token to the stable /api/v1/epoch API. Keep it out of shell history and source control when using a production workspace.

Commands

List missions:

epoch-v12 missions list --workspace=workspace-id

Create a mission:

epoch-v12 missions create \
  --workspace=workspace-id \
  --institution=institution-id \
  --title="Verify deployment" \
  --objective="Confirm the deployment is healthy" \
  --acceptance="health check passes|evidence is recorded"

List workers:

epoch-v12 workers list --workspace=workspace-id

Enqueue a mission for worker execution:

epoch-v12 missions enqueue \
  --workspace=workspace-id \
  --mission=mission-id \
  --type=execute

The workspace can also be supplied through EPOCH_V12_WORKSPACE_ID.

Output and failures

Successful commands print JSON to stdout so they can be piped into other tools. Errors print to stderr and return a non-zero exit code.

Scope

This CLI uses the versioned Epoch V12 runtime API. It does not wrap the legacy SDK, API, MCP, onboarding, GitHub setup, dashboard, Account, or Organization UI flows.

Development

npm run build
node dist/index.js missions list --workspace=workspace-id