Skip to content

CLI reference

The themarch binary ships with six commands and a handful of global flags.

FlagPurpose
-v, --versionprint the CLI version
--dry-runsimulate, do not apply
--verboseextra logs
--no-promptnon-interactive (use defaults / fail if a required input is missing)
--config <path>custom config file (currently a no-op stub)

Scaffold a new project from a template.

Terminal window
themarch init my-app --template saas-b2b
themarch init lib-x --template lib --no-install --no-git

Flags: -t/--template, --features <list>, --install/--no-install, --git/--no-git, --docker/--no-docker.

Add the themarch workflow to an existing repo without breaking anything.

Terminal window
themarch enhance .
themarch enhance . --with cursorrules,claude-md --no-prompt

The mapping from inferredStackProfile to file variants is:

ProfileCursor rulesCLAUDE.md
saas-b2bconfigs/cursorrules/saas-b2b.mdconfigs/claude-md/saas-b2b.md
api-onlyconfigs/cursorrules/api-only.mdconfigs/claude-md/api-only.md
libconfigs/cursorrules/library.mdconfigs/claude-md/library.md
unknownconfigs/cursorrules/generic.mdconfigs/claude-md/generic.md

Orchestrate skills to scaffold a feature end-to-end.

Terminal window
themarch add-feature items # dry-run preview
themarch add-feature items --apply # actually write
themarch add-feature items --with-table --with-rls --apply
themarch add-feature items --apply --continue-on-error

If the working tree is dirty, the CLI offers to stash. On per-skill failure (without --continue-on-error), partial writes are stashed under themarch:add-feature:rollback:<feature>.

themarch skill list / themarch skill run <name>

Section titled “themarch skill list / themarch skill run <name>”
Terminal window
themarch skill list
themarch skill run add-table --input tableName=invoices
Terminal window
themarch mcp list
themarch mcp add postgres-local --target cursor
themarch mcp add skills --target claude-code
themarch mcp remove knowledge --target cursor

Targets resolve to OS-aware paths. macOS / Linux / Windows are all supported.

Refreshes the local skills catalog. Currently a stub — the catalog ships with the CLI binary.