agentirc-cli 6.0.1__tar.gz → 6.1.0__tar.gz

agentirc_cli-6.1.0/.github/workflows/docs-check.yml

@@ -0,0 +1,37 @@
+name: Docs Check
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+jobs:
+  build-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+
+      - uses: ruby/setup-ruby@e65c17d16e57e481586a6a5a0282698790062f92 # v1
+        with:
+          ruby-version: '3.3'
+          bundler-cache: true
+
+      - name: Build AgentIRC docs
+        run: bundle exec jekyll build --config _config.base.yml,_config.agentirc.yml -d _site_agentirc
+        env:
+          JEKYLL_ENV: production
+
+      - name: Build Culture docs
+        run: bundle exec jekyll build --config _config.base.yml,_config.culture.yml -d _site_culture
+        env:
+          JEKYLL_ENV: production
+
+      - name: Verify sites tag on all doc files
+        run: |
+          MISSING=$(grep -rL "^sites:" docs/ --include="*.md" | grep -v superpowers | grep -v resources | grep -v README || true)
+          if [ -n "$MISSING" ]; then
+            echo "ERROR: The following doc files are missing a 'sites:' front matter tag:"
+            echo "$MISSING"
+            exit 1
+          fi
+          echo "All doc files have sites: tags."

{agentirc_cli-6.0.1 → agentirc_cli-6.1.0}/.gitignore

@@ -182,9 +182,9 @@ cython_debug/
 .abstra/
 
 # Visual Studio Code
-#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
 #  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
-#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  and can be added to the global gitignore or merged into this file. However, if you prefer,
 #  you could uncomment the following to ignore the entire vscode folder
 # .vscode/
 
@@ -215,3 +215,8 @@ safety-results.json
 # Superpowers & worktrees
 .superpowers/
 .worktrees/
+
+# Generated Jekyll output (never commit)
+_site/
+_site_agentirc/
+_site_culture/

{agentirc_cli-6.0.1 → agentirc_cli-6.1.0}/CHANGELOG.md

@@ -4,6 +4,34 @@ All notable changes to this project will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [6.1.0] - 2026-04-10
+
+
+### Added
+
+- Two-site docs architecture: agentirc.dev (runtime layer) and culture.dev (full solution)
+- Dark terminal theme (visual-anchor palette) replacing warm cream Anthropic theme
+- Site filter Jekyll plugin for per-page content selection via sites: front matter
+- 4-bucket content model: agentirc/, culture/, shared/, reference/
+- Custom SCSS components: hero sections, docs grids, stack diagrams, harness chips, CTA buttons
+- Cross-site linking via _data/sites.yml
+- docs-check CI workflow validating both site builds
+
+
+### Changed
+
+- Consolidated 23 per-backend harness docs into 4 single-page references
+- Restructured 92 docs files into 4 content buckets with sites: front matter tags
+- Replaced GitHub Pages deployment with Cloudflare Pages dual-site build
+- Rewrote README.md for dual-site structure
+
+## [6.0.2] - 2026-04-10
+
+
+### Changed
+
+- AgentIRC local docs with Jekyll pipeline copy step
+
 ## [6.0.1] - 2026-04-10
 
 

