Summary
While auditing the Frigg CLI surface (packages/devtools/frigg-cli/) for a downstream skill that drives agent-led integration creation, I found two kinds of drift between the documented CLI in the repo's CLAUDE.md and what the CLI actually implements:
- A documented command that doesn't exist.
- Several implemented commands that aren't documented.
This makes it hard for agents (and humans reading CLAUDE.md) to use the CLI correctly — agents will either try to invoke a non-existent command, or re-implement scaffolding the CLI already does.
Documented but not implemented
frigg search — CLAUDE.md lists it, but packages/devtools/frigg-cli/index.js has no search subcommand. There's no search-command/ directory either. Either the command needs to be implemented, or the docs should drop the reference and point users at npm search @friggframework/api-module- / the friggframework/api-module-library repo instead.
Implemented but not documented
All of these are wired up in packages/devtools/frigg-cli/index.js with full option sets, but I couldn't find them in CLAUDE.md:
| Command |
What it does |
frigg build |
Serverless packaging via osls (osls package --config infrastructure.js --stage <stage>). Local default; --production enables AWS discovery. |
frigg generate-iam |
CloudFormation IAM templates. Multi-cloud generators present (terraform-generator.js, azure-generator.js, gcp-generator.js). |
frigg ui |
Launch the Frigg Management UI (default port 3210). |
frigg doctor [stackName] |
CloudFormation stack health check (--format console|json, --output <file>). |
frigg repair <stackName> |
Drift reconciliation / orphaned-resource recovery (--import, --reconcile, --mode template|resource). |
frigg auth list / get / delete |
Credential management beyond frigg auth test — listed in CLAUDE.md is only frigg auth test <module>. |
Suggested fix
Update CLAUDE.md's CLI section to:
- Drop
frigg search (or implement it).
- Add a row per undocumented command above with the same brief / option summary used for the documented commands.
- Optionally, add a one-line pointer to
packages/devtools/frigg-cli/index.js so the docs stay locatable when commands evolve.
Happy to open a PR with the docs update if useful — flagging this first so the team can decide whether frigg search should be implemented (and what its scope is) before the docs are aligned.
Found while building an agent-driven integration creation skill for Lefthook's Frigg projects; the skill needs an accurate command map to pick the right CLI invocation rather than re-implementing scaffolding.
Summary
While auditing the Frigg CLI surface (
packages/devtools/frigg-cli/) for a downstream skill that drives agent-led integration creation, I found two kinds of drift between the documented CLI in the repo'sCLAUDE.mdand what the CLI actually implements:This makes it hard for agents (and humans reading
CLAUDE.md) to use the CLI correctly — agents will either try to invoke a non-existent command, or re-implement scaffolding the CLI already does.Documented but not implemented
frigg search—CLAUDE.mdlists it, butpackages/devtools/frigg-cli/index.jshas nosearchsubcommand. There's nosearch-command/directory either. Either the command needs to be implemented, or the docs should drop the reference and point users atnpm search @friggframework/api-module-/ thefriggframework/api-module-libraryrepo instead.Implemented but not documented
All of these are wired up in
packages/devtools/frigg-cli/index.jswith full option sets, but I couldn't find them inCLAUDE.md:frigg buildosls package --config infrastructure.js --stage <stage>). Local default;--productionenables AWS discovery.frigg generate-iamterraform-generator.js,azure-generator.js,gcp-generator.js).frigg uifrigg doctor [stackName]--format console|json,--output <file>).frigg repair <stackName>--import,--reconcile,--mode template|resource).frigg auth list / get / deletefrigg auth test— listed inCLAUDE.mdis onlyfrigg auth test <module>.Suggested fix
Update
CLAUDE.md's CLI section to:frigg search(or implement it).packages/devtools/frigg-cli/index.jsso the docs stay locatable when commands evolve.Happy to open a PR with the docs update if useful — flagging this first so the team can decide whether
frigg searchshould be implemented (and what its scope is) before the docs are aligned.Found while building an agent-driven integration creation skill for Lefthook's Frigg projects; the skill needs an accurate command map to pick the right CLI invocation rather than re-implementing scaffolding.