> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eigenpal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI overview

> Install the EigenPal CLI, authenticate, and manage workflows, datasets, runs, and agents.

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.

```bash theme={null}
npm install -g @eigenpal/cli
```

Source is open at [github.com/eigenpal/cli](https://github.com/eigenpal/cli).

## Authenticate to your organization

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
eigenpal skill install
```

The command opens an interactive picker for Claude Code, Cursor, Codex, and
other tools. See [Install the EigenPal skill](/guides/skill-install) 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.

```bash theme={null}
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](/guides/build-a-dataset) and
[Evaluate a workflow](/guides/evaluate-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.

```bash theme={null}
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](/guides/first-workflow).

**Work with a Git-backed agent.** Clone the organization's agent source, edit
it, then commit, push, and release.

```bash theme={null}
eigenpal agents clone --out tmp/org-repos/acme-prod
eigenpal agents commit -m "teach invoice totals"
eigenpal agents push
```

See [Agents](/concepts/agents).

## Command reference

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

| Command                              | Description                                                                                                                                                                                                                                                                                 |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`eigenpal status`](/cli/status)     | One-shot dashboard: server, active tenant, user, key id, workflow count. Pair with --json for scripting.                                                                                                                                                                                    |
| [`eigenpal init`](/cli/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`](/cli/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`](/cli/workflow) | Manage workflows: push, pull, and evaluate.                                                                                                                                                                                                                                                 |
| [`eigenpal agents`](/cli/agents)     | Manage EigenPal agents: Git source, datasets, experiments, sessions, and releases.                                                                                                                                                                                                          |
| [`eigenpal run`](/cli/run)           | Start a workflow or agent run, e.g. workflows.extract-invoice.                                                                                                                                                                                                                              |
| [`eigenpal rerun`](/cli/rerun)       | Create a new run from a previous run's stored input snapshot.                                                                                                                                                                                                                               |
| [`eigenpal runs`](/cli/runs)         | Inspect, watch, and manage workflow, agent, and eval runs.                                                                                                                                                                                                                                  |
| [`eigenpal skill`](/cli/skill)       | Install / uninstall / list the EigenPal agent skill in your project (Claude Code, Cursor, Codex, Gemini CLI, Antigravity, OpenCode, Pi, Windsurf, GitHub Copilot).                                                                                                                          |