# 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:

```bash
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

```bash
# 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
```
