@eigenpal/cli

Create, evaluate, and deploy workflows from your terminal. Agent-ready.

Install

npm i -g @eigenpal/cli
eigenpal auth login            # or set EIGENPAL_API_KEY in CI
eigenpal skill install         # install skill for your agent

Commands

Command	Purpose
eigenpal status	Server, tenant, user, key id, workflow count.
eigenpal init	Scaffold a workflow or agent project.
eigenpal auth	Profile management.
eigenpal workflow	Workflow, evaluators, dataset, experiment, execution.
eigenpal agent	Agent ops (coming soon).
eigenpal skill	Install the agent skill across AI tools.

Use it

cd into a folder with your data, then ask your agent:

Build a workflow that extracts line items from these PDFs, judge with an LLM, seed five dataset examples, and run an experiment.

The skill teaches your agent the schemas. The platform handles versioning, evals, traces, and governance.

eigenpal init workflow extract --template pdf-extraction
eigenpal workflow validate                              # local validation
eigenpal workflow execution run <id> <example> --watch  # one-shot run
eigenpal workflow dataset push <id> --file ./dataset    # upload dataset
eigenpal workflow experiment run <id>                   # batch eval
eigenpal workflow execution list <id> --json | jq       # query as JSON

Primitives

Primitive	Purpose
Workflow	Versioned DAG of steps. The thing that runs in prod.
Dataset	(input, expected_output) examples. Your ground truth.
Evaluator	Scorers: LLM judge, exact match, custom.
Experiment	Batch run of a workflow over a dataset, scored.

Environment variables

Most users never need to set these — eigenpal auth login writes a profile to ~/.config/eigenpal/credentials.json and every command derives its config from there. Reach for env vars when you can't run an interactive login (CI), need to switch context for one shell, or want to override a single field without editing the credentials file.

Variable	Purpose
EIGENPAL_API_KEY	Bypass the profile entirely. Set in CI to skip auth login. When set, EIGENPAL_BASE_URL (or the cloud default) is used — the active profile is not consulted, so a stale profile can't redirect a CI run to the wrong server.
EIGENPAL_BASE_URL	Override the server URL for one command or shell. Pairs with EIGENPAL_API_KEY to point CI at an on-prem deployment. Without EIGENPAL_API_KEY, this overrides whatever the active profile would have used.
EIGENPAL_PROFILE	Switch the active profile for one shell without touching ~/.config/eigenpal/credentials.json. Useful for ad-hoc context switches: EIGENPAL_PROFILE=staging eigenpal status. Persistent equivalent: eigenpal auth use <name>.
EIGENPAL_DIR	Override the workflow project directory used by init / validate. Defaults to ./eigenpal.

Resolution precedence: command-line flags > env vars > active profile > defaults.

Support

File issues at github.com/eigenpal/cli/issues.

License

Apache-2.0. See LICENSE.