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 two agents' work: cat a.pile >> b.pile.

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.

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.