agentirc-cli 6.0.2__tar.gz → 6.1.1__tar.gz

agentirc_cli-6.1.1/.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.1}/.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.1}/CHANGELOG.md

@@ -4,6 +4,39 @@ All notable changes to this project will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [6.1.1] - 2026-04-11
+
+
+### Changed
+
+- Remove Python API sections from all backend SKILL.md files — agents should use culture channel CLI exclusively
+
+
+### Fixed
+
+- IRC skill teaches agents to use internal module path instead of culture CLI (#215)
+
+## [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.1/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: agentirc-cli
+Version: 6.1.1
+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.1/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.1/_config.agentirc.yml

@@ -0,0 +1,45 @@
+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
+
+twitter:
+  username: AgenticHumanOrg
+  card: summary_large_image
+
+social:
+  name: AgentIRC
+  links:
+    - https://github.com/OriNachum/culture
+
+author:
+  name: Ori Nachum
+  twitter: AgenticHumanOrg
+
+
+# Uncomment after registering at https://search.google.com/search-console
+# google_site_verification: "YOUR_CODE_HERE"
+# webmaster_verifications:
+#   bing: "YOUR_CODE_HERE"
+
+defaults:
+  - scope:
+      path: ""
+    values:
+      layout: "default"
+      image: /assets/images/og-agentirc.png
+
+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.1/_config.base.yml

@@ -0,0 +1,55 @@
+title: ""
+description: ""
+baseurl: ""
+url: ""
+lang: en
+
+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.1/_config.culture.yml

@@ -0,0 +1,45 @@
+title: Culture
+description: >-
+  The complete human-agent collaboration system built around AgentIRC.
+url: "https://culture.dev"
+baseurl: ""
+build_site: culture
+
+twitter:
+  username: AgenticHumanOrg
+  card: summary_large_image
+
+social:
+  name: Culture
+  links:
+    - https://github.com/OriNachum/culture
+
+author:
+  name: Ori Nachum
+  twitter: AgenticHumanOrg
+
+
+# Uncomment after registering at https://search.google.com/search-console
+# google_site_verification: "YOUR_CODE_HERE"
+# webmaster_verifications:
+#   bing: "YOUR_CODE_HERE"
+
+defaults:
+  - scope:
+      path: ""
+    values:
+      layout: "default"
+      image: /assets/images/og-culture.png
+
+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.1/_data/sites.yml

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

{agentirc_cli-6.0.2 → agentirc_cli-6.1.1}/_includes/head_custom.html

@@ -1,3 +1,8 @@
 <link rel="icon" type="image/png" sizes="32x32" href="{{ '/assets/images/favicon-32x32.png' | relative_url }}">
 <link rel="icon" type="image/png" sizes="16x16" href="{{ '/assets/images/favicon-16x16.png' | relative_url }}">
 <link rel="apple-touch-icon" sizes="180x180" href="{{ '/assets/images/apple-touch-icon.png' | relative_url }}">
+{% if site.build_site == "culture" %}
+<link rel="related" href="https://agentirc.dev" title="AgentIRC">
+{% elsif site.build_site == "agentirc" %}
+<link rel="related" href="https://culture.dev" title="Culture">
+{% endif %}

agentirc_cli-6.1.1/_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.1/_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.1/_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.0.2 → agentirc_cli-6.1.1}/culture/clients/acp/skill/SKILL.md

@@ -192,31 +192,3 @@ These arrive on stderr as:
 ```
 
 Always read stderr after calling this skill.
-
-## Python API
-
-For use from Python (e.g. tests or other scripts):
-
-```python
-from culture.clients.acp.skill.irc_client import SkillClient
-
-client = SkillClient("/tmp/culture-spark-cline.sock")
-await client.connect()
-
-result = await client.irc_send("#general", "hello")
-result = await client.irc_read("#general", limit=20)
-result = await client.irc_ask("#general", "what is happening?", timeout=30)
-result = await client.irc_join("#ops")
-result = await client.irc_part("#ops")
-result = await client.irc_channels()
-result = await client.irc_who("#general")
-result = await client.irc_topic("#general")
-result = await client.irc_topic("#general", "Welcome to general chat")
-result = await client.compact()
-result = await client.clear()
-
-# Collect whispers queued during the session
-whispers = client.drain_whispers()
-
-await client.close()
-```

{agentirc_cli-6.0.2/plugins/claude-code/skills/irc → agentirc_cli-6.1.1/culture/clients/claude/skill}/SKILL.md

@@ -185,31 +185,3 @@ These arrive on stderr as:
 ```
 
 Always read stderr after calling this skill.
-
-## Python API
-
-For use from Python (e.g. tests or other scripts):
-
-```python
-from culture.clients.claude.skill.irc_client import SkillClient
-
-client = SkillClient("/tmp/culture-thor-claude.sock")
-await client.connect()
-
-result = await client.irc_send("#general", "hello")
-result = await client.irc_read("#general", limit=20)
-result = await client.irc_ask("#general", "what is happening?", timeout=30)
-result = await client.irc_join("#ops")
-result = await client.irc_part("#ops")
-result = await client.irc_channels()
-result = await client.irc_who("#general")
-result = await client.irc_topic("#general")
-result = await client.irc_topic("#general", "Welcome to general chat")
-result = await client.compact()
-result = await client.clear()
-
-# Collect whispers queued during the session
-whispers = client.drain_whispers()
-
-await client.close()
-```