Skip to main content
strawpot [--version] [--help] <command>

​
Session Management

​
start

Start an orchestration session. 
strawpot start [options]
OptionDescriptionDefault
--role ROLEOrchestrator role slugFrom config or orchestrator
--runtime RUNTIMEAgent runtime nameFrom config or claude_code
--isolation MODEIsolation strategy: none, worktree, dockerFrom config or none
--task TEXTTask for non-interactive mode (empty = interactive)—
Examples: 
# Interactive session with defaults
strawpot start

# Custom orchestrator role with worktree isolation
strawpot start --role team-lead --isolation worktree

# Non-interactive task
strawpot start --task "Refactor the auth module"

​
config

Show the merged configuration (defaults + global + project + CLI). 
strawpot config

​
sessions

List all running sessions. 
strawpot sessions
Displays session ID, status, uptime, working directory, and Denden address for each active session.

​
agents

List agents in a specific session. 
strawpot agents <session_id>
Shows each agent’s role, runtime, parent agent, and status.

​
StrawHub Passthrough

StrawPot delegates these commands to the strawhub CLI. They work identically to calling strawhub directly.

​
install

Install a skill or role from StrawHub. 
strawpot install skill <slug> [options]
strawpot install role <slug> [options]
OptionDescription
--globalInstall to global directory (~/.strawpot)
--version VERInstall a specific version
--forceForce replace existing (requires --version)
--updateUpdate to latest if already installed
--skip-toolsSkip system tool installation
--yesAuto-confirm prompts
Search the StrawHub registry. 
strawpot search <query> [--kind skill|role|all] [--limit N]

​
list

List available skills and roles. 
strawpot list [--kind skills|roles|all] [--sort updated|downloads|stars]

​
info

Show detailed information about a package. 
strawpot info skill <slug>
strawpot info role <slug>

​
resolve

Resolve a package to its installed path and dependencies. 
strawpot resolve skill <slug>
strawpot resolve role <slug>

​
publish

Publish a skill or role to StrawHub. 
strawpot publish skill [<path>]
strawpot publish role [<path>]

​
Authentication

strawpot login     # Authenticate with StrawHub
strawpot logout    # Remove stored credentials
strawpot whoami    # Show current user