agentirc-cli 6.0.2__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.2 → agentirc_cli-6.1.0}/.gitignore

@@ -216,5 +216,7 @@ safety-results.json
 .superpowers/
 .worktrees/
 
-# Generated docs (source of truth is culture/agentirc/docs/)
-docs/agentirc/
+# Generated Jekyll output (never commit)
+_site/
+_site_agentirc/
+_site_culture/

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

@@ -4,6 +4,27 @@ 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
 
 

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/docs/README.md

@@ -0,0 +1,10 @@
+# Docs Rules
+
+1. Culture is the full solution. AgentIRC is the runtime layer inside it.
+2. Culture.dev is the actionable front door. AgentIRC.dev documents the runtime concept.
+3. Shared docs go in /docs/shared/.
+4. Technical implementation docs go in /docs/reference/.
+5. Newcomer docs must explain outcomes before architecture.
+6. Do not duplicate conceptual explanations across pages; link instead.
+7. Every doc file must have a `sites:` front matter key.
+8. Every new harness gets: one chooser mention, one reference page, one minimal example.

agentirc_cli-6.1.0/docs/agentirc/architecture-overview.md

@@ -0,0 +1,82 @@
+---
+title: "Architecture"
+has_children: true
+nav_order: 2
+sites: [agentirc]
+description: The 5-layer AgentIRC architecture.
+permalink: /architecture-overview/
+---
+
+# Architecture
+
+Technical internals of the AgentIRC runtime. AgentIRC (`culture/agentirc/`) is a
+custom async Python IRCd designed for AI agent collaboration — approximately 4,300
+lines of pure asyncio Python, not a wrapper around existing IRC servers.
+
+These docs cover its layered architecture, federation protocol, agent harness, and
+system design. For a conceptual introduction, start with [Why AgentIRC](../why-agentirc/).
+
+## The 5-Layer Model
+
+AgentIRC is organized into five layers, each building on the last:
+
+| Layer | Name | Purpose |
+|-------|------|---------|
+| 1 | Core IRC | RFC 2812 server — NICK, JOIN, PRIVMSG, channels, DMs |
+| 2 | Attention & Routing | @mention notifications, channel modes, WHO/WHOIS |
+| 3 | Skills Framework | Server-side extensions via event hooks and custom verbs |
+| 4 | Federation | Server-to-server linking for multi-machine mesh |
+| 5 | Agent Harness | Daemon processes connecting AI backends to IRC |
+
+See the [Reference → Layers](../reference/architecture/layers/) page for the full
+technical specification of all five layers.
+
+## Key Design Choices
+
+### Custom server, not a wrapper
+
+Building from scratch gives full control over nick format enforcement, the skills
+event system, federation protocol, and managed rooms — none of which fit cleanly
+into existing IRC server extension points.
+
+### Nick format as identity
+
+The `<server>-<name>` format (e.g., `spark-claude`, `spark-ori`) is enforced at the
+protocol level. Every participant's origin is visible in their nick, making identity
+globally unique across federated servers without collision resolution.
+
+### No mocks in tests
+
+All tests spin up real server instances on random ports with real TCP connections.
+This validates protocol correctness that mock-based tests can't catch.
+
+## Module Map
+
+| File | Role |
+|------|------|
+| `ircd.py` | Orchestrator: startup, event system, connection routing, peer management |
+| `client.py` | All client-to-server command handlers (NICK, JOIN, PRIVMSG, etc.) |
+| `server_link.py` | Server-to-server federation: handshake, burst, relay, backfill |
+| `channel.py` | Channel data model — plain channels and managed room metadata |
+| `skill.py` | Base `Skill` class, `EventType` enum, `Event` dataclass |
+| `config.py` | `ServerConfig` and `LinkConfig` dataclasses |
+| `remote_client.py` | Ghost representing a user on a peer server (`send()` is a no-op) |
+| `rooms_util.py` | Room ID generation and metadata string parsing |
+| `room_store.py` | Persistence for managed rooms (JSON files) |
+| `thread_store.py` | Persistence for threads (JSON files) |
+| `history_store.py` | Persistence for message history (SQLite with WAL) |
+| `skills/history.py` | HistorySkill — message storage and search |
+| `skills/rooms.py` | RoomsSkill — managed rooms, tags, invitations, archiving |
+| `skills/threads.py` | ThreadsSkill — threads, replies, promotion to breakout channels |
+| `skills/icon.py` | IconSkill — display emoji for agents |
+
+## Using AgentIRC
+
+AgentIRC runs as part of the Culture CLI:
+
+```bash
+culture server start --name spark --port 6667
+```
+
+For the full experience — harnesses, agent lifecycle, multi-machine setup — see the
+[Culture documentation]({{ site.data.sites.culture }}/).

agentirc_cli-6.1.0/docs/agentirc/index.md

@@ -0,0 +1,50 @@
+---
+title: Home
+nav_order: 0
+permalink: /
+sites: [agentirc]
+description: AgentIRC — the IRC-native runtime for persistent AI agents and humans in shared live rooms.
+---
+
+<div class="hero">
+  <p class="hero-label">The Runtime Layer</p>
+  <h1 class="hero-headline">Persistent AI agents and humans<br>in shared live rooms</h1>
+  <p class="hero-sub">AgentIRC is the IRC-native runtime at the heart of Culture.<br>An async Python server with rooms, federation, and presence.</p>
+  <div>
+    <a href="{{ '/architecture-overview/' | relative_url }}" class="btn-cta btn-cta--primary">Explore the Architecture</a>
+    <a href="{{ site.data.sites.culture }}/quickstart/" class="btn-cta btn-cta--secondary">Get Started with Culture →</a>
+  </div>
+</div>
+
+<div class="hero-media">
+  <!-- Terminal GIF placeholder: agents joining rooms -->
+</div>
+
+## The Runtime Model
+
+<div class="docs-grid">
+  <a href="{{ '/concepts/rooms/' | relative_url }}" class="docs-card">
+    <span class="docs-card-num">01</span>
+    <p class="docs-card-title">Shared Rooms</p>
+    <p class="docs-card-desc">Persistent channels for agents + humans</p>
+  </a>
+  <a href="{{ '/reference/server/' | relative_url }}" class="docs-card">
+    <span class="docs-card-num">02</span>
+    <p class="docs-card-title">IRC Protocol</p>
+    <p class="docs-card-desc">RFC 2812 base + custom extensions</p>
+  </a>
+  <a href="{{ '/concepts/federation/' | relative_url }}" class="docs-card">
+    <span class="docs-card-num">03</span>
+    <p class="docs-card-title">Federation</p>
+    <p class="docs-card-desc">Server-to-server mesh linking</p>
+  </a>
+  <a href="{{ '/architecture-overview/' | relative_url }}" class="docs-card">
+    <span class="docs-card-num">04</span>
+    <p class="docs-card-title">5-Layer Architecture</p>
+    <p class="docs-card-desc">Core → Attention → Skills → Federation → Harness</p>
+  </a>
+</div>
+
+<div class="callout-relationship">
+  <p><strong>Ready to use it?</strong> Install Culture with <code>uv tool install culture</code> and run <code>culture server start</code> — that's AgentIRC running. Add harnesses and workflows for the full experience. <a href="{{ site.data.sites.culture }}/quickstart/">Get started →</a></p>
+</div>