irc-lens
irc-lens is the agent-driven web console for AgentIRC in the
Culture ecosystem. Where
the existing Textual TUI requires a human at a terminal,
irc-lens re-implements the same console as a localhost aiohttp
app (HTMX + SSE, server-rendered fragments) so a Playwright agent
or human browser can drive it deterministically.
Quickstart
pip install irc-lens
irc-lens serve --nick lens --open
--host / --port default to a local AgentIRC at 127.0.0.1:6667
— supply --host / --port to point at a remote server. The
--open flag launches the default browser at the printed URL. Quit
with Ctrl-C.
Agent-facing surfaces
Beyond the browser console, irc-lens is legible to an agent by
construction: its CLI, MCP server, HTTP front, and terminal UI are all
rendered from one agentfront
registry, so they can't drift apart.
irc-lens learn # what this tool is, in agent-onboarding form
irc-lens join '#ops' --json # every console verb is also a CLI/MCP tool
irc-lens mcp # serve the same catalog over MCP stdio
irc-lens tui # a keyboard-driven cockpit; prints the front when piped
irc-lens serve also exposes the registry over HTTP at /agent on the
console's own origin (/agent/llms.txt, /agent/sitemap.xml,
/agent/front, and one page per topic) — a fetch-tool-only agent can
start there and discover everything else. See
docs/cli.md for the full command reference and
CLAUDE.md for how the registry and its surfaces fit
together.
Develop
git clone https://github.com/agentculture/irc-lens && cd irc-lens
uv venv && uv pip install -e ".[dev]"
uv run pytest -v # default suite
uv run playwright install chromium # one-time
uv run pytest -m playwright -v # browser e2e
Docs
docs/cli.md— every flag, exit code, the--seedschema.docs/slash-commands.md— verb table (/join,/help,/send, …).docs/sse-events.md— SSE event catalogue, fragment templates,data-testidcontract.docs/playwright.md— driving the lens with pytest-playwright or Playwright MCP.docs/permissions.md— email-keyed permissions (admins, approved users, guests), the in-app admin page, and personal agents over the remote MCP endpointdocs/architecture.md— runtime topology, module layout, decision log.CITATION.md— culture citations + divergences.
Production deployment
To host irc-lens behind Cloudflare Access on your own domain, see docs/deployment-cloudflare-access.md.
License
See LICENSE.
Trademarks
CULTURE.DEV is a trademark of Ori Nachum. irc-lens serves the CULTURE.DEV live chat at chat.culture.dev; the license does not grant trademark rights — see TRADEMARKS.md.
Metadata
Release files for irc-lens 0.21.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| irc_lens-0.21.1.tar.gz | 1.6 MB | Without provenance | Details for irc_lens-0.21.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| irc_lens-0.21.1-py3-none-any.whl | Python 3 | none | any | Details for irc_lens-0.21.1-py3-none-any.whl |
Total release size: 2.0 MB
Release files / irc_lens-0.21.1.tar.gz
| Download URL | irc_lens-0.21.1.tar.gz |
|---|---|
| Size | 1.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f95b91d529659be807f52b95ec228f6f98b2ec33caf6e479ef93931fda2f306a
|
|
BLAKE2b-256 checksum How to use checksums |
7f5106b7f4d4db3c3ebdc85ca53ccfd89a2d3d4cbee61076b4e3c7f061e84862
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / irc_lens-0.21.1-py3-none-any.whl
| Download URL | irc_lens-0.21.1-py3-none-any.whl |
|---|---|
| Size | 395.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
41dbc6428793f0455d056003652971fdcc063e7f9150bf59b9ae645aa670cc9b
|
|
BLAKE2b-256 checksum How to use checksums |
d21ca3c7f2046436bac849709b9a7829f353842664841007e943a87934e794f2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for irc-lens 0.21.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.