Spec ADE CLI

Spec ADE is a full-stack GUI for AI coding assistants. This npm package installs the spec-ade command and downloads the matching native binary package for your platform.

Quick View

• ACP/agent chat workspace with streamed session output.
• File tree, editor panes, project state, and session management in one GUI.
• Integrated terminal and task-oriented workflows backed by the Rust API.
• Plan workspace for plans/<slug>/plan.md and plans/<slug>/tasks.md, including a plan-edit agent panel and handoff to an implementation agent.
• Git status, staging, commit-message workflow, and worktree overview.
• Context Engine workspace for repo-aware code questions and indexing.
• Design workspace for generating app/product prototypes.
• Database workspace for SQL and NoSQL drivers, inline edits, safe mode, backup/restore, ER diagrams, and import helpers.

Screenshots

ACP agent chat

File tree and editor

Terminal workflow

Plan workspace

Git workflow

Context Engine

Design workspace

Database workspace

Install

npm install -g @spec-ade/cli

Then run:

spec-ade

You can also run it without a global install:

npx @spec-ade/cli

Runtime

• Requires Node.js >=18.
• The npm wrapper selects the native binary package for the current platform.
• If no port is supplied, the wrapper starts Spec ADE with --port 4123.
• To choose a port, pass --port, -p, or set SPEC_ADE_PORT.

Examples:

spec-ade --port 4123
SPEC_ADE_PORT=4200 spec-ade

On Windows PowerShell:

$env:SPEC_ADE_PORT = '4200'
spec-ade

Supported Platforms

The current npm wrapper supports:

| Platform | Package | | --- | --- | | Linux x64 | @spec-ade/cli-linux-x64 | | Linux ARM64 | @spec-ade/cli-linux-arm64 | | macOS ARM64 | @spec-ade/cli-darwin-arm64 | | Windows x64 | @spec-ade/cli-win32-x64 |

Troubleshooting

Missing binary package

If installation used --no-optional, npm may skip the platform binary package. Reinstall with optional dependencies enabled:

npm install -g @spec-ade/cli

Unsupported platform

If spec-ade prints Unsupported platform, your OS/CPU pair is not mapped by this npm wrapper yet. The supported platform keys are:

linux-x64
linux-arm64
darwin-arm64
win32-x64