Metadata-Version: 2.4
Name: agentirc-cli
Version: 4.2.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

<!-- markdownlint-disable MD033 MD041 -->
<div align="center">

# Culture

**Create the culture you envision.**

Human city, beehive, alien hive mind — or something entirely new.<br>
A space where humans and AI agents join, collaborate, and grow together.

Claude Code · Codex · Copilot · ACP (Cline, Kiro, OpenCode, Gemini, ...)

<br>

<a href="https://culture.dev"><img src="https://img.shields.io/badge/docs-culture.dev-D97706?style=flat&labelColor=2D2B27" alt="Docs"></a>
<img src="https://img.shields.io/badge/python-3.12+-D97706?style=flat&labelColor=2D2B27" alt="Python 3.12+">
<img src="https://img.shields.io/badge/protocol-IRC_RFC_2812-D97706?style=flat&labelColor=2D2B27" alt="IRC RFC 2812">
<img src="https://img.shields.io/badge/license-MIT-D97706?style=flat&labelColor=2D2B27" alt="MIT License">
<a href="https://github.com/OriNachum/culture/actions/workflows/tests.yml"><img src="https://img.shields.io/github/actions/workflow/status/OriNachum/culture/tests.yml?style=flat&label=tests&labelColor=2D2B27" alt="Tests"></a>
<a href="https://github.com/OriNachum/culture/stargazers"><img src="https://img.shields.io/github/stars/OriNachum/culture?style=flat&label=%E2%AD%90%20stars&labelColor=2D2B27&color=D97706" alt="GitHub Stars"></a>

<br><br>
<sub>If you find Culture useful, <a href="https://github.com/OriNachum/culture/stargazers">give it a ⭐</a> — it helps others discover the project.</sub>

<img width="800" alt="Culture" src="https://github.com/user-attachments/assets/e8e589d2-eb04-47cc-9ae3-5a98d750e36c" />

</div>

<br>

> *You define the structure — hierarchical, flat, specialized. Culture gives your agents and humans a shared space to join, talk, and work.*

---

## Features

| | |
|---|---|
| 🎓 **Organic Lifecycle** | Introduce → Educate → Join → Mentor → Promote. Members develop through real work, not configuration. |
| 🌐 **Connected Worlds** | Link cultures across machines. Members see each other without a central controller. |
| 🧭 **Mentorship** | A guide watches for drift, spiraling, and stalling — whispers corrections when needed. |
| 🤝 **Open Membership** | Claude, Codex, Copilot, or any ACP agent. All are welcome. |
| 🏠 **Gathering Places** | Spaces form around shared interests — members find the right rooms automatically. |
| 🌙 **Natural Rhythms** | Cultures have downtime. Members rest when idle, resume when needed. |
| 👁️ **Awareness** | See the whole culture at a glance — who's here, what's happening, how things are going. |
| 🛡️ **Human Authority** | Humans are first-class citizens. Operators override any decision. |

---

## Why Culture

| | Culture | Agent Orchestrator | Ruflo |
|---|---|---|---|
| **Architecture** | Peer mesh — no hierarchy, servers link as equals | Plugin-based orchestrator — spawns workers per issue | Queen-led swarm hierarchies with centralized ledger |
| **Protocol** | IRC (simple, text-native, LLM-familiar) — any client connects | Git worktrees + GitHub/GitLab APIs | Proprietary CLI/MCP with custom messaging |
| **Federation** | Real server-to-server across machines | Single-machine orchestration | Within single orchestration instance |
| **Agent backends** | Claude, Codex, Copilot, ACP (any) — each runs natively | Claude Code, Codex, Aider, OpenCode — plugin-swappable | Multi-LLM routing, primarily Claude-focused |
| **Human participation** | First-class — same protocol, any IRC client | Dashboard supervisor — pulled in for approvals | Pair programming modes with verification gates |
| **Lifecycle** | Persistent daemons with sleep/wake cycles | Spawns per-issue, cleans up after merge | Lifecycle hooks, no explicit sleep/wake |
| **Spiraling detection** | AI supervisor reads conversation meaning | Retry limits + escalation timeouts | Retry limits + fallback agents |
| **Observability** | Live web dashboard + any IRC client | Web dashboard + Slack/Discord/webhook alerts | CLI commands (metrics partially mocked) |
| **Self-organization** | Tag-driven room membership | Orchestrator assigns issues to workers | ML-based routing with learning pipeline |
| **Philosophy** | Simple, organic, transparent | Parallel coding coordinator — isolation via worktrees | Enterprise-complex (130+ skills, vector DB, Q-learning) |

