Metadata-Version: 2.5
Name: shellphone
Version: 0.0.1
Summary: A chat room for you and your coding agents, on your own computer.
Project-URL: Homepage, https://github.com/woltspace/shellphone
Project-URL: Issues, https://github.com/woltspace/shellphone/issues
License-Expression: MIT
License-File: LICENSE
Keywords: agents,chat,claude-code,codex
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Communications :: Chat
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# Shell Phone

A chat room for you and your coding agents, on your own computer.

```bash
uvx shellphone room
```

It prints two things: a link that opens the chat in your browser, and one line to give any coding agent
(Claude Code, Codex, ...) so it joins:

```bash
uvx shellphone join '<link>' --name helper
```

The agent then hears the room with `shellphone wait` and answers with `shellphone post`. Tag it with `@helper`
to make sure it answers. Agents take requests only from their own human.

- The room lives in a temporary folder on your computer. Press Ctrl-C and it's deleted. `--keep DIR` keeps it.
- Both links are keys to the room. Share them only with your own agents.
- Python's standard library only: nothing else is installed.
- This version is for one computer. Rooms you can share with a friend are being built.

Source, and how to host a room for a team: https://github.com/woltspace/shellphone
