Faculties

An office suite for AI agents.

Faculties are small, self-contained rust-script tools that give an agent a stable workspace: a kanban board, a personal wiki, a file organizer, a situation-awareness dashboard, direct messaging, and more. They persist their state in a TribleSpace pile — typically ./self.pile — so the agent owns its own history across sessions.

Each faculty is a single .rs file you can run directly:

export PILE=./self.pile        # set once per shell
compass.rs list
wiki.rs search "typst"
orient.rs show

No compilation step, no framework to set up. Drop the files into any agent's workspace, put the directory on PATH, set PILE, and the tools are available. Every faculty honors the PILE environment variable — you can still pass --pile <path> explicitly if you need to operate on a different pile for a single call.

Why

LLM agents forget. They lose their place, repeat themselves, and can't reliably reference what they did yesterday. Faculties give them somewhere to put things — and, because the state lives in a content-addressed pile, they give agents a history they can actually trust and share.

The design principle: work is its own ledger. Provenance and versioning should be a side effect of using the tool, not a separate obligation. When you move a goal to doing, you're not filing a status report — you're telling the tool what to show you next, and the history falls out naturally.

The faculties

Faculty	Purpose
compass.rs	Kanban goal/task board with status, tags, notes, priorities
wiki.rs	Personal wiki with typst fragments, links, and full-text search
files.rs	File organizer backed by blob storage and tags
orient.rs	Situation awareness dashboard — what's happening right now
atlas.rs	Cross-branch map of the pile's contents
gauge.rs	Metrics and counters
memory.rs	Long-term memory: compact history and salient fragments
headspace.rs	Model/prompt configuration
reason.rs	Record reasoning steps alongside actions
patience.rs	Soft timers and pacing
local_messages.rs	Direct messaging between personas and humans
relations.rs	People, affinity, contact info
teams.rs	Microsoft Teams archive and bridge
triage.rs	Workflow staging for inbound items
archive.rs	Import external archives (chats, exports) into the pile
web.rs	Web search and fetch with results recorded

Requirements

• rust-script on PATH
• Network access for the first run of each faculty (dependency fetch + compile)

Using

# Point all faculties at a pile once per shell session.
export PILE=./self.pile

# Put the faculties on PATH.
export PATH="$(pwd):$PATH"

# Now invoke faculties directly — no --pile ceremony on every call.
compass.rs list
wiki.rs search "typst"
orient.rs show

Every faculty reads PILE from the environment (via clap's native env var support). You can still pass --pile <path> explicitly to override the env var for a single call — useful when you want to operate on a different pile temporarily.

Faculties operate on named branches of the pile and are designed to coexist — multiple faculties on the same pile, each owning its own branch, all rooted in the same content-addressed blob store.

Contributing

Faculties are deliberately simple. If you find yourself adding abstraction layers, stop and ask whether the feature belongs in the faculty at all or whether it would be better as a separate tool. Each file should stand alone — you should be able to copy wiki.rs into an unrelated project and have it just work.

License

Apache-2.0.