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/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.
1 maintainer
Metadata
1 maintainer
Release files for irc-lens 0.12.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 | |
|---|---|---|---|
| irc_lens-0.12.1.tar.gz | 1.2 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| irc_lens-0.12.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.5 MB
Release files / irc_lens-0.12.1.tar.gz
| Download URL | irc_lens-0.12.1.tar.gz |
|---|---|
| Size | 1.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f3e7e56cc512d2a5efcb3dc770d21b5369b35d12589e1b1cb18ae6ab8ed92062
|
|
BLAKE2b-256 checksum How to use checksums |
64c0ea4c5a4758156cc71c65bd9af51a8621bc970d8c511bd4f642417e12bef4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","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.12.1-py3-none-any.whl
| Download URL | irc_lens-0.12.1-py3-none-any.whl |
|---|---|
| Size | 294.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8f6534ea7efec9adaef734cebc729a57d3ea7a4a85054048582805eee17898b3
|
|
BLAKE2b-256 checksum How to use checksums |
ff354e6e908ba72d37166d0c8d7fe80f3d3698ae6495dbff2c3fb2149373c082
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
