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.13.0
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.13.0.tar.gz | 1.3 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| irc_lens-0.13.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.6 MB
Release files / irc_lens-0.13.0.tar.gz
| Download URL | irc_lens-0.13.0.tar.gz |
|---|---|
| Size | 1.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
477fb6ba3a420096c4cb501faf7920d9b0797360928674abb2ea001d466ad6ad
|
|
BLAKE2b-256 checksum How to use checksums |
92c66d040d9e20f3a7aa40749958ca3a6c3aac77cfa2f0dd481293323a8100ff
|
| 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.13.0-py3-none-any.whl
| Download URL | irc_lens-0.13.0-py3-none-any.whl |
|---|---|
| Size | 317.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
913f9219b7ef86b9eaed3d0b69650e974f2f52571a89213b7ec49af82e1ee7c6
|
|
BLAKE2b-256 checksum How to use checksums |
d23985859ca2138dfd3b8599a68138b60b17498bae78c2db3e4ec33ff493e155
|
| 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}
|
