✦ boost commands
← back to overview
Install & lifecycle
install uninstall sync update reinstall bundle import migrate pin unpin snapshot export adapt run
Find & search
search reindex discover recommend browse index trending stats count
Inspect & explain
list info cat edit preview explain log home deps tag
Taps & registries
tap untap taps outdated
AI-assisted
distill simulate infer absorb evolve context focus impact
Health & integrity
doctor lint audit verify drift test fingerprint quarantine decay heal conflict changelog attest health trust
Config & setup
config clean create policy onboard completions schedule serve mcp hooks bmad self-update
Team & sharing
cohort profile protocol pulse replay who
No commands match.

# boost command reference

All 78 commands, generated from the CLI itself — run `boost <command> --help` for the same in your terminal.

## Install & lifecycle

### install pkg

Install a skill from a tap registry

    boost install [--force] [--agent A] [--scope {user,project}] [--local] [--global] [--dry-run] [--no-deps] [--no-mcp] NAME [NAME ...]

Arguments
`NAME` skill name, optionally qualified as tap:skill
Options
`--force` reinstall even if already installed or pinned
`--agent A` link only into this agent (repeatable)
`--scope {user,project}`install into your user config (default) or the current repo (project)
`--local` into this repo, committable (= --scope project)
`--global` into your user config (= --scope user, default)
`--dry-run` show what would happen without changing anything
`--no-deps` install only the named skills, not their `requires:`
`--no-mcp` don't offer to register MCP servers a skill declares

### uninstall pkg

Remove an installed skill, rule, workflow, or config

    boost uninstall [--local] [--yes] NAME [NAME ...]

Arguments
`NAME`
Options
`--local` remove from this repo rather than your user config
`-y, --yes` skip the confirmation prompt

### sync pkg

Reconcile installed skills & symlinks against the lock file

    boost sync [--diff] [--prune] [--json]

Options
`--diff` show the plan without applying it
`--prune` also delete orphaned store dirs
`--json` machine-readable output

### update pkg

Sync taps or update installed skills

    boost update [--taps-only] [TAP]

Arguments
`TAP` refresh only this tap
Options
`--taps-only` refresh tap clones & catalogs without touching skills

### reinstall pkg

Reinstall a skill or all skills (force)

    boost reinstall [--all] [NAME ...]

Arguments
`NAME`
Options
`--all` reinstall every installed skill

### bundle pkg

Export/install skill sets via a Boostfile

    boost bundle {dump,install} [FILE]

Arguments
`{dump,install}`
`FILE` Boostfile (dump: default stdout; install: default ./Boostfile, '-' = stdin)

### import pkg

Import skills from a GitHub URL or local path

    boost import [--name N] [--all] [--agent A] URL_OR_PATH

Arguments
`URL_OR_PATH`
Options
`--name N` skill to pick when several are found (or a rename)
`--all` import every skill found
`--agent A` link only into this agent (repeatable)

### migrate pkg

Migrate skills between agents or from Skills CLI

    boost migrate [--from AGENT] [--to AGENT] [--from-skills-cli] [--path DIR]

Options
`--from AGENT` agent migrating away from
`--to AGENT` agent to link every installed skill into
`--from-skills-cli` import skills installed by the Skills CLI
`--path DIR` Skills CLI directory (default ~/.skills)

### pin pkg

Pin a skill to its current version

    boost pin [--commit] NAME

Arguments
`NAME`
Options
`--commit` also freeze the exact source commit (integrity pin)

### unpin pkg

Allow a pinned skill to update again

    boost unpin NAME

Arguments
`NAME`

### snapshot pkg

Save & restore whole skill environments

    boost snapshot [--json] {save,list,restore} [LABEL|ID]

Arguments
`{save,list,restore}`
`LABEL|ID` label for save, snapshot id for restore
Options
`--json` machine-readable output (list)

### export pkg

Package skills as shareable zip/tar archives

    boost export [--out OUT] [--zip] [NAME ...]

