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.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.12.0.tar.gz | 1.2 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| irc_lens-0.12.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.5 MB
Release files / irc_lens-0.12.0.tar.gz
| Download URL | irc_lens-0.12.0.tar.gz |
|---|---|
| Size | 1.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c4f58ac82b18d5dfbb46308c503802fb0eeeebdaf2b2832e6c9e7bef240d4a01
|
|
BLAKE2b-256 checksum How to use checksums |
7022d9504f0e540ee3c5a4594888f662b68fd8879b916f2681ab05b17366a27f
|
| 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.0-py3-none-any.whl
| Download URL | irc_lens-0.12.0-py3-none-any.whl |
|---|---|
| Size | 294.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0fc3335d9bfccf6b692e6593c639f6b0d92bb98856a76fa0d3587e8756c79a80
|
|
BLAKE2b-256 checksum How to use checksums |
5543102aac459e7d09e7d63f0e1c846e6626a790ade768c006765540040f484a
|
| 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}
|
