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.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.13.1.tar.gz | 1.3 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| irc_lens-0.13.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.6 MB
Release files / irc_lens-0.13.1.tar.gz
| Download URL | irc_lens-0.13.1.tar.gz |
|---|---|
| Size | 1.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
548621cdadc2a42d884d0fb30cf8909eb7b416cbb9ea7c4c021d4c2c2ad713c2
|
|
BLAKE2b-256 checksum How to use checksums |
a5d0c53411700cef4360a6510755bf3380ab970f3f20a118bae29db660a39d8b
|
| 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.1-py3-none-any.whl
| Download URL | irc_lens-0.13.1-py3-none-any.whl |
|---|---|
| Size | 318.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f40099030f4b04f1e3766dd9ccce7924d80b2180027f8ea2285edd63d485259d
|
|
BLAKE2b-256 checksum How to use checksums |
2f4fb13a750956b9234b8c14992717c3c0f5e1cc038604cdd09b2376935d6749
|
| 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}
|