Arguments
`NAME` skills to export (default: all installed)
Options
`-o, --out OUT` output archive path
`--zip` build a .zip instead of .tar.gz

### adapt pkg

Render a skill as another framework's agent source (CrewAI, Agents SDK)

    boost adapt [--to FRAMEWORK] [--model M] [--out FILE] name

Render a skill as another agent framework's native source

Arguments
`name` skill to adapt
Options
`--to FRAMEWORK` target framework: agents-sdk, crewai, langgraph
`--model M` LLM the exported agent runs on (default: boost's ai.model; pass 'none' for the framework's own default)
`-o, --out FILE` write to FILE instead of stdout

### run pkg

Adapt a skill, wire tools & run it as a live agent

    boost run [--model M] [--print] [--out FILE] name [target]

Adapt a skill, wire default tools & run it as a live agent

Arguments
`name` skill to run
`target` file or directory for the agent to work on (default: .)
Options
`--model M` LLM to run on (default: boost's ai.model; 'none' for the SDK's own default)
`--print` print the generated runner script instead of executing it
`-o, --out FILE` with --print: write the runner to FILE

## Find & search

### search find

Search skills across tap registries (AI-ranked)

    boost search [--smart] [--limit LIMIT] [--json] query [query ...]

Arguments
`query` search terms
Options
`--smart` rerank the top hits with Claude
`--limit LIMIT` max results (default 15)
`--json` machine-readable output

### reindex find

Build/refresh the full-content search index

    boost reindex [--force] [--dense] [--json]

Build or refresh the full-content search index

Options
`--force` reindex every tap, ignoring cached commits
`--dense` also embed chunks into the opt-in dense vector store (needs the `rag` extra and an embeddings API key)
`--json` machine-readable output

### discover find

Browse & search the GitHub-wide skill discovery index

    boost discover [--limit LIMIT] [--json] [query ...]

Arguments
`query` filter terms (repo/path substring)
Options
`--limit LIMIT` max rows (default 25)
`--json` machine-readable output

### recommend find

Suggest skills based on your project's tech stack

    boost recommend [--path PATH] [--limit LIMIT] [--json]

Options
`--path PATH` project directory (default: cwd)
`--limit LIMIT` max suggestions (default 8)
`--json` machine-readable output

### browse find

Interactive full-screen TUI with fuzzy search

    boost browse

### index find

Build the discovery registry via GitHub Code Search

    boost index [--limit LIMIT]

Options
`--limit LIMIT` max skill files to index (default 300)

### trending find

Show trending skills by install count

    boost trending [--limit LIMIT]

Options
`--limit LIMIT` max rows (default 10)

### stats find

Install statistics & trend for a single skill

    boost stats [--json] name

Arguments
`name` skill name
Options
`--json` machine-readable output

### count find

Quick summary of installed / available / taps

    boost count [--json]

Options
`--json` machine-readable output

## Inspect & explain

### list info

List installed skills

    boost list [--tag TAG] [--local] [--json]

List installed skills, rules and workflows

Options
`--tag TAG` only show skills carrying this tag
`--local` only the skills installed into this repo
`--json` machine-readable output

### info info

Show detailed info about a skill

    boost info [--json] name

Arguments
`name`
Options
`--json` machine-readable output

### cat info

Print a skill or rule's contents

    boost cat [--raw] name

Arguments
`name`
Options
`--raw` no styling even on a TTY

### edit info

Open a skill's SKILL.md in your editor

    boost edit name

Arguments
`name`

### preview info

Render a SKILL.md with rich formatting

    boost preview name

Arguments
`name`

### explain info

Explain what a skill does in plain English

    boost explain name

Arguments
`name`

### log info

Git log for a skill, or boost's activity log

    boost log [--limit N] [--diagnostics] [--crashes] [name]

Arguments
`name` skill to show upstream history for
Options
`-n, --limit N` max entries (default 20)
`--diagnostics` show boost's diagnostic log trail (not skill history)
`--crashes` list recent crash reports