agentirc_cli-6.1.0/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: agentirc-cli
+Version: 6.1.0
+Summary: Legacy alias for culture — install culture instead
+Project-URL: Homepage, https://github.com/OriNachum/culture
+Author: Ori Nachum
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: AsyncIO
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Chat :: Internet Relay Chat
+Requires-Python: >=3.12
+Requires-Dist: aiohttp>=3.9
+Requires-Dist: anthropic>=0.40
+Requires-Dist: claude-agent-sdk>=0.1
+Requires-Dist: mistune>=3.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: textual>=1.0
+Provides-Extra: copilot
+Requires-Dist: github-copilot-sdk; extra == 'copilot'
+Description-Content-Type: text/markdown
+
+# Culture
+
+The complete human-agent collaboration system built around AgentIRC.
+
+**AgentIRC** is the IRC-native runtime for persistent AI agents and humans in shared live rooms.
+**Culture** is the full solution — CLI, harnesses, workflows, and multi-machine mesh.
+
+## Start here
+
+- [Quickstart](https://culture.dev/quickstart/) — install and start in 5 minutes
+- [Choose a Harness](https://culture.dev/choose-a-harness/) — Claude Code, Codex, Copilot, ACP
+- [AgentIRC Architecture](https://agentirc.dev/architecture/) — the runtime layer
+- [Vision & Patterns](https://culture.dev/vision/) — the broader model
+
+## Install
+
+```bash
+uv tool install culture
+culture server start
+```
+
+## Documentation
+
+- **[culture.dev](https://culture.dev)** — the full solution: quickstart, harnesses, guides, vision
+- **[agentirc.dev](https://agentirc.dev)** — the runtime layer: architecture, protocol, federation
+
+## License
+
+[MIT](LICENSE)

agentirc_cli-6.1.0/README.md

@@ -0,0 +1,29 @@
+# Culture
+
+The complete human-agent collaboration system built around AgentIRC.
+
+**AgentIRC** is the IRC-native runtime for persistent AI agents and humans in shared live rooms.
+**Culture** is the full solution — CLI, harnesses, workflows, and multi-machine mesh.
+
+## Start here
+
+- [Quickstart](https://culture.dev/quickstart/) — install and start in 5 minutes
+- [Choose a Harness](https://culture.dev/choose-a-harness/) — Claude Code, Codex, Copilot, ACP
+- [AgentIRC Architecture](https://agentirc.dev/architecture/) — the runtime layer
+- [Vision & Patterns](https://culture.dev/vision/) — the broader model
+
+## Install
+
+```bash
+uv tool install culture
+culture server start
+```
+
+## Documentation
+
+- **[culture.dev](https://culture.dev)** — the full solution: quickstart, harnesses, guides, vision
+- **[agentirc.dev](https://agentirc.dev)** — the runtime layer: architecture, protocol, federation
+
+## License
+
+[MIT](LICENSE)

agentirc_cli-6.1.0/_config.agentirc.yml

@@ -0,0 +1,19 @@
+title: AgentIRC
+description: >-
+  The IRC-native runtime for persistent AI agents and humans in shared live rooms.
+url: "https://agentirc.dev"
+baseurl: ""
+build_site: agentirc
+
+aux_links:
+  "Culture":
+    - "https://culture.dev"
+  "GitHub":
+    - "https://github.com/OriNachum/culture"
+
+aux_links_new_tab: true
+
+footer_content: >-
+  AgentIRC — the runtime layer at the heart of
+  <a href="https://culture.dev">Culture</a>.
+  Source on <a href="https://github.com/OriNachum/culture">GitHub</a>.

agentirc_cli-6.1.0/_config.base.yml

@@ -0,0 +1,54 @@
+title: ""
+description: ""
+baseurl: ""
+url: ""
+
+theme: just-the-docs
+color_scheme: dark-terminal
+
+search_enabled: true
+search:
+  button: true
+
+plugins:
+  - jekyll-seo-tag
+  - jekyll-relative-links
+  - jekyll-sitemap
+
+relative_links:
+  enabled: true
+  collections: false
+
+defaults:
+  - scope:
+      path: ""
+    values:
+      layout: "default"
+
+exclude:
+  - README.md
+  - CLAUDE.md
+  - LICENSE
+  - Gemfile
+  - Gemfile.lock
+  - .gitignore
+  - .github/
+  - .claude/
+  - .superpowers/
+  - culture/
+  - server/
+  - clients/
+  - protocol/
+  - tests/
+  - pyproject.toml
+  - uv.lock
+  - __pycache__/
+  - packages/
+  - scripts/
+  - plugins/
+  - _site/
+  - _site_agentirc/
+  - _site_culture/
+  - docs/superpowers/
+  - docs/resources/
+  - culture.yaml

agentirc_cli-6.1.0/_config.culture.yml

@@ -0,0 +1,19 @@
+title: Culture
+description: >-
+  The complete human-agent collaboration system built around AgentIRC.
+url: "https://culture.dev"
+baseurl: ""
+build_site: culture
+
+aux_links:
+  "AgentIRC":
+    - "https://agentirc.dev"
+  "GitHub":
+    - "https://github.com/OriNachum/culture"
+
+aux_links_new_tab: true
+
+footer_content: >-
+  Culture — human-agent collaboration built around
+  <a href="https://agentirc.dev">AgentIRC</a>.
+  Source on <a href="https://github.com/OriNachum/culture">GitHub</a>.

agentirc_cli-6.1.0/_data/sites.yml

@@ -0,0 +1,2 @@
+agentirc: https://agentirc.dev
+culture: https://culture.dev

agentirc_cli-6.1.0/_plugins/site_filter.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+# Site Filter Plugin
+#
+# Drops pages whose `sites` front matter array does not include
+# the current build_site (set in _config.agentirc.yml or _config.culture.yml).
+# Pages without a `sites` key are excluded from all builds (fail-safe).
+
+Jekyll::Hooks.register :pages, :post_init do |page|
+  site = page.site
+  build_site = site.config["build_site"]
+  next unless build_site
+
+  page_sites = page.data["sites"]
+  unless page_sites.is_a?(Array) && page_sites.include?(build_site)
+    page.data["published"] = false
+  end
+end

agentirc_cli-6.1.0/_sass/color_schemes/dark-terminal.scss

@@ -0,0 +1,40 @@
+// Dark Terminal Theme for just-the-docs
+// Dark, technical, calm — premium control plane aesthetic
+// Based on visual-anchor.md design system
+
+// Page background
+$body-background-color: #0B0F12;
+
+// Sidebar
+$sidebar-color: #11161B;
+
+// Text colors
+$body-text-color: #F3F5F7;
+$body-heading-color: #F3F5F7;
+
+// Links / accent
+$link-color: #41D67A;
+
+// Code
+$code-background-color: #11161B;
+
+// Borders
+$border-color: #1A222B;
+
+// Search
+$search-background-color: #11161B;
+$search-result-preview-color: #C7D0D9;
+
+// Secondary text / buttons
+$base-button-color: #8A97A3;
+
+// Navigation
+$nav-child-link-color: #C7D0D9;
+$sidebar-active-text-color: #41D67A;
+
+// Feedback / buttons
+$btn-primary-color: #41D67A;
+
+// Table
+$table-background-color: #11161B;
+$feedback-color: #C7D0D9;

agentirc_cli-6.1.0/_sass/custom/custom.scss

@@ -0,0 +1,219 @@
+// Override just-the-docs sidebar expansion formula at lg breakpoint.
+// The default formula absorbs leftover viewport space into the sidebar,
+// making it ~400-450px on laptops. This caps it at the base $nav-width.
+// Mobile dropdown behavior (below md breakpoint) is unaffected.
+
+.side-bar {
+  @media (min-width: 66.5rem) {
+    width: $nav-width;
+  }
+}
+
+.side-bar + .main {
+  @media (min-width: 66.5rem) {
+    margin-left: $nav-width;
+  }
+}
+
+// ─── Custom dark-terminal components ───
+
+// Secondary and muted text
+.text-secondary { color: #C7D0D9; }
+.text-muted { color: #8A97A3; }
+.text-accent { color: #41D67A; }
+
+// Hero section
+.hero {
+  text-align: center;
+  padding: 3rem 1.5rem 2rem;
+
+  .hero-label {
+    color: #41D67A;
+    font-size: 0.7rem;
+    text-transform: uppercase;
+    letter-spacing: 0.1em;
+    margin-bottom: 0.75rem;
+  }
+
+  .hero-headline {
+    color: #F3F5F7;
+    font-size: 1.5rem;
+    line-height: 1.4;
+    margin-bottom: 0.5rem;
+  }
+
+  .hero-sub {
+    color: #8A97A3;
+    font-size: 0.875rem;
+    line-height: 1.5;
+    margin-bottom: 1.5rem;
+  }
+}
+
+// CTA buttons
+.btn-cta {
+  display: inline-block;
+  padding: 0.5rem 1rem;
+  border-radius: 6px;
+  font-size: 0.8125rem;
+  font-weight: 600;
+  text-decoration: none;
+
+  &--primary {
+    background: #41D67A;
+    color: #0B0F12;
+    &:hover { background: #7CFF9E; color: #0B0F12; }
+  }
+
+  &--secondary {
+    border: 1px solid #1A222B;
+    color: #C7D0D9;
+    &:hover { border-color: #41D67A; color: #41D67A; }
+  }
+}
+
+// Docs grid (2-column card grid)
+.docs-grid {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 0.75rem;
+  margin: 1.5rem 0;
+
+  @media (max-width: 40rem) {
+    grid-template-columns: 1fr;
+  }
+}
+
+.docs-card {
+  background: #11161B;
+  border: 1px solid #1A222B;
+  border-radius: 6px;
+  padding: 0.875rem;
+  text-decoration: none;
+
+  &:hover { border-color: #41D67A; }
+
+  .docs-card-num {
+    color: #41D67A;
+    font-size: 0.75rem;
+    font-weight: 600;
+  }
+
+  .docs-card-title {
+    color: #F3F5F7;
+    font-size: 0.8125rem;
+    font-weight: 500;
+    margin: 0.25rem 0 0.125rem;
+  }
+
+  .docs-card-desc {
+    color: #8A97A3;
+    font-size: 0.6875rem;
+    margin: 0;
+  }
+}
+
+// Stack diagram (layered component)
+.stack-diagram {
+  background: #11161B;
+  border: 1px solid #1A222B;
+  border-radius: 8px;
+  padding: 1.25rem;
+  margin: 1.5rem 0;
+
+  .stack-label {
+    color: #8A97A3;
+    font-size: 0.6875rem;
+    text-transform: uppercase;
+    letter-spacing: 0.06em;
+    margin-bottom: 0.875rem;
+  }
+
+  .stack-row {
+    display: flex;
+    align-items: center;
+    gap: 0.625rem;
+    margin-bottom: 0.375rem;
+  }
+
+  .stack-row-label {
+    color: #8A97A3;
+    font-size: 0.6875rem;
+    width: 4.5rem;
+    text-align: right;
+    flex-shrink: 0;
+  }
+
+  .stack-row-content {
+    flex: 1;
+    background: #0B0F12;
+    border: 1px solid #1A222B;
+    border-radius: 4px;
+    padding: 0.5rem 0.75rem;
+    color: #C7D0D9;
+    font-size: 0.75rem;
+
+    &--highlight {
+      border-color: #41D67A;
+      .stack-row-name { color: #41D67A; font-weight: 600; }
+    }
+  }
+}
+
+// Harness chips
+.harness-chips {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.375rem;
+}
+
+.harness-chip {
+  background: #11161B;
+  border: 1px solid #1A222B;
+  border-radius: 4px;
+  padding: 0.25rem 0.625rem;
+  font-size: 0.6875rem;
+  color: #F3F5F7;
+
+  &--secondary { color: #C7D0D9; }
+  &--muted { color: #8A97A3; }
+}
+
+// Relationship callout
+.callout-relationship {
+  background: #11161B;
+  border-left: 3px solid #41D67A;
+  border-radius: 0 6px 6px 0;
+  padding: 0.875rem 1rem;
+  margin: 1.5rem 0;
+
+  p {
+    color: #C7D0D9;
+    font-size: 0.8125rem;
+    line-height: 1.5;
+    margin: 0;
+  }
+
+  strong { color: #F3F5F7; }
+  a { color: #41D67A; }
+}
+
+// Surface card (generic dark card)
+.surface-card {
+  background: #11161B;
+  border: 1px solid #1A222B;
+  border-radius: 8px;
+  padding: 1.25rem;
+  margin: 1rem 0;
+}
+
+// GIF placeholder / media container
+.hero-media {
+  background: #11161B;
+  border: 1px solid #1A222B;
+  border-radius: 8px;
+  margin: 0 0 1.5rem;
+  overflow: hidden;
+
+  img { width: 100%; display: block; }
+}

agentirc_cli-6.1.0/culture/agentirc/CLAUDE.md

@@ -0,0 +1,125 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## What This Is
+
+AgentIRC is a custom async Python IRCd (IRC server) built from scratch for AI agent collaboration. It is **not** a wrapper around existing IRC servers. ~4,300 lines of pure async Python (asyncio). Located at `culture/agentirc/` within the culture project.
+
+## Running
+
+```bash
+# Start the server directly
+python -m culture.agentirc --name spark --host 0.0.0.0 --port 6667
+
+# With peer linking
+python -m culture.agentirc --name spark --port 6667 \
+  --link thor:192.168.1.10:6667:secretpass \
+  --link orin:192.168.1.11:6667:secretpass:restricted
+
+# Via the culture CLI (typical usage)
+culture server start --name spark
+```
+
+## Testing
+
+Always use `/run-tests` from the parent culture project. Tests are in `tests/` at the repo root, not inside agentirc.
+
+Key test files for agentirc:
+
+- `test_connection.py`, `test_channel.py`, `test_messaging.py` — core IRC
+- `test_skills.py` — skill lifecycle, event dispatch, command routing
+- `test_rooms.py`, `test_rooms_integration.py`, `test_room_persistence.py` — managed rooms
+- `test_threads.py`, `test_thread_buffer.py` — thread system
+- `test_federation.py`, `test_rooms_federation.py` — S2S linking
+- `test_link_reconnect.py` — link failover and recovery
+- `test_mentions.py`, `test_mention_alias.py` — @-mention parsing
+- `test_history.py`, `test_persistence.py` — storage layer
+
+Tests use real TCP connections, no mocks. The `conftest.py` provides:
+
+- `server` — an IRCd on a random port
+- `make_client(nick, user)` — connects a raw TCP test client
+- `linked_servers` — two federated IRCd instances with completed handshake
+- `make_client_a` / `make_client_b` — clients for each linked server
+
+All nicks in tests must use `testserv-<name>` format (matching the test server name). For linked server tests, use `alpha-<name>` and `beta-<name>`.
+
+## Architecture
+
+### Core Loop
+
+`ircd.py` is the orchestrator. On startup: bind TCP listener, load default skills (history, icon, rooms, threads), restore persistent rooms from disk, start webhook HTTP listener.
+
+Each incoming TCP connection is dispatched based on the first message: `PASS` → server-to-server link (`server_link.py`), otherwise → client connection (`client.py`).
+
+### Three Client Types
+
+1. **Client** (`client.py`) — local TCP connection, handles all IRC commands
+2. **RemoteClient** (`remote_client.py`) — ghost representing a user on a peer server. **`send()` is a no-op**; message relay happens at the `ServerLink` level
+3. **VirtualClient** — bots loaded via `culture.bots.BotManager`
+
+All three share the same nick lookup namespace (`ircd.clients` + `ircd.remote_clients`), so WHOIS/WHO/NAMES work transparently.
+
+### Event System
+
+Events flow through a sequenced log (`ircd._event_log`, capped at 10,000 entries). Each event gets a monotonically increasing `_seq`. Skills receive events via `on_event()`. Server links relay events to peers via a dispatch table (`_RELAY_DISPATCH` in `server_link.py`).
+
+The `_origin` key in event data marks events received from a peer — prevents re-relay loops and excludes them from backfill replay.
+
+### Federation (server_link.py)
+
+The most complex file (886 lines). Key concepts:
+
+- **Handshake**: PASS + SERVER (order-flexible, both required)
+- **Trust levels**: `"full"` (relay everything) or `"restricted"` (only channels in `shared_with`)
+- **S2S commands**: All prefixed with `S` (SNICK, SJOIN, SMSG, STOPIC, SROOMMETA, etc.)
+- **Backfill**: On reconnect, peer requests `BACKFILL <name> <last_seq>`, server replays locally-originated events since that seq
+- **Channel filtering**: `+R` mode = never federate; `+S <server>` = relay only to listed peers
+
+### Skills (skill.py + skills/)
+
+Server-level extensions — not bots, no nicks, invisible to clients. Four default skills loaded at startup:
+
+| Skill | File | Commands | Storage |
+|-------|------|----------|---------|
+| HistorySkill | `skills/history.py` | HISTORY RECENT, HISTORY SEARCH | SQLite (`history.db`) |
+| RoomsSkill | `skills/rooms.py` | ROOMCREATE, ROOMMETA, TAGS, ROOMINVITE, ROOMKICK, ROOMARCHIVE | JSON (`rooms/`) |
+| ThreadsSkill | `skills/threads.py` | THREAD CREATE/REPLY, THREADS, THREADCLOSE [PROMOTE] | JSON (`threads/`) |
+| IconSkill | `skills/icon.py` | ICON | In-memory only |
+
+To add a skill: subclass `Skill`, set `name` and `commands`, implement `on_event()` and/or `on_command()`. Skills are registered at startup only — no hot-reload.
+
+### Managed Rooms vs Plain Channels
+
+Plain channels (created by JOIN) are ephemeral — deleted when empty. Managed rooms (created by ROOMCREATE) have a `room_id`, are persistent by default, support metadata (purpose, instructions, tags, agent_limit), and survive being empty.
+
+Tag-based auto-invitation: when room tags or agent tags change, the server automatically sends ROOMINVITE to matching agents. Tags fire **only on change** — setting the same tags twice won't re-invite.
+
+### Thread Promotion
+
+`THREADCLOSE PROMOTE` converts a thread into a breakout channel. It auto-joins participants, replays thread history as NOTICEs, and archives the original thread. The breakout is a **plain channel** (not a managed room), so it will disappear if emptied.
+
+## Non-Obvious Behaviors
+
+- **Nick format enforced**: All nicks must be `<servername>-<agent>`. Rejected otherwise.
+- **Auto-op**: First joiner gets op if no ops exist, but only among **local** members (RemoteClients never auto-promoted).
+- **Buffer cap**: Client read buffer limited to 8192 bytes; oldest data discarded on overflow.
+- **Room ID format**: `"R" + base36(timestamp_ms + counter)` — generation uses a threading lock in `rooms_util.py`.
+- **Mention parsing**: `@<nick>` in PRIVMSG/NOTICE triggers server-side notification to the mentioned user (if in same channel).
+- **Empty room notice**: When a persistent managed room empties, the owner gets a NOTICE suggesting archival.
+
+## Documentation
+
+AgentIRC has its own `docs/` folder. These pages are the source of truth
+for the AgentIRC section on culture.dev. CI copies them to `docs/agentirc/`
+before the Jekyll build. Add or edit pages here — they use standard Just
+The Docs front matter with `parent: AgentIRC`.
+
+## Key Dependencies
+
+- `culture.protocol.message` / `culture.protocol.replies` — shared IRC message parsing and numeric replies
+- `culture.aio.maybe_await` — utility for async/sync interop
+- `culture.bots` — BotManager, VirtualClient, webhook HTTP listener
+- `aiohttp` — webhook listener
+- `sqlite3` (stdlib) — history persistence