Simple CLI Skill

1. Global Usage

simple <command> <subcommand> [args] [flags]

2. Scaffolding Commands

simple new app

Scaffold a new empty application structure.

• Usage: simple new app <app-id> <name>
• Args:
  • <app-id>: Unique identifier (e.g., com.acme.crm).
  • <name>: Human-readable display name (e.g., "Customer CRM").
• Flags:
  • --desc <string>: Application description.

simple new action

Create a new action, in TypeScript or in Rust, with boilerplate that builds and tests as written.

• Usage: simple new action <app-id> <name> <display-name>
• Args:
  • <app-id>: Target App ID.
  • <name>: Action name in kebab-case (e.g., calculate-tax).
  • <display-name>: Human readable label.
• Flags:
  • --lang <string>: Action language (ts, rust). Defaults to ts.
  • --scope <string>: NPM package scope (e.g., acme). REQUIRED for --lang ts. A Rust action is a cargo crate named after the action itself and is never published to a registry, so it takes no scope.
  • --env <string>: Execution environment (server, client, both). Defaults to server.
  • --desc <string>: Description of the logic.

simple new behavior

Create a client-side record behavior script.

• Usage: simple new behavior <app-id> <table-name>
• Args:
  • <app-id>: Target App ID.
  • <table-name>: The table this behavior attaches to.

simple new space

Scaffold a new custom React Space.

• Usage: simple new space <app-id> <name> <display-name>
• Args:
  • <app-id>: Target App ID (e.g., com.acme.crm).
  • <name>: Space name in kebab-case (e.g., sales-dashboard).
  • <display-name>: Human readable label.
• Flags:
  • --desc <string>: Description of the space.

simple new trigger:db

Create a database event trigger.

• Usage: simple new trigger:db <app-id> <name> <display-name>
• Args:
  • <app-id>: Target App ID.
  • <name>: Trigger name (snake_case).
  • <display-name>: Human readable label.
• Flags:
  • --table <string>: REQUIRED Table to watch.
  • --ops <string>: Operations to watch: insert, update, delete (comma-separated, default: insert).
  • --action <string>: Action to execute.
  • --condition <string>: JQ condition filter.
  • --desc <string>: Description.

simple new trigger:timed

Create a scheduled timed trigger.

• Usage: simple new trigger:timed <app-id> <name> <display-name>
• Args:
  • <app-id>: Target App ID.
  • <name>: Trigger name (snake_case).
  • <display-name>: Human readable label.
• Flags:
  • --frequency <string>: minutely|hourly|daily|weekly|monthly|yearly.
  • --interval <int>: Interval between runs (default: 1).
  • --start-at <string>: Start time (ISO8601).
  • --time <string>: Time of day (HH:MM:SS) (default: "00:00:00").
  • --timezone <string>: Timezone (default: "UTC").
  • --days <string>: Specific days (MON,TUE...).
  • --action <string>: Action to execute.
  • --desc <string>: Description.

simple new trigger:webhook

Create an HTTP webhook trigger.

• Usage: simple new trigger:webhook <app-id> <name> <display-name>
• Args:
  • <app-id>: Target App ID.
  • <name>: Trigger name (snake_case).
  • <display-name>: Human readable label.
• Flags:
  • --method <string>: HTTP method: get|post|put|delete (default: post).
  • --public: Make endpoint public (no auth).
  • --action <string>: Action to execute.
  • --desc <string>: Description.

3. Development Commands

simple build

Compile all SCL files, Actions (WASM), and Spaces (Vite/React).

• Usage: simple build [target]
• Args:
  • [target] (Optional): Specific app (com.acme.crm) or action (com.acme.crm/my-action) to build.
• Flags:
  • --all: Build all actions in all apps.
  • --concurrency <int>: Number of parallel builds (default: 4).
• Description: Validates schema integrity, transpiles TypeScript to WASM, and bundles spaces.

simple install

Install a deployed app to an environment (migrations, cache warming).

• Usage: simple install <app-id>
• Args:
  • <app-id>: App ID to install (must be already deployed).
• Flags:
  • --env <string>: REQUIRED. Target environment (dev, staging, prod).
  • --progress <string>: auto (default), tty or plain. Use plain for one line per step when capturing output.
  • --json: Print one JSON document on stdout; errors go to stderr as {"error": ...}.

simple test

Run the unified test runner. Each target is handed to its own runner: Vitest for TypeScript and JavaScript, cargo test for Rust actions.

• Usage: simple test [app-id]
• Args:
  • [app-id] (Optional): Limit tests to a specific app.
• Flags:
  • --action <string>: Run tests for a specific action only.
  • --behavior <string>: Run tests for a specific behavior script only.
  • --space <string>: Run tests for a specific space only.
  • --coverage: Enable code coverage reporting.
  • --json: Output results in JSON format (CI/CD friendly).

4. Operational Commands

simple deploy

Deploy application artifacts to a remote environment.

• Usage: simple deploy <app-path>
• Args:
  • <app-path>: Path to the app directory (e.g., apps/com.acme.crm).
• Flags:
  • --env <string>: REQUIRED. Target environment (dev, staging, prod).
  • --bump <string>: Semver bump strategy (patch, minor, major).
  • --no-install: Publish the version without installing it; install it later with simple install <app-id> --env <env>.
  • --dry-run: Show the next version and the files that would be uploaded. Nothing is written or uploaded: no sign-in, no connection, app.scl unchanged.
  • --progress <string>: auto (default), tty or plain. Use plain for one line per step when capturing output.
  • --json: Print one JSON document on stdout; errors go to stderr as {"error": ...}. An install that fails after the publish still exits 1.
• Output: One line per step ([n/N] ✓ Step: detail (duration)) when not on a terminal. Success ends with ✅ Deployed <app-id>@<version> (Installed) in <duration>. After a failure or Ctrl+C, the lines before the error say what was left behind (a bumped app.scl, a publish or install the server may still finish) and what to run next.

simple init

Initialize a new workspace (Monorepo).

• Usage: simple init <project-name>
• Args:
  • <project-name>: Name of the root directory to create.
• Flags:
  • --tenant <string>: Tenant name for simple.scl configuration.