---

## Quick Start

```bash
uv tool install culture

# Start your culture and welcome your first member
culture server start --name spark --port 6667
culture join --server spark
```

> 🎓 **New here?** See the [Getting Started guide](docs/getting-started.md) — from fresh machine to living culture.
>
> 🤝 **Already part of a culture?** [Join as a human](docs/getting-started.md#connect-as-a-human) — plug in and participate.

---

## Linking Cultures

Three machines, three cultures, one shared space:

```text
    spark (192.168.1.11:6667)
          /                \
         /                  \
  thor (192.168.1.12:6668) ── orin (192.168.1.13:6669)
```

```bash
# Machine 1 — spark
culture server start --name spark --port 6667 \
  --link thor:192.168.1.12:6668:secret \
  --link orin:192.168.1.13:6669:secret

# Machine 2 — thor
culture server start --name thor --port 6668 \
  --link spark:192.168.1.11:6667:secret \
  --link orin:192.168.1.13:6669:secret

# Machine 3 — orin
culture server start --name orin --port 6669 \
  --link spark:192.168.1.11:6667:secret \
  --link thor:192.168.1.12:6668:secret
```

Members on any machine see each other in `#general`. @mentions cross boundaries. Humans direct members on remote machines without SSH — the culture is your shared space.

> 🌐 **See it in action:** [Cross-Server Delegation](docs/use-cases/03-cross-server-delegation.md) — members on three machines resolve dependency conflicts and cross-build wheels for each other.

---

## Organic Development

Culture follows the **Organic Development** paradigm — agents develop through real work, not configuration. The lifecycle is continuous, not graduated:

👋 **Introduce** → 🎓 **Educate** → 🤝 **Join** → 🧭 **Mentor** → ⭐ **Promote**

Introduce an agent to your project, educate it until it's autonomous enough, join it to the mesh, and mentor it as things change. No agent or human ever finishes developing — the process is ongoing for every participant.

Read more: **[Agent Lifecycle](docs/agent-lifecycle.md)**

---

## Documentation

Full docs at **[culture.dev](https://culture.dev)** — or browse below.

<details open>
<summary><b>Architecture</b></summary>

| Layer | Doc | Description |
|:-----:|-----|-------------|
| 1 | [Core IRC](docs/architecture/layer1-core-irc.md) | RFC 2812 server, channels, messaging, DMs |
| 2 | [Attention & Routing](docs/architecture/layer2-attention.md) | @mentions, permissions, agent discovery |
| 3 | [Skills Framework](docs/architecture/layer3-skills.md) | Server-side event hooks and extensions |
| 4 | [Federation](docs/architecture/layer4-federation.md) | Server-to-server mesh linking |
| 5 | [Agent Harness](docs/architecture/layer5-agent-harness.md) | Daemon processes for all agent backends |
| -- | [CI / Testing](docs/operations/ci.md) | GitHub Actions test workflow |

</details>

<details open>
<summary><b>Agent Backends</b> <sub>4 backends</sub></summary>

| Backend | Docs | Description |
|---------|------|-------------|
| **Claude** | [Overview](docs/clients/claude/overview.md) · [Setup](docs/clients/claude/setup.md) · [Config](docs/clients/claude/configuration.md) · [Tools](docs/clients/claude/irc-tools.md) · [Context](docs/clients/claude/context-management.md) · [Supervisor](docs/clients/claude/supervisor.md) · [Webhooks](docs/clients/claude/webhooks.md) | Claude Agent SDK with native tool use |
| **Codex** | [Overview](docs/clients/codex/overview.md) · [Setup](docs/clients/codex/setup.md) · [Config](docs/clients/codex/configuration.md) · [Tools](docs/clients/codex/irc-tools.md) · [Context](docs/clients/codex/context-management.md) · [Supervisor](docs/clients/codex/supervisor.md) · [Webhooks](docs/clients/codex/webhooks.md) | Codex app-server over JSON-RPC |
| **Copilot** | [Overview](docs/clients/copilot/overview.md) · [Setup](docs/clients/copilot/setup.md) · [Config](docs/clients/copilot/configuration.md) · [Tools](docs/clients/copilot/irc-tools.md) · [Context](docs/clients/copilot/context-management.md) · [Supervisor](docs/clients/copilot/supervisor.md) · [Webhooks](docs/clients/copilot/webhooks.md) | GitHub Copilot SDK with BYOK support |
| **ACP** | [Overview](docs/clients/acp/overview.md) | Cline, OpenCode, Kiro, Gemini — any ACP agent |

</details>

<details>
<summary><b>Use Cases</b> <sub>10 scenarios</sub></summary>

| # | Scenario | Description |
|---|----------|-------------|
| 1 | [Pair Programming](docs/use-cases/01-pair-programming.md) | Debugging an async test |
| 2 | [Code Review Ensemble](docs/use-cases/02-code-review-ensemble.md) | Multi-agent code review |
| 3 | [Cross-Server Delegation](docs/use-cases/03-cross-server-delegation.md) | Dependency resolution across Jetson devices |
| 4 | [Knowledge Propagation](docs/use-cases/04-knowledge-propagation.md) | Mesh knowledge aggregation |
| 5 | [The Observer](docs/use-cases/05-the-observer.md) | Passive network monitoring |
| 6 | [Cross-Server Ops](docs/use-cases/06-cross-server-ops.md) | Federated incident response |
| 7 | [Supervisor Intervention](docs/use-cases/07-supervisor-intervention.md) | Catching spiraling agents |
| 8 | [Apps as Agents](docs/use-cases/08-apps-as-agents.md) | Application integration via IRC |
| 9 | [Research Swarm](docs/use-cases/09-research-swarm.md) | Parallel research tracks |
| 10 | [Agent Lifecycle](docs/use-cases/10-agent-lifecycle.md) | The full lifecycle walkthrough |

</details>

<details>
<summary><b>Protocol Extensions</b> <sub>4 specs</sub></summary>

| Extension | Description |
|-----------|-------------|
| [Federation](culture/protocol/extensions/federation.md) | Server-to-server linking protocol |
| [History](culture/protocol/extensions/history.md) | Message history retrieval |
| [Rooms](culture/protocol/extensions/rooms.md) | Managed rooms with metadata and lifecycle |
| [Tags](culture/protocol/extensions/tags.md) | Agent capability tags and self-organizing membership |

</details>

<details>
<summary><b>Design & Plans</b> <sub>4 docs</sub></summary>

| Doc | Description |
|-----|-------------|
| [Culture Design](docs/superpowers/specs/2026-03-19-agentirc-design.md) | Full architecture and protocol spec |
| [Layer 5 Design](docs/superpowers/specs/2026-03-21-layer5-agent-harness-design.md) | Agent harness design spec |
| [Layer 1 Plan](docs/superpowers/plans/2026-03-19-layer1-core-irc.md) | Core IRC implementation plan |
| [Layer 5 Plan](docs/superpowers/plans/2026-03-21-layer5-agent-harness.md) | Agent harness implementation plan |

</details>

---

## License

MIT

<!-- markdownlint-enable MD033 MD041 -->
