Back to Details

eve-cli-primitives

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Eve CLI Primitives

Eve CLI核心原语

Use this skill as the command map for Eve. Keep examples short and concrete.
将本技能作为Eve的命令参考手册。示例保持简短且具体。

Profiles (API Target + Defaults)

配置文件（API目标与默认设置）

bash
undefined
bash
undefined

Create and use a profile

创建并使用配置文件

eve profile create staging --api-url https://api.eh1.incept5.dev eve profile use staging
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
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
undefined
eve profile show
undefined

Authentication

身份认证

bash
eve auth login
eve auth status
eve auth logout
bash
eve auth login
eve auth status
eve auth logout

Sync local OAuth tokens for agent harnesses (optional)

为agent harness同步本地OAuth令牌（可选）

eve auth sync
undefined
eve auth sync
undefined

Orgs and Projects

组织与项目

bash
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
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.
bash
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
URL影响：组织的
--slug
和项目的
--slug
将直接构成你的部署URL和K8s命名空间：
  • URL格式：
    {service}.{orgSlug}-{projectSlug}-{env}.{domain}
    （示例：
    api.myorg-my-app-staging.eh1.incept5.dev
    ）
  • 命名空间格式：
    eve-{orgSlug}-{projectSlug}-{env}
    （示例：
    eve-myorg-my-app-staging
    ）
请谨慎选择slug——创建后无法修改。

Environments and Deploys

环境与部署

bash
undefined
bash
undefined

Create a persistent environment

创建持久化环境

eve env create staging --project proj_xxx --type persistent
eve env create staging --project proj_xxx --type persistent

Inspect environments

查看环境列表

eve env list --project proj_xxx eve env show staging --project proj_xxx
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)

部署环境（需要--ref参数，值为40位SHA哈希，或基于--repo-dir解析的引用）

eve env deploy staging --ref main --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:

使用--direct参数绕过流水线直接部署：

eve env deploy staging --ref main --repo-dir . --direct
eve env deploy staging --ref main --repo-dir . --direct

Pass inputs to pipeline:

向流水线传递输入参数：

eve env deploy staging --ref main --repo-dir . --inputs '{"key":"value"}'
undefined
eve env deploy staging --ref main --repo-dir . --inputs '{"key":"value"}'
undefined

Jobs (Create + Observe)

任务（创建与监控）

bash
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>
bash
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>

Agents + Chat

代理与聊天

bash
undefined
bash
eve agents sync --project proj_xxx --ref main --repo-dir .

Sync agent/team/chat configuration from repo

查看已解析的代理配置（来自最新同步）

eve agents sync --project proj_xxx --ref main --repo-dir .
eve agents config --project proj_xxx --json

Inspect resolved agent config (from latest sync)

在不依赖Slack的情况下模拟聊天路由

eve agents config --project proj_xxx --json
eve chat simulate slack --project proj_xxx --team-id T123 --channel C456 --user U789 --text "hello"
undefined

Simulate chat routing without Slack

密钥

eve chat simulate slack --project proj_xxx --team-id T123 --channel C456 --user U789 --text "hello"
undefined
bash
eve secrets list --project proj_xxx
eve secrets set API_KEY "value" --project proj_xxx
eve secrets delete API_KEY --project proj_xxx

Secrets

集成（Slack、GitHub）

bash
eve secrets list --project proj_xxx
eve secrets set API_KEY "value" --project proj_xxx
eve secrets delete API_KEY --project proj_xxx
bash
eve integrations list --project proj_xxx
eve integrations slack connect --project proj_xxx
eve integrations slack test --project proj_xxx

Integrations (Slack, GitHub)

流水线与工作流

bash
eve integrations list --project proj_xxx
eve integrations slack connect --project proj_xxx
eve integrations slack test --project proj_xxx
bash
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"}'

Pipelines and Workflows

构建

bash
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"}'
构建是一等原语，用于追踪从输入（规格）到执行（运行）再到输出（制品）的镜像构建过程。
bash
undefined

Builds

列出项目的构建记录

Builds are first-class primitives that track image construction from input (spec) to execution (run) to output (artifacts).
bash
undefined
eve build list [--project <id>]

List builds for a project

查看构建规格详情

eve build list [--project <id>]
eve build show <build_id>

Show build spec details

启动构建运行

eve build show <build_id>
eve build run <build_id>

Start a build run

列出构建的运行记录

eve build run <build_id>
eve build runs <build_id>

List runs for a build

查看构建日志

eve build runs <build_id>
eve build logs <build_id> [--run <run_id>]

View build logs

列出生成的镜像制品（摘要）

eve build logs <build_id> [--run <run_id>]
eve build artifacts <build_id>

List produced image artifacts (digests)

完整诊断信息导出（规格+运行记录+制品+日志）

eve build artifacts <build_id>
eve build diagnose <build_id>

Full diagnostic dump (spec + runs + artifacts + logs)

取消活跃的构建

eve build diagnose <build_id>
eve build cancel <build_id>

构建会在流水线的`build`步骤中自动触发。使用`eve build diagnose`调试构建失败问题。

Cancel an active build

系统健康

eve build cancel <build_id>

Builds happen automatically during pipeline `build` steps. Use `eve build diagnose` to debug build failures.
bash
eve system health

System Health

Harness（可选）

bash
eve system health
bash
eve harness list
eve harness list --capabilities
eve harness get mclaude
eve agents config --json

Harnesses (Optional)

注意事项

bash
eve harness list
eve harness list --capabilities
eve harness get mclaude
eve agents config --json
  • 若未在配置文件中设置默认项目，请使用
    --project
    参数。
  • 任务命令优先使用
    eve job ...
    （单数形式）。

Notes

—
  • Use 
    --project
    if no default project is set in the profile.
  • Prefer 
    eve job ...
    (singular) for job commands.
—