CLI Overview#
MonoForge includes a standalone executable CLI tool at bin/monoforge.js. It requires zero external dependencies and runs anywhere with Node.js 18+.
You can run it locally with:
BASH
Or via pnpm:
BASH
Command: `monoforge list`#
Lists all available visual archetypes with their category, accent color, and ID:
BASH
Example Output:#
TEXT
Command: `monoforge generate`#
Compiles a complete, Camo-compliant GitHub Profile README file directly to disk:
BASH
Flags & Options:#
| Flag | Short | Description | Default |
|---|---|---|---|
--username | -u | GitHub username for telemetry cards | octocat |
--archetype | -a | Archetype ID from monoforge list | wow-3d-city-cat |
--name | -n | Custom display name | Optional |
--role | -r | Custom headline / role | Optional |
--output | -o | Output filepath (pass - for stdout) | README.md |
Command: `monoforge skill-install`#
Installs the MonoForge AI Agent skill files into any target repository or workspace:
BASH
Command: `monoforge mcp` (Model Context Protocol)#
Starts the stdio JSON-RPC MCP server for direct integration with AI coding assistants (such as Antigravity, Claude Code, or Cursor):
BASH
Exposes MCP tools:
list_archetypes: Returns full archetype schemas and descriptions.generate_profile_readme: Generates deterministic GFM markdown profiles on demand.