CLI Reference
Scaffold. Deploy. Manage. All from the terminal.
The EEv3 CLI gives you full control over your projects, deployments, tokens, and logs — without leaving the terminal.
Install
$ npm install -g @evileye/cliee init
Scaffold a new EEv3 project with TypeScript config, SDK setup, and directory structure.
Syntax
ee init [project-name] [--template <template>]Flags
--template <name> Starter template (default, api, fullstack, minimal)
--no-git Skip git initialization
--package-manager Use npm, yarn, or pnpm (auto-detected)
$ ee init my-saas --template fullstack
✓ Created project directory
✓ Installed @evileye/sdk
✓ Generated tsconfig.json
✓ Created src/lib/ee.ts with client setup
✓ Added .env.example with required variables
→ cd my-saas && npm run devee dev
Start a local development server with hot reload, SDK proxy, and sandbox mode.
Syntax
ee dev [--port <port>] [--open]Flags
--port <number> Dev server port (default: 3000)
--open Open browser on start
--no-proxy Disable local SDK proxy
$ ee dev --port 4000
✓ SDK proxy running on localhost:4000/api
✓ Sandbox mode enabled (no billing)
✓ Hot reload active
→ Watching for changes...ee deploy
Deploy your project to EEv3 hosting. Builds, optimises, and pushes to the edge.
Syntax
ee deploy [--env <environment>] [--force]Flags
--env <name> Target environment (staging, production)
--force Skip confirmation prompt
--no-build Deploy without rebuilding
$ ee deploy --env production
✓ Building project...
✓ Optimising assets (247kb → 89kb)
✓ Deploying to edge (12 regions)
✓ SSL certificate provisioned
→ https://my-saas.evileye.devee faces
List all available face modules with method counts and descriptions.
Syntax
ee faces [--filter <pattern>] [--json]Flags
--filter <text> Filter faces by name or category
--json Output as JSON
--methods Show all methods for each face
$ ee faces --filter ai
┌──────────┬─────────┬──────────────────────────────────┐
│ Face │ Methods │ Description │
├──────────┼─────────┼──────────────────────────────────┤
│ ee.ai │ 12 │ Inference, embeddings, vision... │
└──────────┴─────────┴──────────────────────────────────┘ee generate
Generate TypeScript types from your entity schema and face configurations.
Syntax
ee generate [--output <path>] [--watch]Flags
--output <path> Output directory (default: src/generated)
--watch Re-generate on schema changes
--faces <list> Only generate types for specific faces
$ ee generate --watch
✓ Connected to entity schema
✓ Generated types for 42 faces
✓ Written to src/generated/ee.d.ts
→ Watching for schema changes...ee logs
Tail production logs in real-time with filtering and search.
Syntax
ee logs [--face <face>] [--level <level>] [--since <time>]Flags
--face <name> Filter by face module
--level <level> Filter by log level (info, warn, error)
--since <time> Show logs since (1h, 30m, 2024-01-01)
--follow Stream new logs in real-time
$ ee logs --face ai --level error --follow
[2024-03-15 14:23:01] ERROR ai.generate - Rate limit exceeded
→ retryAfter: 2000ms, requestId: req_abc123
[2024-03-15 14:23:04] ERROR ai.embed - Model unavailable
→ model: text-embedding-3, fallback: text-embedding-2ee status
Check the operational status of all EEv3 services and your entity.
Syntax
ee status [--json] [--watch]Flags
--json Output as JSON
--watch Refresh every 30 seconds
$ ee status
┌───────────────┬────────────┬───────────┐
│ Service │ Status │ Latency │
├───────────────┼────────────┼───────────┤
│ Conductor │ ✓ Healthy │ 12ms │
│ AI │ ✓ Healthy │ 45ms │
│ Storage │ ✓ Healthy │ 8ms │
│ Database │ ✓ Healthy │ 5ms │
│ Auth │ ✓ Healthy │ 11ms │
└───────────────┴────────────┴───────────┘
Entity: acme-corp | Region: us-east-1 | Uptime: 99.99%ee token create
Create a new scoped API token from the terminal.
Syntax
ee token create [--face <face>] [--expires <duration>]Flags
--face <name> Scope to a specific face (repeatable)
--expires <time> Token expiry (30d, 90d, 1y, never)
--name <label> Human-readable label for the token
$ ee token create --face billing --face storage --expires 90d --name "payment-service"
✓ Token created
Name: payment-service
Key: sk_acme-corp_billing+storage_a1b2c3d4
Scopes: billing, storage
Expires: 2024-06-15T00:00:00Z
⚠ Store this key securely — it won't be shown again.Global Flags
Available on every command.
| Flag | Description |
|---|---|
| --entity <id> | Override the default entity for this command |
| --env <name> | Target environment (development, staging, production) |
| --verbose | Show detailed output including request/response logs |
| --json | Output as JSON (useful for piping to other tools) |
| --no-color | Disable colored output |
| --version | Print CLI version |
| --help | Show help for any command |
Start from the terminal.
Install the CLI and scaffold your first project in seconds.