### home info

Open a skill's GitHub page in the browser

    boost home [--print] name

Arguments
`name`
Options
`--print` print the URL without opening a browser

### deps info

Show dependency & conflict relationships

    boost deps [--json] [name]

Arguments
`name` skill to inspect (default: check all installed)
Options
`--json` machine-readable output

### tag info

Custom labels for organizing skills

    boost tag [--list] [--json] [name] [mods ...]

Arguments
`name` installed skill
`mods`+tag to add, -tag to remove
Options
`--list` show every tag and the skills carrying it
`--json` machine-readable output

## Taps & registries

### tap tap

Add a GitHub repo as a skill registry

    boost tap [--defaults] [--catalog] [--type {skill,rule,workflow}] [--category CATEGORY] [--limit N] [--include-lists] [--dry-run] [--curated] [spec]

Arguments
`spec` owner/repo, a git URL, or a local directory
Options
`--defaults` tap the recommended public registries
`--catalog` tap from the bundled curated registry catalog
`--type {skill,rule,workflow}`with --catalog: restrict to one item type
`--category CATEGORY` with --catalog: restrict to one category
`--limit N` with --catalog: only the top N registries by est. size
`--include-lists` with --catalog: also tap awesome-list/index repos
`--dry-run` with --catalog: print what would be tapped, tap nothing
`--curated` mark the tap as curated (★ in listings)

### untap tap

Remove a registry tap

    boost untap [--force] name

Arguments
`name` tap name (owner/repo or short alias)
Options
`-f, --force` skip the confirmation prompt

### taps tap

List all configured registry taps

    boost taps [--json]

Options
`--json` machine-readable output

### outdated tap

Show skills with available updates

    boost outdated [--json]

Options
`--json` machine-readable output

## AI-assisted

### distill ai

Merge multiple skills into one deduplicated skill

    boost distill [--output NEWNAME] [--install] NAME [NAME ...]

Arguments
`NAME` two or more skills to merge
Options
`-o, --output NEWNAME` name for the merged skill (default: <first>-distilled)
`--install` install the merged skill instead of writing a file

### simulate ai

Preview how a skill would change Claude's behavior

    boost simulate [--task TEXT] NAME

Arguments
`NAME`
Options
`--task TEXT` task to simulate (default: a typical coding task)

### infer ai

Generate a SKILL.md from your codebase patterns

    boost infer [--path DIR] [--name N] [--output FILE] [--install]

Options
`--path DIR` codebase to analyze (default: current directory)
`--name N` skill name (default: project-conventions)
`-o, --output FILE` write to a file
`--install` install the generated skill

### absorb ai

Turn recurring chat-history patterns into a skill

    boost absorb [--history PATH] [--limit N] [--install]

Options
`--history PATH` history .jsonl file or directory of them
`--limit N` max patterns to absorb (default: 5)
`--install` install the generated skill

### evolve ai

Iteratively improve a skill from feedback

    boost evolve [--feedback TEXT] [--apply] NAME

Arguments
`NAME`
Options
`--feedback TEXT` what should change, in plain English
`--apply` write the revision to the installed skill

### context ai

Branch-aware skill activation

    boost context status|enable|disable|map|unmap|apply

Arguments
`status|enable|disable|map|unmap|apply`

### focus ai

Temporarily prioritize skills for a work session

    boost focus [--clear] [--status] [--json] [SKILL ...]

Arguments
`SKILL` skills to focus on
Options
`--clear` end the session and relink everything
`--status` show current focus
`--json`

### impact ai

Measure a skill's influence on code quality

    boost impact [--json] [NAME]

Arguments
`NAME` one skill (default: all installed)
Options
`--json`

## Health & integrity

### doctor chk

Check installation health & report issues

    boost doctor

### lint chk

Validate SKILL.md frontmatter & quality

    boost lint [--tap TAP] [--min N] [--json] [NAME ...]

Arguments
`NAME`
Options
`--tap TAP` lint every skill in a tap's clone
`--min N` minimum passing score (default 40)
`--json`

### audit chk

Check installed skills against a safety blocklist

    boost audit [--json] [--skills]

Options
`--json`
`--skills` trust/staleness report for installed skills instead of the content scan

### verify chk

Validate skill quality & lock-file integrity

    boost verify [--json] [NAME ...]

Arguments
`NAME`
Options
`--json`

### drift chk

Detect installed skills diverging from source

    boost drift [--json] [NAME ...]

Arguments
`NAME`
Options
`--json`

### test chk

Validate installed skills against quality checks

    boost test [NAME ...]

Arguments
`NAME`

### fingerprint chk

Deterministic hash of the skill environment

    boost fingerprint [--verbose] [--json]

Options
`--verbose` show the hashed components
`--json`

### quarantine chk

Isolate a problematic skill without uninstalling

    boost quarantine [--release NAME] [--list] [NAME]

Arguments
`NAME`
Options
`--release NAME` re-link a quarantined skill
`--list` list quarantined skills

### decay chk

Flag skills irrelevant to your current stack

    boost decay [--json]

Options
`--json`

### heal chk

Self-diagnose & repair the boost environment

    boost heal [--dry-run]

Options
`--dry-run` show repairs without applying them

### conflict chk

Detect contradictory rules between skills

    boost conflict [--json]

Options
`--json`

### changelog chk

Show a skill's upstream change history

    boost changelog [-n N] NAME

Arguments
`NAME`
Options
`-n N` number of entries (default 20)

### attest chk

Display/verify the install record for skills

    boost attest [--verify] [--json] [NAME]

Arguments
`NAME`
Options
`--verify` check sha & journal record for each skill
`--json`

### health chk

Dashboard of skill-environment health

    boost health

### trust chk

Manage signing keys & verify tap provenance

    boost trust [--json] [{list,add,remove,verify}] [name] [key]

Arguments
`{list,add,remove,verify}`what to do (default: list)
`name` key name (add/remove) or tap name (verify)
`key` with add: a minisign .pub file or its base64 line
Options
`--json` machine-readable output

## Config & setup

### config cfg

Display or modify boost configuration

    boost config [--json] [{list,get,set,unset}] [key] [value]

Arguments
`{list,get,set,unset}`what to do (default: list)
`key` dotted key, e.g. ai.enabled
`value` new value (JSON or string)
Options
`--json` machine-readable output

### clean cfg

Clear stale caches & broken symlinks

    boost clean [--dry-run] [--deep]

Options
`--dry-run` show what would be removed without touching anything
`--deep` also remove snapshots older than 90 days

### create cfg

Scaffold a new skill from a template

    boost create [--description DESCRIPTION] [--dir DIR] [--install] name

Arguments
`name` skill name (slugified)
Options
`--description DESCRIPTION` one-line trigger description for the frontmatter
`--dir DIR` parent directory (default: current directory)
`--install` install the new skill immediately

### policy cfg

Manage & enforce skill governance policies

    boost policy [--json] [{list,set,unset,check}] [key] [value]

Arguments
`{list,set,unset,check}`what to do (default: list)
`key` policy key, e.g. min_quality_score
`value` new value (JSON, comma list, or string)
Options
`--json` machine-readable output

### onboard cfg

Add skill-tracker telemetry to a repo & open a PR

    boost onboard [--repo REPO] [--pr] [--dry-run] [--force]

Options
`--repo REPO` repository directory (default: .)
`--pr` commit on a branch and open a PR with `gh`
`--dry-run` preview the files without writing anything
`-f, --force` overwrite existing files without confirming

### completions cfg

Generate shell tab-completion scripts

    boost completions [{bash,zsh,fish}]

Arguments
`{bash,zsh,fish}`target shell (default: from $SHELL)

### schedule cfg

Manage automatic skill-sync scheduling

    boost schedule [--interval {6h,12h,daily}] [--json] [{status,enable,disable}]

