@engine-ai/cli

Scaffold and validate Engine strategy bundles from your terminal.

A strategy is a folder of markdown — a STRATEGY.md constitution plus optional endpoints.yaml, tools.yaml, and references/. This CLI gets that folder started and checks it before you upload it to the Engine app to publish.

Install

npm i -g @engine-ai/cli

Or run without installing:

npx @engine-ai/cli strategy validate

Commands

engine strategy create [name]

Scaffold a new strategy folder. Runs interactively by default:

engine strategy create my-strategy

Or skip the prompts with flags:

engine strategy create my-strategy \
  --name "Crowded Short Fade" \
  --description "Fades crowded shorts on majors when funding is deeply negative." \
  --tags "momentum, crypto" \
  --with-endpoints \
  --yes

| Flag | Description | | --- | --- | | --name <name> | Strategy display name | | --description <text> | One-line description | | --tags <a,b,c> | Comma-separated marketplace tags (max 8) | | --with-endpoints | Include endpoints.yaml (data sources) | | --with-tools | Include tools.yaml (callable tools) | | --yes | Non-interactive; use flags + defaults | | --force | Scaffold into a non-empty directory |

engine strategy validate [path]

Validate a strategy bundle, fully offline. Defaults to the current directory.

cd my-strategy
engine strategy validate

Warnings are fine (exit 0); errors exit 1. Add --json for machine-readable output on stdout (useful in CI):

engine strategy validate --json

Publishing

The CLI gets your folder ready — publishing happens in the Engine app: open the strategy editor, Import folder, enter any required secrets, choose public/private, and publish.

Workflow

engine strategy create my-strategy   # scaffold
cd my-strategy
# edit STRATEGY.md to make it yours
engine strategy validate             # check it's clean
# then upload the folder in the Engine app