Eve CLI Primitives Use this skill as the command map for Eve. Keep examples short and concrete. Profiles (API Target + Defaults)
Create and use a profile
eve profile create staging --api-url https://api.eh1.incept5.dev eve profile use staging
Set defaults to avoid repeating flags
eve profile set --default-email you@example.com --default-ssh-key ~/.ssh/id_ed25519 eve profile set --org org_xxx --project proj_xxx
Inspect current profile
eve profile show Authentication eve auth login eve auth status eve auth logout eve auth permissions
Sync local OAuth tokens for agent harnesses (optional)
eve auth sync
Nostr challenge (API-level, no CLI command yet)
POST /auth/challenge
Orgs and Projects eve org list eve org ensure my-org --slug myorg eve project list eve project ensure --name "My App" --slug my-app --repo-url git@github.com:me/my-app.git --branch main
Membership management
eve org members --org org_xxx eve org members add user@example.com --role admin --org org_xxx eve org members remove user_abc --org org_xxx eve project members --project proj_xxx eve project members add user@example.com --role admin --project proj_xxx eve project members remove user_abc --project proj_xxx URL impact: The org --slug and project --slug directly form your deployment URLs and K8s namespaces: URL: {service}.{orgSlug}-{projectSlug}-{env}.{domain} (e.g., api.myorg-my-app-staging.eh1.incept5.dev ) Namespace: eve-{orgSlug}-{projectSlug}-{env} (e.g., eve-myorg-my-app-staging ) Choose slugs carefully — they are immutable after creation. Environments and Deploys
Create a persistent environment
eve env create staging --project proj_xxx --type persistent
Inspect environments
eve env list --project proj_xxx eve env show staging --project proj_xxx
Deploy an environment (requires --ref with 40-char SHA or a ref resolved against --repo-dir)
eve env deploy staging --ref main --repo-dir .
When environment has a pipeline configured, the above triggers the pipeline.
Use --direct to bypass pipeline and deploy directly:
eve env deploy staging --ref main --repo-dir . --direct
Pass inputs to pipeline:
eve env deploy staging --ref main --repo-dir . --inputs '{"key":"value"}'
Diagnostics
eve env diagnose proj_xxx staging eve env logs proj_xxx staging eve env delete proj_xxx staging Jobs (Create + Observe) eve job create --description "Review auth flow" eve job list --phase active eve job show < job-id
eve job follow < job-id
eve job diagnose < job-id
eve job result < job-id
Coordination (Supervise + Threads) eve supervise < job-id
--timeout 60 eve thread messages < thread-id
--since 10m eve thread post < thread-id
--body '{"kind":"directive","body":"focus on auth"}' eve thread follow < thread-id
Agents + Chat
Sync agent/team/chat configuration from repo
eve agents sync --project proj_xxx --ref main --repo-dir .
Inspect resolved agent config (from latest sync)
eve agents config --project proj_xxx --json
Simulate chat routing without Slack
eve chat simulate --project proj_xxx --team-id T123 --channel-id C456 --user-id U789 --text "hello"
Set org default agent slug (fallback when no slug matches)
eve org update org_xxx --default-agent mission-control
Packs (AgentPacks)
eve packs status
eve packs resolve --dry-run
eve migrate skills-to-packs
Slack gateway commands (run inside Slack):
@eve
--org org_xxx
Nostr integration (via API)
POST /integrations
Pipelines and Workflows eve pipeline list eve pipeline show < project
< name
eve pipeline run < name
--ref < sha
--env < env
--repo-dir ./my-app eve workflow list eve workflow show < project
< name
eve workflow run < project
< name
--input '{"k":"v"}' eve workflow invoke < project
< name
--input '{"k":"v"}' eve workflow logs < job-id
Builds Builds are first-class primitives that track image construction from input (spec) to execution (run) to output (artifacts).
List builds for a project
eve build list [ --project < id
]
Create a build spec
eve build create --project < id
--ref < sha
--manifest-hash < hash
Show build spec details
eve build show < build_id
Start a build run
eve build run < build_id
List runs for a build
eve build runs < build_id
View build logs
eve build logs < build_id
[ --run < run_id
]
List produced image artifacts (digests)
eve build artifacts < build_id
Full diagnostic dump (spec + runs + artifacts + logs)
eve build diagnose < build_id
Cancel an active build
eve build cancel < build_id
Builds happen automatically during pipeline build steps. Use eve build diagnose to debug build failures. System Health eve system health Harnesses (Optional) eve harness list eve harness list --capabilities eve harness get mclaude eve agents config --json Notes Use --project if no default project is set in the profile. Integrations are org-scoped; use --org for integrations commands. Prefer eve job ... (singular) for job commands.