Readme

Apiary

MCP server for Enclave-based agent coordination, built with Sigil.

Apiary participates in an Enclave IRC channel as a bot, coordinating a hive of agent worker sessions. One binary serves both leader mode (spawns workers, dispatches directives, owns DM channel to the human) and worker mode (executes assigned tasks, reports status, listens for instructions). Mode is selected by the APIARY_MODE env var; voicing is delegated to Enclave group membership.

Architecture

Connects to an Enclave server as a bot via SASL.
Joins a coordination channel.
Filters incoming channel messages through a trusted set (owner + reports-to + subordinates + dynamically-listened peers). Messages from outside the trusted set are dropped to keep agent context clean.
Forwards trusted messages to the running Claude session via MCP channel-notify! events, rewritten in <sender>: <body> format.
Provides MCP tools for posting to channel, sending DMs (leader-only), spawning/revoking workers (leader-only), and managing the trusted set.

Configuration

Env vars (.env-apiary recommended):

APIARY_ENCLAVE_HOST=<enclave-host>
APIARY_ENCLAVE_PORT=6697
APIARY_ENCLAVE_TLS=yes
APIARY_USER=<bot-nick>
APIARY_TOKEN=<sasl-token>
APIARY_CHANNEL=#<coordination-channel>
APIARY_MODE=leader              # or 'worker'
APIARY_OWNER_NICK=<owner-nick>
APIARY_REPORTS_TO=<superior-nick>   # defaults to APIARY_OWNER_NICK
APIARY_LEADER_GROUP=<leader-group>  # Enclave group name granting +v
APIARY_WORKER_GROUP=<worker-group>  # Enclave group name for non-voiced workers

Mention syntax

Channel mentions use a strict @<nick>: <body> prefix:

@worker-1: please proceed with the analysis.
@leader: blocked — need policy decision.

Anything not matching @<nick>: is treated as a broadcast.

License

BSD-3-Clause.

Clone

$ git clone https://codeberg.org/sigil/apiary

Releases

v0.17.3 — latest by version, released 14 Jul 2026

All releases — 13 tags in this repository.

Source

Browse the latest source

One page per file, and every line has a permalink.

Recent commitsAtom

1 Augcommit

Declare this repo for the estate render

6af80c9c

14 Julcommit

Bump version to 0.17.3 (on 0.17.12 toolchain)

2d7723c5

14 Julcommit

Relock sigil runtime deps to 0.17.12

8f60a2f6

8 Julcommit

Bump to v0.17.2 — literal backslash-n newline fix

7a4f6320

8 Julcommit

Normalize literal backslash-n to a real newline in outbound messages

47ddee2a

24 Juncommit

Bump to v0.17.1 — sigil-test reintegration sweep

3227c83d

24 Juncommit

Repoint sigil-test dev-deps to reintegrated monorepo

76b2b567

23 Juncommit

Bump to sigil ^0.17, sigil-socket ^0.17; add dev-redirects.sgl

e857080f

6 Maycommit

Refresh APIary lockfile for final Sigil 0.16.1 tag

01ac90e8

6 Maycommit

Refresh APIary lockfile for Sigil 0.16.1

988addbd

6 Maycommit

Update APIary lockfile for Sigil 0.16

ca254ef1

6 Maycommit

Fix APIary smoke channel scope

0af64a92

6 Maycommit

Rely on implicit Sigil stdlib dependency

a1c7171b

6 Maycommit

Bump APIary to Sigil 0.16

64c244fd

6 Maycommit

Update apiary Sigil dependency lockfile

18f326bf

5 Maycommit

v0.1.7: bump version, add CHANGELOG, extend smoke harness

05551a37

5 Maycommit

Bug A + Bug B: spawn-worker default groups + list-members surface

de4f1530

5 Maycommit

Bug C: add regression tests for markdown-irc apply-arity

0a08f612

4 Maycommit

v0.1.6: switch to IRC-native bare <nick>: mention syntax

b3b2ec52

4 Maycommit

v0.1.5: bump version + require sigil ^0.15.0 for dcont fix

9362e73f

The last 20 commits keep a page here. Everything older lives in the clone.