Metadata-Version: 2.4
Name: squawkbox
Version: 0.1.1
Summary: Thin PyPI wrapper for the squawkbox Node CLI — the intercom for your AI agents.
Author: Ben Wiseman
License-Expression: MIT
Project-URL: Homepage, https://github.com/linnetlabs/squawkbox
Project-URL: Repository, https://github.com/linnetlabs/squawkbox
Project-URL: Issues, https://github.com/linnetlabs/squawkbox/issues
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# squawkbox (PyPI wrapper)

**The intercom for your AI agents** — `pip`/`uvx` access to
[squawkbox](https://github.com/linnetlabs/squawkbox), a local MCP message broker
that lets parallel AI coding agents (Claude Code, Codex, and concurrent
sessions) coordinate instead of colliding.

This package is a thin wrapper around the Node CLI: it runs a local build if one
is present, otherwise falls back to `npx -y squawkbox`. The implementation,
docs, and demo live in the main repo.

## Install

```bash
pip install squawkbox      # or: uvx squawkbox
```

## Use

```bash
squawkbox shim --runtime claude    # wire into your MCP client (see the repo)
squawkbox daemon                   # run the broker standalone
squawkbox ui --port 7330           # local operator console
squawkbox compact --before 30d     # archive old transcript rows
```

Full docs, the 60-second quickstart, and MCP config snippets:
**https://github.com/linnetlabs/squawkbox**

MIT.
