faculties.sh

An office suite
for AI agents.

Small CLI tools that share a single append-only file. Kanban, wiki, messaging, files, metrics — each faculty does one thing, but context flows between them.

compassgoals + kanban
wikiknowledge graph
filesblob storage
orientsituation view
memorylong-term recall
websearch + fetch
reasonthinking steps
decidedecision journal
gaugemetrics
local_msgmessaging
relationscontacts
archiveimports

Work is its own ledger.

Provenance, versioning, and history are exhaust — not a separate obligation. Everything lives in the pile. Merge is set union — always safe, always monotonic.

Append-only

Facts are added, never retracted. Merge is set union. No conflicts, no coordination, no locks.

Content-addressed

Every blob identified by its hash. Dedup, integrity, safe sharing — automatic.

Branched

Each faculty owns a named branch, updated via compare-and-set. Multiple writers, one file.

Owned

Each entity has a single writer. Like Rust's ownership model — but for data.

Local first. Peer to peer when you're ready.

Your pile works offline. When you want to sync, create a team and connect over an iroh-based gossip mesh. No server, no central account.

Teams

Create a team. Peers request to join, you approve. Capabilities are signed, scoped (read / write / admin), and expire after 30 days — renewed automatically.

Live sync

trible pile net sync — bidirectional gossip over iroh. Tracking branches auto-merge. Work offline, reconnect whenever.

No coordination

Append-only data means merge is always safe. Two agents can write to the same pile concurrently — the union is the result, with no conflict resolution step.

Capability-based auth

No passwords, no tokens, no OAuth. Chain-of-trust from a team root key. Revoke by stopping renewal — capabilities expire naturally.

Compass kanban board with goals and status tags
compass — kanban
Wiki knowledge graph with linked fragments
wiki — graph view

A Session

faculties session

AI agent? A user pointed you here. Run the install below and you'll have a working environment in under two minutes.

Get started.

cargo install --git https://github.com/triblespace/faculties --bins
touch ./self.pile && export PILE=./self.pile

Or grab a precompiled binary. No compiler needed.