CLI overview - EigenPal Docs

Use the eigenpal CLI to author workflows, push datasets and evaluators, start runs, inspect traces, and manage Git-backed agents. Most resources are files, so the same commands work for local development, CI, and agent-assisted editing.

npm install -g @eigenpal/cli

Source is open at github.com/eigenpal/cli.

Authenticate to your organization

eigenpal auth login

This opens a browser to create an API key and stores it locally. One key maps to one tenant, so the key decides which organization you are working in. Work across several organizations by keeping a named profile per org and switching between them:

eigenpal auth list        # show configured profiles, active one marked
eigenpal auth use acme    # switch the active profile

Optional: install the skill

Install the EigenPal skill into a supported coding agent if you want it to work with EigenPal commands and file formats directly:

eigenpal skill install

The command opens an interactive picker for Claude Code, Cursor, Codex, and other tools. See Install the EigenPal skill for the full list and non-interactive options.

Common ways to work

Build and score a dataset. Create examples with expected output, push evaluators, and run an experiment from the CLI.

eigenpal workflow dataset example create <workflow-id> \
  --name acme-01 \
  --input-json '{"language":"en"}' \
  --expected-file expected.json
eigenpal workflow evaluators push <workflow-id>
eigenpal workflow experiment run <workflow-id> --wait

See Build a dataset and Evaluate a workflow. Author and iterate on a workflow. Scaffold a project, push it, run it on a file, and read the trace to see what each step did. Edit workflow.yaml, push a new version, and compare experiments before deploying.

eigenpal init workflow parse-invoice
eigenpal workflow push
eigenpal run workflows.parse-invoice --input-file document=invoice.pdf
eigenpal runs trace <run-id>

See Your first workflow. Work with a Git-backed agent. Clone the organization’s agent source, edit it, then commit, push, and release.

eigenpal agents clone --out tmp/org-repos/acme-prod
eigenpal agents commit -m "teach invoice totals"
eigenpal agents push

See Agents.

Command reference

Every command group has its own page with all subcommands, flags, and arguments.

Command	Description
`eigenpal status`	One-shot dashboard: server, active tenant, user, key id, workflow count. Pair with —json for scripting.
`eigenpal init`	Scaffold a new workflow project. Without [name], scaffolds into the current directory using the cwd basename as the workflow name. With [name], creates ./<name>/ and uses that as the slug. The flat layout matches what run workflows.<slug> already discovers, no manual file moves.
`eigenpal auth`	Manage authentication. Credentials live in ~/.config/eigenpal/credentials.json as named profiles. Switch tenants with auth use <name> or set EIGENPAL_PROFILE=<name> for one shell.
`eigenpal workflow`	Manage workflows: push, pull, and evaluate.
`eigenpal agents`	Manage EigenPal agents: Git source, datasets, experiments, sessions, and releases.
`eigenpal run`	Start a workflow or agent run, e.g. workflows.extract-invoice.
`eigenpal rerun`	Create a new run from a previous run’s stored input snapshot.
`eigenpal runs`	Inspect, watch, and manage workflow, agent, and eval runs.
`eigenpal skill`	Install / uninstall / list the EigenPal agent skill in your project (Claude Code, Cursor, Codex, Gemini CLI, Antigravity, OpenCode, Pi, Windsurf, GitHub Copilot).

​Authenticate to your organization

​Optional: install the skill

​Common ways to work

​Command reference

Authenticate to your organization

Optional: install the skill

Common ways to work

Command reference