The Command Atlas
This atlas tells you where to look. Every command supports --help; the
chapters linked alongside it explain the judgment behind the flags.
Everyday Tool Work
| Command | Purpose |
|---|---|
cmdforge list | List tools; use --json --filter QUERY --limit N for machine discovery. |
cmdforge create | Create a personal tool or use --project/--output-dir. |
cmdforge edit, cmdforge delete, cmdforge docs | Maintain an installed tool and its README. |
cmdforge run | Execute with input, provider, privacy, fallback, and provenance controls. |
cmdforge run-once | Use a provider for an ad-hoc prompt without creating YAML. |
cmdforge test | Exercise a tool with the mock provider. |
cmdforge inspect | Run deterministic preflight and optionally save a baseline. |
cmdforge optimize | Generate and evaluate prompt variations. |
cmdforge ui | Open the interactive desktop application. |
cmdforge refresh, cmdforge check | Regenerate wrappers and check tool dependencies. |
Discovery and Registry
cmdforge registry contains search, tags, install,
uninstall, info, update, publish,
signing-key, improve, review-improvement,
update-readme, describe, my-tools, status,
browse, and administrative config.
cmdforge collections groups curated tools. The cf executable provides an interactive
local picker whose UI stays on stderr so stdout remains pipeable.
Providers and Settings
cmdforge providers contains list, check, install,
discover, add, remove, test, and
for-tools. cmdforge config manages global CmdForge preferences;
cmdforge settings manages per-tool values; cmdforge system-deps handles OS packages declared by tools.
Reproducible Projects
| Command | Purpose |
|---|---|
cmdforge init | Create cmdforge.yaml. |
cmdforge add, cmdforge remove | Change declared project tool dependencies. |
cmdforge deps, cmdforge install | Inspect and install the manifest. |
cmdforge lock | Resolve and record immutable dependency identities. |
cmdforge verify | Compare installed content with the lock file. |
MCP and Agents
cmdforge mcp contains serve, list, connect,
configure, add, and remove. See
MCP: Tools Without Islands before exposing a broad pattern or
binding an HTTP server beyond loopback.
Local Workflow Discovery
cmdforge usage enable|disable|status|clear|suggestions controls opt-in, local-only pipeline
pattern recording. No usage content is sent to the registry.
Strict Execution Flags
cmdforge run TOOL --no-fallback --require-local --require-capability structured-json --data-classification private --require-model-identity --require-model-digest --result-envelope jsonRun cmdforge COMMAND --help and cmdforge COMMAND SUBCOMMAND --help for the
installed version's exact options.
Important Files
| Path | Purpose |
|---|---|
~/.cmdforge/providers.yaml | Provider definitions and policies |
~/.cmdforge/mcp.yaml | MCP client servers and MCP exposure policy |
~/.cmdforge/NAME/ | Personal tools |
./.cmdforge/NAME/ | Project-owned tools |
cmdforge.yaml, cmdforge.lock | Project manifest and resolved identities |
~/.cmdforge/usage.json | Opt-in local pipeline patterns |