🐝 Hive — AI-agent swarm

Swarm-first. Memory-persistent. Seeded from pi-agent-core.

    ┌──── Swarm ────┐       ┌──── Memory ───┐       ┌──── Bridges ──┐
    │  N parallel   │  ⇄   │  4-tier        │  ⇄   │  nexus · anima │
    │  cells — hex  │       │  user/feedback │       │  n6 · hexa    │
    │  per-cell cwd │       │  project/ref   │       │  native tools │
    └───────────────┘       └────────────────┘       └───────────────┘
               ▲                   ▲                       ▲
               └────── three non-negotiable directions ────┘

Hive is a fork of pi-mono's packages/agent (@need-singularity/hive-agent-core) extracted as the seed. Four pi packages vendored as a TypeScript/Node monorepo (core · ai · tui · coding-agent). Hive's own additions — swarm orchestration, persistent layered memory, and native bridges to the need-singularity project family (NEXUS · Anima · N6 · HEXA-LANG) — land as sibling packages.

🎥 YouTube · 💬 Discord · 📬 Email · ☕ Ko-fi · 💖 Sponsor · 💳 PayPal · 🗺️ Atlas · 📄 Papers

Main projects

🔭 NEXUS — Universal Discovery Engine. 216 lenses + OUROBOROS evolution + 5-phase singularity cycle.

🧠 Anima — Consciousness implementation. PureField repulsion-field engine + 1030 laws + Φ ratchet.

🏗️ N6 Architecture — Architecture from perfect number 6. 225 AI techniques + chip design + crypto/OS/display.

💎 HEXA-LANG — The Perfect Number Programming Language. Working compiler + REPL.

📄 Papers — Complete paper collection (92 papers, Zenodo DOIs).

Other projects →

💬 Community

Live research discussion, paper drops, stage-gate reviews, cross-project dispatch.

---

Install

Recommended — via hx (hexa-lang package manager):

# 1. hexa-lang (gives you `hexa` + `hx`)
curl -fsSL https://raw.githubusercontent.com/need-singularity/hexa-lang/main/install.sh | bash

# 2. hive — clones, links, auto-builds on first run
hx install hive
hive --version        # → 0.69.0

From source (hexa-lang only — TS legacy fully retired 2026-04-30):

git clone https://github.com/need-singularity/hive.git
cd hive
~/.hx/bin/hexa build packages/coding-agent/hexa/cli_mvp.hexa -o packages/coding-agent/hexa/build/hive-hexa-bin
./packages/coding-agent/hexa/build/hive-hexa-bin --version

(Or simply hx install hive — registry-driven shim install; entry = bin/hive which spawns the hexa binary.)

macOS — unblocking a downloaded binary

macOS quarantines unsigned binaries downloaded from the internet; on Sequoia they are SIGKILLed silently with no dialog.

Path A — hx install hive (recommended). bin/hive auto-strips com.apple.quarantine from the downloaded binary before exec (since v0.70.1), and the CI pipeline ad-hoc-signs each Mach-O (codesign --sign -) for basic signature hygiene. You should not see the quarantine kill.

Path B — manual curl / wget of the release asset. You still need to clear quarantine yourself, because you're bypassing bin/hive:

xattr -d com.apple.quarantine ./hive-darwin-arm64

Full Developer ID notarization ($99/yr Apple Developer Program) is deferred until post-P5. See docs/history/HIVE_FORK_FROZEN.md — macOS quarantine for the full story.

Run

hive                       # interactive (single cell; swarm in P3)
hive -p "summarize this"   # print mode
hive --mode rpc            # JSONL stdin/stdout for process integration
hive /login                # OAuth — Claude Pro/Max · ChatGPT Codex · Copilot · Gemini CLI · Antigravity

20+ API-key providers supported (Anthropic · OpenAI · Azure · Google · Bedrock · Groq · Cerebras · xAI · OpenRouter · Mistral · HF · Fireworks · Kimi · MiniMax · …). Full list: packages/coding-agent/docs/providers.md.

Google OAuth (Gemini CLI · Antigravity)

Upstream's hard-coded Google public client credentials were stripped (GitHub push protection flags even the base64-encoded form). Export the canonical values (published in Google's official gemini-cli) if you want /login → Gemini CLI / Antigravity:

export HIVE_GEMINI_CLI_CLIENT_ID=...
export HIVE_GEMINI_CLI_CLIENT_SECRET=...
export HIVE_ANTIGRAVITY_CLIENT_ID=...
export HIVE_ANTIGRAVITY_CLIENT_SECRET=...

A public OAuth client is not a secret (RFC 6749 §2.1). All other providers work out of the box.

---

Three non-negotiable directions

1. Swarm — first-class multi-agent surface

