Metadata-Version: 2.4
Name: strawpot
Version: 0.1.26
Summary: Lightweight CLI for agent orchestration
Author: StrawPot Contributors
License-Expression: MIT
Project-URL: Homepage, https://github.com/strawpot/strawpot
Project-URL: Repository, https://github.com/strawpot/strawpot
Project-URL: Issues, https://github.com/strawpot/strawpot/issues
Keywords: agent,orchestration,cli,multi-agent,grpc
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: click>=8.1
Requires-Dist: pyyaml>=6.0
Requires-Dist: tomli_w>=1.0
Requires-Dist: strawhub
Requires-Dist: strawpot-memory
Requires-Dist: strawpot-gui
Requires-Dist: denden-server
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-cov>=6.0; extra == "dev"
Requires-Dist: pytest-timeout>=2.0; extra == "dev"
Requires-Dist: pyinstaller>=6.0; extra == "dev"

# StrawPot CLI

Lightweight CLI for agent orchestration. StrawPot connects
[Denden](https://github.com/strawpot/denden) (gRPC agent-to-orchestrator transport)
and [StrawHub](https://strawhub.dev) (skill & role registry) to run multi-agent
sessions in isolated environments.

## Install

```
pip install strawpot
```

## Usage

```bash
# Start a session (foreground, interactive)
strawpot start
strawpot start --role team-lead --runtime strawpot-claude-code

# Install skills and roles from StrawHub
strawpot install skill git-workflow
strawpot install role implementer

# Search and list
strawpot search "code review"
strawpot list

# Show merged config
strawpot config
```

## Configuration

Global: `$STRAWPOT_HOME/strawpot.toml` (default `~/.strawpot/strawpot.toml`)
Project: `strawpot.toml` (project root)

```toml
runtime = "strawpot-claude-code"       # strawpot-claude-code | codex | openhands
isolation = "worktree"        # worktree | docker

[denden]
addr = "127.0.0.1:9700"

[orchestrator]
role = "team-lead"

[policy]
max_depth = 3
cache_delegations = true     # cache delegation results (default: true)
max_num_delegations = 0      # max delegation calls per session (0 = unlimited)
```

## Links

- [Repository](https://github.com/strawpot/strawpot) — full project docs and architecture
- [StrawHub](https://strawhub.dev) — skill & role registry
- [Denden](https://github.com/strawpot/denden) — gRPC transport layer
