@redredchen01/foundry-cli

Unified CLI entry point for Skill Foundry v2 — developer toolkit

Install

npm install -g @redredchen01/foundry-cli

Quick Start

foundry list                         # list all installed skills
foundry help                         # show full help
foundry version                      # show version
foundry dep-audit outdated           # dispatch to dep-audit skill
foundry git-workflow branches        # dispatch to git-workflow skill

Commands

| Command | Description | |---------|-------------| | list | List installed skills with versions and command counts | | version | Show Foundry CLI version | | help | Show help with all discovered skills | | <skill> <command> | Dispatch to a specific skill's command |

Plugin Discovery

Skills are discovered by scanning sibling packages for a SKILL.md marker file. No manual registration is needed — install a new skill package and foundry detects it automatically.

Options

| Option | Description | |--------|-------------| | --json | JSON output (pipe protocol) | | --verbose | Verbose logging | | --quiet | Suppress info messages |

Architecture

foundry-cli is the top-level dispatcher in Skill Foundry v2. It:

1. Scans ../*/SKILL.md for installed skills (excluding cli-core and foundry-cli itself)
2. Routes foundry <skill> <args> to ../<skill>/bin/<skill>.sh
3. Built-in commands (list, version, help) are handled directly

License

MIT