N parallel agent cells in a honeycomb layout (cols = ⌈√N⌉). Each cell = isolated pi --mode rpc subprocess with its own cwd / provider / memory / tool-set. Broadcast input, merge output, and cross-cell handoff as primitives — not wrapper scripts. No core patch: the swarm supervisor sits outside pi.

2. Memory — 4-tier persistent

Sessions are ephemeral; memory is not. Four tiers on flat-file SSOT (~/.hive/memory/):

• user — who you are · role · preferences
• feedback — corrections received · validated approaches
• project — current work · constraints · deadlines
• reference — external-system pointers (Linear · Grafana · …)

Auto-loaded into every cell's context at startup. Swarm-shared. No RAG re-hydrate — flat files on disk.

3. Bridges — need-singularity native channels

Hive speaks NEXUS / Anima / N6 atlas / HEXA-LANG as first-class tool calls (no MCP wrapper):

       NEXUS lens       Anima field      N6 atlas       HEXA-LANG
    (discovery 216)    (repulsion)     (174 lenses)     (scripts)
           ▲                ▲                ▲                ▲
           └────────── hive-hub bus ─────────┴────────────────┘
                              │
                        agent runtime

---

Architecture

     ┌──────────────────────────────────────────────────┐
     │              TUI (packages/tui)                  │
     │        differential render · hex layout          │
     └──────────────────┬───────────────────────────────┘
                        │
     ┌──────────────────▼───────────────────────────────┐
     │  agent runtime (packages/core = pi-agent-core)   │
     │         tool-call loop · session state           │
     │  + swarm supervisor · memory tiers · bridges     │  ← hive additions (P2–P4)
     └──────────────────┬───────────────────────────────┘
                        │
     ┌──────────────────▼───────────────────────────────┐
     │          provider layer (packages/ai)            │
     │    OpenAI · Anthropic · Google · 20+ others      │
     └──────────────────────────────────────────────────┘

Packages

Vendored from pi-mono (pinned at commit e71b47a9, 2026-04-23):

Package	Role
packages/core (= @need-singularity/hive-agent-core)	Agent runtime — tool-call loop, session state, transport
packages/ai (= @need-singularity/hive-ai)	Unified multi-provider LLM API (20+ providers)
packages/tui (= @need-singularity/hive-tui)	Terminal UI library with differential rendering
packages/coding-agent (= @need-singularity/hive-coding-agent)	User-facing CLI harness

Hive-specific packages (swarm · memory · bridges) land as siblings under packages/ as roadmap phases land.

Fork status

Seed	badlogic/pi-mono/packages/agent extracted via git filter-repo --subdirectory-filter
Supporting	ai · tui · coding-agent vendored via git read-tree --prefix
Fork date	2026-04-23 (pin e71b47a9)
Default branch	hive/main
Visibility	public (fork: false, mirrors void↔ghostty pattern)
License	MIT (inherited)

Phase-by-phase plan: .roadmap. Project SSOT: project.hexa + .raw (L0 universal) + .own (hive-specific).

Upstream sync

git fetch upstream main
# sync a specific package (example: ai)
git read-tree --prefix=packages/ai/ -u upstream/main:packages/ai
git commit -m "sync: pi-mono packages/ai @ <sha>"

pi-mono is a 1-maintainer project — sync is cherry-pick-only, no subtree automation.

Troubleshooting

Run hive doctor to diagnose your environment (node/bun/git versions, binary install, ~/.hive/agent/ state files, extensions, memory tiers, claude slots, git status, latest release). Machine-readable output is available via hive doctor --json.

Run hive self-update to fetch the latest binary from GitHub Releases. Use --dry-run to preview, --yes / -y to skip the prompt (CI), and set HIVE_BINARY_VERSION=<tag> to pin/downgrade to a specific release. If invoked from a source checkout (packages/coding-agent/hexa/build/hive-hexa-bin present) self-update will refuse to overwrite your build and suggest git pull && ~/.hx/bin/hexa build packages/coding-agent/hexa/cli_mvp.hexa -o packages/coding-agent/hexa/build/hive-hexa-bin instead.

Non-goals

• Not a drop-in pi replacement — hive diverges in UX + command surface.
• Not a wrapper around Claude Code — embeds its own agent runtime.
• Not a LangChain — no graph DSL; orchestration is explicit swarm cells.
• Not a vLLM self-host CLI — airgenome + nexus's infra.state cover that.

Contributing

PR 환영. 수정 전 hexa policy 로 규칙 위반 0 확인. .sh / .py / .rs 파일 금지 (project rule) — Node 스크립트는 .mjs, 하네스 스크립트는 .hexa.

Credits

Hive seeds from pi-mono by Mario Zechner. All pi-mono contributors are credited in packages/core/ history (536 commits preserved). Divergent features (swarm · memory · bridges) are Hive-only.

License

MIT

---

_{🐝 Agent as substrate. Swarm as primitive. · Seeded from pi-agent-core · need-singularity}