{"id":49802087,"url":"https://github.com/eigenpal/cli","last_synced_at":"2026-06-03T01:01:36.727Z","repository":{"id":355387613,"uuid":"1227475179","full_name":"eigenpal/cli","owner":"eigenpal","description":"Create, evaluate, and deploy workflows from your terminal. Agent-ready.","archived":false,"fork":false,"pushed_at":"2026-06-02T22:04:43.000Z","size":1423,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-02T22:15:21.964Z","etag":null,"topics":["cli","eigenpal"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eigenpal.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-02T18:28:10.000Z","updated_at":"2026-06-02T22:04:49.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/eigenpal/cli","commit_stats":null,"previous_names":["eigenpal/cli"],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/eigenpal/cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eigenpal%2Fcli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eigenpal%2Fcli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eigenpal%2Fcli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eigenpal%2Fcli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eigenpal","download_url":"https://codeload.github.com/eigenpal/cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eigenpal%2Fcli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33843611,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-02T02:00:07.132Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","eigenpal"],"created_at":"2026-05-12T15:00:51.874Z","updated_at":"2026-06-03T01:01:36.715Z","avatar_url":"https://github.com/eigenpal.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# @eigenpal/cli\n\nCreate, evaluate, and deploy workflows from your terminal. Agent-ready.\n\n[![npm](https://img.shields.io/npm/v/@eigenpal/cli?color=3B5BDB\u0026labelColor=555\u0026label=npm)](https://www.npmjs.com/package/@eigenpal/cli)\n[![downloads](https://img.shields.io/npm/dm/@eigenpal/cli?color=3B5BDB\u0026labelColor=555\u0026label=downloads)](https://www.npmjs.com/package/@eigenpal/cli)\n[![license](https://img.shields.io/badge/license-Apache--2.0-3B5BDB?labelColor=555)](https://github.com/eigenpal/cli/blob/main/LICENSE)\n[![docs](https://img.shields.io/badge/docs-eigenpal%2Fcli-3B5BDB?labelColor=555)](https://github.com/eigenpal/cli)\n\n## Install\n\n```bash\nnpm i -g @eigenpal/cli\neigenpal auth login            # or set EIGENPAL_API_KEY in CI\neigenpal skill install         # install skill for your agent\n```\n\n## Commands\n\n| Command                                   | Purpose                                               |\n| ----------------------------------------- | ----------------------------------------------------- |\n| [`eigenpal status`](./docs/status.md)     | Server, tenant, user, key id, workflow count.         |\n| [`eigenpal init`](./docs/init.md)         | Scaffold a `workflow` or `agent` project.             |\n| [`eigenpal auth`](./docs/auth.md)         | Profile management.                                   |\n| [`eigenpal workflow`](./docs/workflow.md) | Workflow, evaluators, dataset, experiment, execution. |\n| [`eigenpal agents`](./docs/agents.md)     | Agent source, triggers, runs, datasets, and sessions. |\n| [`eigenpal run`](./docs/run.md)           | Run an agent target such as `agents.invoice@latest`.  |\n| [`eigenpal runs`](./docs/runs.md)         | List runs for an agent target.                        |\n| [`eigenpal skill`](./docs/skill.md)       | Install the agent skill across AI tools.              |\n\n## Use it\n\n`cd` into a folder with your data, then ask your agent:\n\n\u003e Build a workflow that extracts line items from these PDFs, judge with an\n\u003e LLM, seed five dataset examples, and run an experiment.\n\nThe skill teaches your agent the schemas. The platform handles versioning,\nevals, traces, and governance.\n\n```bash\neigenpal init workflow extract --template pdf-extraction\neigenpal workflow validate                              # local validation\neigenpal workflow execution run \u003cid\u003e \u003cexample\u003e --watch  # one-shot run\neigenpal workflow dataset push \u003cid\u003e --file ./dataset    # upload dataset\neigenpal workflow experiment run \u003cid\u003e                   # batch eval\neigenpal workflow execution list \u003cid\u003e --json | jq       # query as JSON\n```\n\n## Primitives\n\n| Primitive      | Purpose                                                 |\n| -------------- | ------------------------------------------------------- |\n| **Workflow**   | Versioned DAG of steps. The thing that runs in prod.    |\n| **Dataset**    | `(input, expected_output)` examples. Your ground truth. |\n| **Evaluator**  | Scorers: LLM judge, exact match, custom.                |\n| **Experiment** | Batch run of a workflow over a dataset, scored.         |\n\n## Environment variables\n\nMost 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.\n\n| Variable            | Purpose                                                                                                                                                                                                                              |\n| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `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. |\n| `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.                        |\n| `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 \u003cname\u003e`.   |\n| `EIGENPAL_DIR`      | Override the workflow project directory used by `init` / `validate`. Defaults to `./eigenpal`.                                                                                                                                       |\n\nResolution precedence: command-line flags \u003e env vars \u003e active profile \u003e defaults.\n\n## Support\n\nFile issues at [github.com/eigenpal/cli/issues](https://github.com/eigenpal/cli/issues).\n\n## License\n\nApache-2.0. See [LICENSE](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feigenpal%2Fcli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feigenpal%2Fcli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feigenpal%2Fcli/lists"}