# 创建并使用配置文件
eve profile create staging --api-url https://api.eh1.incept5.dev
eve profile use staging
# 设置默认值以避免重复使用标志
eve profile set --default-email you@example.com --default-ssh-key ~/.ssh/id_ed25519
eve profile set --org org_xxx --project proj_xxx
# 检查当前配置文件
eve profile show
身份验证
eve auth login
eve auth status
eve auth logout
eve auth permissions
# 为代理工具同步本地 OAuth 令牌（可选）
eve auth sync
# Nostr 挑战（API 级别，暂无 CLI 命令）
# POST /auth/challenge {"provider": "nostr", "pubkey": "<hex>"}
组织和项目
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
# 成员管理
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 影响： 组织的 和项目的 直接构成你的部署 URL 和 K8s 命名空间：
🇺🇸English
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 {"provider": "nostr", "pubkey": "<hex>"}
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
# 创建持久化环境
eve env create staging --project proj_xxx --type persistent
# 检查环境
eve env list --project proj_xxx
eve env show staging --project proj_xxx
# 部署环境（需要 --ref 参数，值为 40 字符的 SHA 或相对于 --repo-dir 解析的引用）
eve env deploy staging --ref main --repo-dir .
# 当环境配置了流水线时，上述命令会触发流水线。
# 使用 --direct 绕过流水线直接部署：
eve env deploy staging --ref main --repo-dir . --direct
# 向流水线传递输入：
eve env deploy staging --ref main --repo-dir . --inputs '{"key":"value"}'
# 诊断
eve env diagnose proj_xxx staging
eve env logs proj_xxx staging
eve env delete proj_xxx staging
作业（创建 + 观察）
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>
协调（监督 + 线程）
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>
代理 + 聊天
# 从代码仓库同步代理/团队/聊天配置
eve agents sync --project proj_xxx --ref main --repo-dir .
# 检查解析后的代理配置（来自最新同步）
eve agents config --project proj_xxx --json
# 在没有 Slack 的情况下模拟聊天路由
eve chat simulate --project proj_xxx --team-id T123 --channel-id C456 --user-id U789 --text "hello"
# 设置组织默认代理 slug（当没有匹配的 slug 时的回退选项）
eve org update org_xxx --default-agent mission-control
包（AgentPacks）
eve packs status
eve packs resolve --dry-run
eve migrate skills-to-packs
eve secrets list --project proj_xxx
eve secrets set API_KEY "value" --project proj_xxx
eve secrets delete API_KEY --project proj_xxx
eve secrets show API_KEY --project proj_xxx
eve secrets ensure --project proj_xxx --keys API_KEY
eve secrets export --project proj_xxx --keys API_KEY
系统管理（如果已授权）
eve system status
eve system jobs
eve system envs
eve system logs api --tail 50
eve system pods
eve system events
工作流
eve workflow list
eve workflow run qa-review --input '{"task":"audit"}'
eve workflow invoke qa-review --input '{"task":"audit"}'
eve workflow logs job_abc123
集成（Slack、Nostr、GitHub）
eve integrations list --org org_xxx
eve integrations slack connect --org org_xxx --team-id T123 --token xoxb-test
eve integrations test <integration_id> --org org_xxx
# Nostr 集成（通过 API）
# POST /integrations {"provider": "nostr", "account_id": "<platform-pubkey>", ...}
流水线和工作流
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>
构建
构建是一等原语，用于跟踪从输入（规范）到执行（运行）再到输出（制品）的镜像构建过程。
# 列出项目的构建
eve build list [--project <id>]
# 创建构建规范
eve build create --project <id> --ref <sha> --manifest-hash <hash>
# 显示构建规范详情
eve build show <build_id>
# 启动构建运行
eve build run <build_id>
# 列出构建的运行
eve build runs <build_id>
# 查看构建日志
eve build logs <build_id> [--run <run_id>]
# 列出生成的镜像制品（摘要）
eve build artifacts <build_id>
# 完整的诊断转储（规范 + 运行 + 制品 + 日志）
eve build diagnose <build_id>
# 取消活动的构建
eve build cancel <build_id>
构建会在流水线的 build 步骤中自动发生。使用 eve build diagnose 来调试构建失败。
系统健康
eve system health
工具（可选）
eve harness list
eve harness list --capabilities
eve harness get mclaude
eve agents config --json
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
eve secrets list --project proj_xxx
eve secrets set API_KEY "value" --project proj_xxx
eve secrets delete API_KEY --project proj_xxx
eve secrets show API_KEY --project proj_xxx
eve secrets ensure --project proj_xxx --keys API_KEY
eve secrets export --project proj_xxx --keys API_KEY
System Admin (if authorized)
eve system status
eve system jobs
eve system envs
eve system logs api --tail 50
eve system pods
eve system events
Workflows
eve workflow list
eve workflow run qa-review --input '{"task":"audit"}'
eve workflow invoke qa-review --input '{"task":"audit"}'
eve workflow logs job_abc123
Integrations (Slack, Nostr, GitHub)
eve integrations list --org org_xxx
eve integrations slack connect --org org_xxx --team-id T123 --token xoxb-test
eve integrations test <integration_id> --org org_xxx
# Nostr integration (via API)
# POST /integrations {"provider": "nostr", "account_id": "<platform-pubkey>", ...}
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.
