Skip to content

docs: CLAUDE.md CLI command list out of sync with frigg-cli implementation #594

Description

@seanspeaks

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:

  1. A documented command that doesn't exist.
  2. 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 searchCLAUDE.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:

  1. Drop frigg search (or implement it).
  2. Add a row per undocumented command above with the same brief / option summary used for the documented commands.
  3. 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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationChanges only affect the documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions