Skip to main content
pip install strawhub
Cross-platform: macOS, Linux, and Windows. Requires Python 3.10+. 
strawhub [--version] [--help] <command>

​
Package Management

​
install

Install a skill or role with all dependencies. Without a subcommand, installs from strawpot.toml. 
# From project file
strawhub install [--skip-tools] [--yes]

# Specific package
strawhub install skill <slug> [options]
strawhub install role <slug> [options]
OptionDescription
--globalInstall to global directory (~/.strawpot)
--version <ver>Install a specific version
--forceForce replace existing (requires --version)
--updateUpdate to latest if already installed
--recursiveWith --update, also update all dependencies
--saveSave to strawpot.toml with ^X.Y.Z constraint
--save-exactSave to strawpot.toml with ==X.Y.Z constraint
--skip-toolsSkip system tool installation
--yes, -yAuto-confirm tool install prompts
Examples: 
strawhub install                                    # from project file
strawhub install skill code-review                  # latest version
strawhub install skill code-review --version 2.1.0  # specific version
strawhub install role implementer --global           # global install
strawhub install skill code-review --save            # save to project file
strawhub install skill code-review --update          # update to latest

​
uninstall

Remove a package and clean up orphaned dependencies. 
strawhub uninstall skill <slug> [--version <ver>] [--global] [--save]
strawhub uninstall role <slug> [--version <ver>] [--global] [--save]

​
update

Update packages to their latest versions. 
strawhub update skill <slug> [--global] [--save] [--skip-tools] [--yes]
strawhub update role <slug> [--global] [--save] [--skip-tools] [--yes]
strawhub update --all [--global] [--save] [--skip-tools] [--yes]

​
init

Create strawpot.toml from installed packages. 
strawhub init [--force] [--exact]

​
install-tools

Install system tools declared by packages. 
strawhub install-tools [--global] [--yes]

​
Discovery

Search the registry. 
strawhub search <query> [--kind skill|role|all] [--limit N] [--json]

​
info

Show package details. 
strawhub info skill <slug> [--file PATH] [--json]
strawhub info role <slug> [--file PATH] [--json]

​
list

List available packages. 
strawhub list [--kind skills|roles|all] [--limit N] [--sort updated|downloads|stars] [--json]

​
Runtime

​
resolve

Resolve a package to its installed path and dependency paths. 
strawhub resolve skill <slug> [--version <ver>] [--global]
strawhub resolve role <slug> [--version <ver>] [--global]
Returns JSON with the resolved path and all transitive dependencies.

​
Publishing

​
publish

Publish a skill or role to the registry. Requires authentication. 
strawhub publish skill [<path>] [--version <ver>] [--changelog <text>] [--tag <tag>]...
strawhub publish role [<path>] [--version <ver>] [--changelog <text>] [--tag <tag>]...
The directory must contain SKILL.md or ROLE.md with valid frontmatter. See Publishing Guide.

​
Social

​
star / unstar

strawhub star skill <slug>
strawhub unstar role <slug>

​
Authentication

​
login

strawhub login
Prompts for an API token from strawhub.dev/settings.

​
logout

strawhub logout

​
whoami

strawhub whoami [--json]

​
Administration

Requires admin privileges.

​
delete

strawhub delete skill <slug> [--yes]
strawhub delete role <slug> [--yes]

​
ban-user

strawhub ban-user <handle> [--reason <text>] [--unban]

​
set-role

strawhub set-role <handle> <role>  # admin, moderator, or user

​
Configuration

​
Environment Variables

VariableDescriptionDefault
STRAWHUB_API_URLOverride the API endpointhttps://strawhub.dev
STRAWHUB_TOKENOverride the auth tokenFrom strawhub login
STRAWPOT_HOMEOverride the global install directory~/.strawpot

​
Config File

Stored in the platform-specific config directory:
OSPath
Linux~/.config/strawhub/config.json
macOS~/Library/Application Support/strawhub/config.json
Windows%LOCALAPPDATA%\strawhub\config.json