Arguments
`{status,enable,disable}`what to do (default: status)
Options
`--interval {6h,12h,daily}`how often to run `boost update` (default: 6h)
`--json` machine-readable output (status only)

### serve cfg

Serve the skill catalog over HTTP (port 8787)

    boost serve [--port PORT] [--host HOST]

Options
`--port PORT` port to listen on (default: config serve.port)
`--host HOST` address to bind (default: 127.0.0.1)

### mcp cfg

Register boost as an MCP server (Claude Code, Gemini CLI)

    boost mcp [--host H] [--stdio] [{register,unregister}]

Register boost as an MCP server for your agent CLIs

Arguments
`{register,unregister}`what to do (default: register)
Options
`--host H` agent CLI to (un)register with: claude, gemini, or `auto` (default) for every one that is installed
`--stdio` run the MCP server on stdin/stdout (used by the agent)

### hooks cfg

Manage Claude Code hooks (scope-aware) in settings.json

    boost hooks [--command COMMAND] [--name NAME] [--scope {global,project}] [--matcher MATCHER] [--timeout TIMEOUT] {add,remove,list} [event]

Arguments
`{add,remove,list}`add | remove | list
`event` hook event, e.g. SessionStart (required for add)
Options
`-c, --command COMMAND` command the hook runs (add)
`-n, --name NAME` stable name used to tag & find the hook
`-s, --scope {global,project}`settings scope (default: project; list shows both)
`-m, --matcher MATCHER` Claude matcher, e.g. 'startup|resume|clear'
`--timeout TIMEOUT` hook timeout in seconds (default: 10)

### bmad cfg

Install & manage the BMAD Method (scope-aware, toggleable)

    boost bmad [--scope {project,global}] [--modules MODULES] [--yes] [--startup] {install,init,startup,orient,uninstall,disable,enable,doctor,status} [value]

Arguments
`{install,init,startup,orient,uninstall,disable,enable,doctor,status}`install | init | startup | orient | uninstall | disable | enable | doctor | status
`value` for startup: on | off | status
Options
`-s, --scope {project,global}`target scope (default: project)
`--modules MODULES` BMAD modules to install (default: bmm)
`-y, --yes` skip confirmation prompts
`--startup` enable the startup toggle right after install

### self-update cfg

Update boost itself to the latest version

    boost self-update [--dry-run]

Options
`--dry-run` show how boost would update itself, change nothing

## Team & sharing

### cohort team

Controlled skill rollouts & team A/B testing

    boost cohort [--skills SKILLS] [--percent PERCENT] [--json] [{list,create,delete,status,apply}] [name]

Arguments
`{list,create,delete,status,apply}`
`name` cohort name
Options
`--skills SKILLS` comma-separated skill names
`--percent PERCENT` rollout percentage (default 100)
`--json` machine-readable output

### profile team

Named skill profiles for context switching

    boost profile [--prune] [--json] [{list,save,use,show,diff,delete}] [name]

Arguments
`{list,save,use,show,diff,delete}`
`name` profile name
Options
`--prune` with `use`: fully uninstall skills not in the profile
`--json` machine-readable output

### protocol team

Manage the boost:// one-click-install handler

    boost protocol [{status,register,unregister,open}] [url]

Arguments
`{status,register,unregister,open}`
`url` a boost:// URL (for `open`)

### pulse team

Team activity feed of skill-management events

    boost pulse [-n N] [--all] [--action ACTION] [--json]

Options
`-n N` events to show (default 20)
`--all` show the whole journal
`--action ACTION` filter by action (install, tap, ...)
`--json` machine-readable output

### replay team

View version history & roll back skills

    boost replay [--json] [{list,show,rollback}] [id]

Arguments
`{list,show,rollback}`
`id` history entry id (from `boost replay list`)
Options
`--json` machine-readable output

### who team

Discover who on the team has skill expertise

    boost who [--json] [skill]

Arguments
`skill` focus on one skill
Options
`--json` machine-readable output