eve-cli-primitives

Eve CLI プリミティブ

Eve のコマンドマップとしてこのスキルを使用してください。例は短く具体的にしてください。

プロファイル（API ターゲット＋デフォルト設定）

# Create and use a profile
eve profile create staging --api-url https://api.eve.example.com
eve profile use staging

# Set defaults to avoid repeating flags
eve profile set --default-email [email protected] --default-ssh-key ~/.ssh/id_ed25519
eve profile set --org org_xxx --project proj_xxx

# Inspect current profile
eve profile show

認証

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>"}

組織とプロジェクト

eve org list
eve org ensure my-org --slug myorg

eve project list
eve project ensure --name "My App" --slug my-app --repo-url [email protected]:me/my-app.git --branch main

# Membership management
eve org members --org org_xxx
eve org members add [email protected] --role admin --org org_xxx
eve org members remove user_abc --org org_xxx

eve project members --project proj_xxx
eve project members add [email protected] --role admin --project proj_xxx
eve project members remove user_abc --project proj_xxx

URL への影響： 組織の --slug とプロジェクトの --slug は、デプロイ URL と K8s 名前空間を直接構成します。

• URL：{service}.{orgSlug}-{projectSlug}-{env}.{domain}（例：api.myorg-my-app-staging.eve.example.com）
• 名前空間：eve-{orgSlug}-{projectSlug}-{env}（例：eve-myorg-my-app-staging）

スラッグは慎重に選んでください。作成後は変更できません。

環境とデプロイ

# 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 diagnose proj_xxx staging --request <req_id>     # request-level integrated diagnose
eve env logs proj_xxx staging <service>
eve env logs proj_xxx staging <service> --follow         # stream logs
eve env logs proj_xxx staging <service> --filter route=/api/x --filter status=500
eve env delete proj_xxx staging

--filter k=v は繰り返し指定できます。よく使うキーは route、status、level、request_id です。自由形式のテキスト検索には --grep を使用し、対象期間は --since／--tail で指定してください。

ジョブ（作成＋監視）

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>

# Per-job harness + env overrides (Eden-style per-request brain selection)
eve job create --description "..." \
  --harness-override-file ./profile.json \
  --env-override OPENAI_API_KEY='${secret.OPENAI_KEY}' \
  --env-override MODEL_ENDPOINT=https://qwen.local

--harness-override-file には、JSON オブジェクト {harness, model?, reasoning_effort?, variant?, temperature?} を指定します。--env-override KEY=VALUE は繰り返し指定でき、UPPER_SNAKE_CASE のキーを検証し、起動時に解決される ${secret.KEY} の補間をサポートします。

調整（監督＋スレッド）

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>

エージェント＋チャット

# 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

パック（AgentPacks）

eve packs status
eve packs resolve --dry-run
eve migrate skills-to-packs

Slack ゲートウェイコマンド（Slack 内で実行）：

@eve <agent-slug> <command>
@eve agents list
@eve agents listen <agent-slug>
@eve agents unlisten <agent-slug>
@eve agents listening

Nostr コマンド（プラットフォームの公開鍵への DM 経由）：

/agent-slug command text
agent-slug: command text

シークレット

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 env-health --json
eve system env-cost --all
eve system logs api --tail 50
eve system pods
eve system events

eve system env-cost は、管理者 API から当月の環境割り当てスナップショットを返します。これはスナップショット表示であり、OpenCost のライブクエリではありません。古い推定値や利用できない推定値は、出力内でその旨が示されます。

ワークフロー

eve workflow list
eve workflow run qa-review --input '{"task":"audit"}'
eve workflow invoke qa-review --input '{"task":"audit"}'
eve workflow run qa-review --input '{...}' --env-override MODEL=opus-4.5
eve workflow logs job_abc123

--env-override KEY=VALUE は run と invoke で繰り返し指定でき、各ステップのジョブに env_overrides として渡されます。

インテグレーション（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>", ...}

パイプラインとワークフロー

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"}' [--env-override KEY=VALUE]
eve workflow invoke <project> <name> --input '{"k":"v"}' [--env-override KEY=VALUE] [--no-wait]
eve workflow logs <job-id>

ビルド

ビルドは、入力（仕様）から実行（run）、出力（アーティファクト）までのイメージ構築を追跡する、一級のプリミティブです。

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

パイプラインの build ステップでは、ビルドが自動的に行われます。ビルドの失敗をデバッグするには、eve build diagnose を使用してください。

トレース（OTEL）

エージェントがクエリ可能なトレースストアです。エンドツーエンドのリクエスト調査には、eve env diagnose --request <id> および eve env logs --filter request_id=<id> と組み合わせてください。

eve traces query --request-id <id>                    # spans for a single request
eve traces query --trace-id <id>                      # spans for a known trace
eve traces query --service api --since 15m --error    # recent errors in a service
eve traces query --route /api/projects --p99          # p99 latency for a route
eve traces query --request-id <id> --json             # machine-readable

--request-id、--trace-id、--since、--route、--error のいずれかが必須です。--no-cache はトレースキャッシュをバイパスします。

カスタムドメイン

eve domain list [--env <name>] [--project <id>]
eve domain verify <hostname>             # check DNS and show activation status
eve domain status <hostname>             # show domain status and owning env
eve domain transfer <hostname> --to <env>  # move ownership between envs
eve domain unbind <hostname>             # clear binding so next deploy claims it
eve domain remove <hostname>             # delete the domain entirely

システムの健全性

eve system health

ハーネス（任意）

eve harness list
eve harness list --capabilities
eve harness get mclaude
eve agents config --json

メモ

• プロファイルでデフォルトのプロジェクトが設定されていない場合は、--project を使用してください。
• インテグレーションは組織スコープです。インテグレーションコマンドでは --org を使用してください。
• ジョブコマンドには、eve job ...（単数形）を優先して使用してください。