eve-new-project-setup

SKILL.md

Eve New Project Setup

Use this after a developer has run eve init and needs to configure the project for Eve Horizon.

Context

The user has already run:

npm install -g @eve-horizon/cli
eve init my-project
cd my-project

This skill handles the remaining setup: profile, authentication, org/project registration, manifest customization, and git remote configuration.

Step 1: Verify CLI
eve --version

If this fails, the CLI wasn't installed. Have them run:

npm install -g @eve-horizon/cli

Step 2: Profile Setup

Create a profile for the staging environment:

eve profile create staging --api-url https://api.eh1.incept5.dev
eve profile use staging

Ask the user for their email and set defaults:

eve profile set --default-email user@example.com

Step 3: Authentication

Check current auth status:

eve auth status

If not authenticated, log in:

eve auth login

The CLI will guide them through SSH key discovery (can fetch from GitHub if needed).

We'll set harness credentials after project creation.

Step 4: Org + Project

Ask the user for:

Organization name (e.g., "my-company")

Project name (e.g., "My App")

Project slug (e.g., "my-app")

Repo URL (e.g., "git@github.com:me/my-app.git")

Create or ensure they exist:

eve org ensure my-company --slug myco
eve project ensure --name "My App" --slug my-app --repo-url git@github.com:me/my-app.git --branch main

URL impact: The org and project slugs directly form deployment URLs and K8s namespaces:

URL: {service}.{orgSlug}-{projectSlug}-{env}.{domain} (e.g., api.myco-my-app-staging.eh1.incept5.dev)

Namespace: eve-{orgSlug}-{projectSlug}-{env} (e.g., eve-myco-my-app-staging)

${ORG_SLUG} is available for interpolation in manifest values

Slugs are immutable — choose short, meaningful values.

Set as defaults in the profile:

eve profile set --org org_xxx --project proj_xxx

Step 5: Choose Harness + Set API Keys

Ask which harness they want to target (can be more than one):

mclaude / claude (Anthropic)

code / codex (OpenAI)

zai (Z.ai)

gemini (Google)

Map harnesses to required secrets:

mclaude/claude: ANTHROPIC_API_KEY (preferred) or Claude OAuth via eve auth sync

code/codex: OPENAI_API_KEY (preferred) or CODEX_AUTH_JSON_B64

zai: Z_AI_API_KEY

gemini: GEMINI_API_KEY (or GOOGLE_API_KEY)

Decide where to store secrets:

Org (recommended) for shared keys across projects

Project for app-specific keys

User for personal keys

Use a secrets file for batch setup (starter repo includes secrets.env.example):

cp secrets.env.example secrets.env
eve secrets import --org org_xxx --file ./secrets.env

For Claude/Codex OAuth tokens on the host:

# Store OAuth tokens in the project scope (or add --system if admin)
eve auth sync --project proj_xxx

Step 6: Manifest Configuration

The starter template includes .eve/manifest.yaml. Update it with the project details:

schema: eve/compose/v2
project: my-app

services:
  api:
    build:
      context: apps/api
    ports: [3000]
    x-eve:
      ingress:
        public: true
        port: 3000

environments:
  staging:
    pipeline: deploy

pipelines:
  deploy:
    steps:
      - name: deploy
        action: { type: deploy }

Key fields to customize:

project: Match the project slug

services: Define your app's services

x-eve.ingress: Configure public access

Step 7: Git Remote

The project starts with no remote. Help set one up:

git remote -v
git remote add origin git@github.com:user/my-app.git
git push -u origin main

Step 8: Verification

Run these checks to confirm setup:

eve system health
eve auth status
eve profile show

Next Steps

After setup is complete, suggest:

Run locally: docker compose up --build

Set secrets: eve secrets set MY_KEY "value" or eve secrets import --file ./secrets.env

Deploy to staging: eve env deploy staging --ref main --repo-dir .

Create a job: eve job create --prompt "Review the codebase"

Note: If the environment has a pipeline configured in the manifest, eve env deploy <env> --ref <sha> will trigger that pipeline. Use --direct to bypass the pipeline and do a direct deploy. --ref must be a 40-character SHA, or a ref resolved against --repo-dir/cwd.

Troubleshooting

"eve: command not found"

npm install -g @eve-horizon/cli

"Not authenticated"

eve auth login

"No profile"

eve profile create staging --api-url https://api.eh1.incept5.dev

1d