login

Login via Device Flow.

forgecat login [options]

Options:

• --registry <url> — Registry URL

search

Search profiles on the hub (omit query to browse all).

forgecat search [options] [query]

Options:

• --platform <id> — Filter by platform
• --sort <field> — Sort by: downloads, updated
• --limit <n> — Max results per page (default: 20)

view

View profile details.

forgecat view <profile-name>

install

Install a profile from the registry, GitHub, or a local directory.

forgecat install [options] <source>

Options:

• -p, --platform <ids> — Target platform(s), comma-separated
• -f, --force — Force overwrite on conflicts
• -y, --yes — Auto-accept script and hook consent prompts (non-interactive)
• --no-lockfile — Skip lockfile update
• --dry-run — Preview without writing files
• --frozen — Error if lockfile is out of date (CI mode)

list (alias: ls)

List installed profiles.

forgecat list [options]

Options:

• -v, --verbose — Show file-level details

status (alias: st)

Show file change status.

forgecat status [options] [profile-name]

Options:

• --json — JSON output

uninstall

Uninstall a profile.

forgecat uninstall [options] <profile-name>

Options:

• --force — Delete even locally modified files

update

Update installed profile(s) to the latest version from the registry.

forgecat update [options] [target]

Arguments:

• target — Profile to update (@user/name or @user/name@version); omit to update all installed

Options:

• -p, --platform <ids> — Target platform(s), comma-separated
• -f, --force — Force overwrite on conflicts
• -y, --yes — Auto-accept script and hook consent prompts (non-interactive)
• --dry-run — Show what would change without writing files

push

Publish profile to the registry.

forgecat push [options]

Options:

• --set-version <version> — Override version from profile.yml
• --registry <url> — Registry URL override
• --dry-run — Validate without uploading

unpublish

Unpublish a published profile — a single version or the full profile (limited access).

forgecat unpublish [options] <target>

Arguments:

• target — Profile (@scope/name) or a specific version (@scope/name@1.2.0)

Options:

• -y, --yes — Skip the y/N confirm for a version unpublish (no effect on full unpublish)
• --force — Skip the name-typing confirm for a FULL unpublish (dangerous; CI rollback only)
• --registry <url> — Registry URL override

tag

Manage profile tags.

forgecat tag [command]

Commands:

• list <profile> — List tags for a profile
• add <profile> <tags...> — Add tags to a profile
• remove <profile> <tags...> — Remove tags from a profile

setup

Configure MCP server environment variables for installed profiles.

forgecat setup [options]

Options:

• --reconfigure — Re-prompt for all values, including already configured ones

whoami

Show current user.

forgecat whoami [options]

Options:

• --json — JSON output

logout

Logout and remove credentials.

forgecat logout