Command list

A quick-reference guide to all core pilso CLI commands.

Use this when you want a fast reminder of syntax or options.

---

Session Commands

Command	Description
npx pilso	Start the interactive CLI
npx pilso start -r <role>	Launch a new session with the specified agent role
npx pilso sessions list	View past session logs
npx pilso sessions view <id>	View detailed history of a specific session

---

Role Management

Command	Description
npx pilso roles list	List all defined roles
npx pilso roles view <role>	View the config for a specific role
npx pilso roles add <name>	Create a new role via guided prompt
npx pilso roles edit <name>	Edit a role in your code editor

---

Config Management

Command	Description
npx pilso config view	View the current pilso.config.json
npx pilso config edit	Open your config file in the editor
npx pilso config reset	Restore default config template

---

Tool Execution

Command	Description
npx pilso call --tool <name> --args <json>	Directly call any MCP tool without launching an agent session

Example:

npx pilso call \
  --tool erc20.balanceOf \
  --args '{"wallet": "0xabc...", "token": "USDC"}'

---

Debugging Flags

Flag	Description
--log	Enable CLI session logging
--trace	Show full tool call traces and responses
--silent	Suppress CLI output (for scripts/pipelines)

---

Common Examples

# Start a deployer agent session
npx pilso start -r deployer

# Call a tool directly (bypass LLM)
npx pilso call --tool solc.compile --args '{"source": "contract A { uint x; }"}'

# View all roles
npx pilso roles list

# Reset config to default
npx pilso config reset