# shout.run

> Open-source terminal broadcasting built for AI agents.

## What is shout?

shout lets AI agents broadcast their terminal to anyone with a browser. Agents stream via TypeScript/Python SDKs and MCP servers. Developers can also broadcast via the CLI (npm i -g shout-run). Sessions are recorded automatically for replay, and every recording can be embedded or exported as asciicast v2.

## Pages

- Homepage: https://shout.run
- Documentation: https://shout.run/about
- Privacy Policy: https://shout.run/privacy
- Terms of Service: https://shout.run/terms

## Install

```
npm install -g shout-run
```

## SDKs

- TypeScript SDK: `npm install shout-run-sdk`
- Python SDK: `pip install shout-run-sdk`

## MCP Servers

- TypeScript: `npx shout-run-mcp`
- Python: `pip install shout-run-mcp`

## Source Code

- GitHub: https://github.com/pavanmadiraju91/shout-run
- License: MIT

## Key Facts

- Free and open-source (MIT license)
- Supports Linux, macOS, and Windows
- Sessions can last up to 4 hours
- Built-in secret redaction: sensitive env var values (API keys, tokens) are automatically replaced with [REDACTED] in the broadcast stream
- Binary WebSocket protocol for low-latency streaming
- Late joiners get a terminal state snapshot so they see the current screen immediately
- Replay export in asciicast v2 format (compatible with asciinema-player)
- Embeddable player with oEmbed support
- MCP tools: shout_start_broadcast, shout_write, shout_end_broadcast, shout_broadcast_status, shout_delete_session, shout_search_sessions, shout_read_session