codepotx-cli

codepotx-cli exposes the codepotx terminal command. It owns argument parsing, project discovery, runtime loading, terminal presentation, and exit codes. The codepotx package owns authoring, template compilation, generation planning, filesystem safety, diagnostics, events, and execution.

The package is under active development with version 0.0.0. It is documented here as the implemented workspace CLI, not as a stable published npm release.

Why the CLI stays thin

This boundary prevents terminal behavior from becoming a second engine. Web, editor, MCP, desktop, test, and embedded clients can call the same runtime operations.

Main commands

Learning path

1. Getting started
2. Command reference
3. Global and command options
4. Project-local runtime resolution
5. JSON output and automation
6. Troubleshooting

Package boundaries

New compiler, authoring, templating, generation, platform, or safety behavior belongs in codepotx. The CLI may translate user input into runtime requests and render runtime responses; it must not duplicate domain logic.

Development

The package is ESM-only and targets Node.js 22.18 or newer.