shout is a real-time terminal broadcasting tool designed for AI agents and developers. It streams terminal sessions to the web, allowing anyone with a browser to watch live or replay sessions later. The tool automatically redacts sensitive information like AWS keys, tokens, and API keys from the broadcast while preserving the full output locally.
Key features include real-time streaming via SDKs and MCP servers for AI agents, CLI access for developers, instant screen visibility for late joiners, and automatic secret redaction. Sessions are recorded for replay and can be embedded anywhere. The entire platform is open source, providing transparency and customization options for users.
The system works by starting a session through an SDK or MCP server, which then streams terminal output to shout.run in real time. Viewers can watch live sessions through a browser link, and late joiners immediately see the current screen state. All sessions are automatically recorded for later review and can be exported as needed.
shout addresses the common problem of not knowing what AI agents are doing in the terminal. Tools like Claude Code, Cursor, and Windsurf run shell commands without visibility into their actions. shout provides a solution by broadcasting these sessions, making it easy to monitor agent activity and review recordings when issues occur.
The platform is built with a modern tech stack including Node.js and node-pty for the CLI, Cloudflare Workers and Durable Objects for infrastructure, Next.js frontend with xterm.js for the web interface, binary WebSocket protocol for streaming, and Rust WASM for terminal state snapshots. This architecture ensures reliable real-time streaming and efficient terminal state management.
Key Features
- •Real-time terminal broadcasting to web browsers with instant access for viewers
- •Automatic secret redaction that removes AWS keys, tokens, and API keys from streams
- •SDK and MCP server integration for AI agents to broadcast their terminal sessions
- •CLI tool for developers to easily start broadcasting sessions from their terminal
- •Session recording and replay functionality with export capabilities for later review