Skip to content

CLI Overview

Mel edited this page Nov 10, 2026 · 1 revision

The CLI source repo (escacs/stack) is private; these pages describe the stack CLI used by the app.

The escacs stack is the shared library for every escacs project: agent skills, styles, systems, components, imported libraries, assets, templates and worker profiles. It is built to be read by agents. Everything is plain files with a generated index they can search.

The stack is a library, not a framework: parts are imported into a project when it needs them. Nothing is active by default. Only two helpers are installed per user (the escacs-stack skill and create-agents-md). Everything else is imported per project.

The CLI is one file, tools/stack/cli.mjs, plus modules in the same folder. It has no dependencies. package.json sets engines.node to >= 22.

Run it

From a clone of the stack:

node tools/stack/cli.mjs help

Or put the clone's bin/ on PATH and use stack. bin/stack is a small shell wrapper that runs the same file with node, following symlinks, so it works from any directory:

export PATH="/path/to/stack/bin:$PATH"
stack --version

package.json also defines npm scripts: npm run stack, npm run catalog, npm run check and npm run web (which runs stack serve). The examples in this wiki use stack.

Flag reference: stack help <command>. The --json shapes: stack help json.

Pages

Full CLI guide in the repo: https://github.com/escacs/stack/blob/main/docs/cli.md (private repo). Output blocks below are copied from real runs, with long lines and repeated rows cut and marked ....

See also: CLI Quick Tour, CLI Output Modes, CLI Discover.

Clone this wiki locally