3 min read
CLI Reference

General Commands

CommandDescription
bgng statusSummarize current effective state
bgng doctorDiagnose problems without mutating
bgng scanScan the current environment
bgng initStart or bootstrap project config
bgng applyApply effective config to target tools

Add Commands

CommandDescription
bgng add extension <name>Enable an extension for the current project
bgng add skill [name-or-query]Add a skill to the current project
bgng add mcp [name-or-query]Add an MCP server to the current project

Search Commands

CommandDescription
bgng search skill <query>Search for skills in the library and online catalogs
bgng search mcp <query>Search for MCP servers

Library Commands

CommandDescription
bgng library list [skills|mcp|tools]List library contents
bgng library show <id>Show details for a library item
bgng library add skill <packageSpec>Add a package-backed skill bundle
bgng library add mcp <jsonFile> --as <serverId>Register a user MCP server
bgng library defaults listList machine-wide defaults
bgng library defaults add skill <skillName>Add a skill to defaults
bgng library defaults add mcp <serverName>Add an MCP server to defaults

Extension Commands

CommandDescription
bgng extensions listList available extensions
bgng extensions show <name>Show extension details
bgng extensions status [name]Report extension status
bgng extensions doctor [name]Diagnose extension issues
bgng extensions setup beadsRun Beads setup workflow
bgng extensions setup parallelRun Parallel setup workflow

MCP Commands

CommandDescription
bgng mcp listList active MCP servers
bgng mcp applyApply MCP config to targets

Skill Commands

CommandDescription
bgng skills listList available skills
bgng skills curate <skillName>Curate a shared skill
bgng skills uncurate <skillName>Remove a skill from curation
bgng skills packages add <packageSpec>Add a package-backed skill bundle
bgng skills packages listList installed skill packages
bgng skills packages show <packageName>Show package details

Flags

Most inspection commands support --json for machine-readable output. Apply commands support --dry-run to preview changes.

Use --help on any command for details:

bgng --help
bgng apply --help
bgng add skill --help
bgng library list --help
bgng search skill --help
bgng extensions setup beads --help
bgng skills packages add --help