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

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions