Skip to main content
The eigenpal CLI is the surface the whole platform is built around. Workflows, datasets, evaluators, and agent source are all files you push and pull with it, which means a coding agent can do everything you can: build a workflow, assemble an eval set, run experiments, and read the scores. The same commands you type are the commands the agent runs. 
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

​
Install the skill

Install the EigenPal skill into your AI coding tool so the agent knows every command, flag, and file format without round-tripping through --help: 
eigenpal skill install
It installs into Claude Code, Cursor, and other tools through an interactive picker. See Install the EigenPal skill for the full list and options. With the skill in place, the workflows below are things you ask the agent to do, not commands you memorize.

​
Common ways to work

Point your agent at data, it builds the evals. Drop a folder of example documents in front of your coding agent and ask it to build an eval set. The agent creates dataset examples, writes ground-truth expected outputs, defines evaluators, and runs an experiment, all through the CLI. You review the scores, not the plumbing. 
eigenpal workflow dataset example create <workflow-id> --name acme-01 -F document=@acme.pdf
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. The agent edits workflow.yaml, pushes a new version, and compares experiments to prove a change helped. 
eigenpal init workflow parse-invoice
eigenpal workflow push
eigenpal run workflows.parse-invoice -F document=@invoice.pdf
eigenpal runs trace <run-id>
See Your first workflow. Work with a Git-backed agent. Clone the organization’s agent source, let a builder session 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.
CommandDescription
eigenpal statusOne-shot dashboard: server, active tenant, user, key id, workflow count. Pair with —json for scripting.
eigenpal initScaffold 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 authManage 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 workflowManage workflows: push, pull, and evaluate.
eigenpal agentsManage EigenPal agents: Git source, datasets, runs, experiments, sessions, and releases.
eigenpal runStart a workflow or agent run, e.g. workflows.extract-invoice.
eigenpal rerunCreate a new run from a previous run’s stored input snapshot.
eigenpal runsInspect, watch, and manage workflow, agent, and eval runs.
eigenpal gitPassthrough to git with organization remote auth and committer identity.
eigenpal completionPrint a shell completion script to stdout (supported shells: bash, zsh, fish). Pipe into the appropriate completion file for your shell, see the script header for install instructions.
eigenpal skillInstall / uninstall / list the EigenPal agent skill in your project (Claude Code, Cursor, Codex, Gemini CLI, Antigravity, OpenCode, Pi, Windsurf, GitHub Copilot).