CLI Commands

The eve CLI is the single entry point to the Eve Horizon platform. Every operation -- from bootstrapping a local cluster to deploying production services, creating AI jobs, and managing secrets -- runs through it. The CLI is designed to work identically for humans and AI agents.

This page is an overview and quick-reference card. For full usage details, flags, and examples on every subcommand, see the CLI Appendix.

Global Flags

These flags apply to every command:

Flag	Description
--help	Show help for the current command or subcommand
--json	Output machine-readable JSON instead of formatted text
--profile <name>	Use a named repo profile (stored in .eve/profile.yaml)
--api-url <url>	Override the Eve API URL for this invocation
--org <id>	Override the default organization ID
--project <id>	Override the default project ID

Profiles store persistent defaults so you do not need to repeat --org, --project, or --api-url on every call. See eve profile for setup.

Command Categories

Getting Started

Command	Description
eve init	Initialize a new project from a starter template

Project Management

Command	Description
eve org	Manage organizations -- list, create, update, delete, members
eve project	Manage projects -- ensure, sync manifest, status, members
eve manifest	Validate manifests for schema correctness and required secrets
eve profile	Manage repo-local CLI profiles (API URL, org, project defaults)

Development

Command	Description
eve local	Manage a local k3d Kubernetes cluster running the Eve platform
eve db	Inspect and query environment databases -- schema, RLS, SQL, migrations
eve api	Explore project API sources, view specs, call endpoints with Eve auth

Jobs & Execution

Command	Description
eve job	Create, list, update, claim, follow, and review jobs
eve supervise	Long-poll for child job events (lead agent coordination)
eve harness	Inspect available harnesses, variants, and auth status

Deployment

Command	Description
eve env	Manage environments -- create, deploy, rollback, reset, diagnose, logs
eve build	Manage builds -- create specs, trigger runs, view logs and artifacts
eve release	Resolve and inspect releases by tag
eve pipeline	Run and inspect manifest-defined pipelines
eve workflow	Inspect and invoke manifest-defined workflows

Events & Webhooks

Command	Description
eve event	Emit and inspect events for app integration and pipeline triggers
eve webhooks	Manage outbound webhook subscriptions, delivery logs, and replays

Agents & Chat

Command	Description
eve agents	Inspect agent policy config, sync agents/teams/chat config
eve packs	Manage AgentPack lockfile and resolution
eve skills	Install skills from a URL, GitHub repo, or skills.txt manifest
eve chat	Simulate chat messages for gateway testing
eve thread	Manage org-scoped coordination threads for agent teams
eve integrations	Manage chat integrations (Slack)

Auth & Secrets

Command	Description
eve auth	Authenticate via SSH challenge, manage tokens, sync AI credentials
eve access	Check permissions, manage roles and bindings, sync policy-as-code
eve secrets	Manage secrets at system, org, user, or project scope
eve admin	Administrative operations -- invite users, manage ingress aliases

Knowledge

Command	Description
eve docs	Manage versioned org documents -- write, read, search, review lifecycle
eve memory	Manage canonical agent memory namespaces backed by org docs
eve kv	Agent key-value state with optional TTL
eve search	Unified org search across memory, docs, threads, attachments, events
eve fs	Manage org filesystem sync links, events, and diagnostics
eve resources	Resolve resource URIs into content snapshots

Observability

Command	Description
eve analytics	Org analytics -- job counts, pipeline success rates, environment health
eve system	System health, status, logs, pods, events, orchestrator settings (admin)

Inference

Command	Description
eve ollama	Manage inference targets, model installs, aliases, and route policies

Migration

Command	Description
eve migrate	Migration helpers for upgrading config formats (e.g., skills-to-packs)

Common Workflows

First-time setup

# Initialize a new project
eve init my-project
cd my-project

# Configure a CLI profile with your org and project
eve profile set --org org_xxx --project proj_xxx

# Authenticate
eve auth login --email you@example.com

Create and follow a job

# Create a job (defaults to 'ready' phase, immediately schedulable)
eve job create --description "Fix the login bug in auth.ts"

# Stream execution logs in real time
eve job follow MyProj-abc123

# Wait for completion with exit code
eve job wait MyProj-abc123 --timeout 300

Deploy to an environment

# Sync your manifest to the API
eve project sync

# Deploy via the environment's pipeline
eve env deploy staging --ref main --repo-dir .

# Check deployment status
eve project status --env staging

Manage secrets

# Set a project-level secret
eve secrets set GITHUB_TOKEN ghp_xxx --project proj_xxx --type github_token

# Validate manifest-required secrets
eve secrets validate --project proj_xxx

# Sync local AI tool credentials
eve auth sync --project proj_xxx

Environment Variables

The CLI reads these environment variables when present:

Variable	Purpose
EVE_API_URL	Default API URL (overridden by --api-url or profile)
EVE_JOB_ID	Current job ID (set automatically inside job runners)
EVE_AGENT_ID	Agent identifier (set automatically inside job runners)
EVE_ATTEMPT_ID	Current attempt UUID (set automatically inside job runners)
EVE_PARENT_JOB_ID	Parent job ID for coordination (set for child jobs)
EVE_PROJECT_ID	Current project ID (set automatically in deployed services)
EVE_ORG_ID	Current org ID (set automatically in deployed services)

Next Steps

• CLI Appendix -- full usage, flags, and examples for every subcommand
• Manifest Schema -- the .eve/manifest.yaml field reference
• Job API -- job lifecycle, creation parameters, and control signals