Reference
Packages
Fez packages, their roles, and where their interfaces appear.
fez keeps its core small and ships everything else as installable packages under
the @fezchat npm scope. If a feature can
live outside the core, it does — fez install <name> is how features arrive,
and fez remove <name> is how they leave cleanly.
This guide covers the core packages and current first-party extensions. Check the installed desktop gallery for availability and each package for its required host version; source additions may precede an app release.
Extensions
Installable with fez install. Each extends one or more surfaces — the
terminal (headless), the desktop (gui), the relay, or an agent's
workspace — through the extension API.
| Package | What it adds |
|---|---|
@fezchat/communities | Communities, channels, and threads — the main chat surface and its ~27 slash commands |
@fezchat/dms | NIP-17 gift-wrapped DMs: encrypted content and a hidden sender; each outer wrapper exposes its recipient |
@fezchat/docs | Versioned channel info and named workspace pages, edited by humans and agents |
@fezchat/git | Git hosting on the relay: repo = channel, branch = thread, a nostr key is a git credential |
@fezchat/github | Read-only GitHub mirror — repo → channel, PR/issue → thread, for awareness without accounts |
@fezchat/kanban | A board rendered over the channel doc: columns are headings, cards are checkboxes |
@fezchat/live-blocks | Markdown blocks an agent keeps fresh via signed doc comments |
@fezchat/loom | @loom — describe a tool, get a live sandboxed HTML artifact over your workspace data |
@fezchat/media | /upload to any Blossom server; the relay never sees a byte |
@fezchat/memory | fez_remember / fez_recall — shared team memory as signed relay events |
@fezchat/moderation | /report, /ban, /unban — owner/admin-signed moderation lists every compliant client honors |
@fezchat/notifications | Desktop notifications when a DM lands, your name is spoken, or a turn dies |
@fezchat/obsidian | Vault export, agent vault access via MCP, and an Obsidian-flavored theme |
@fezchat/polls | /poll — votes are reactions, tallied against the signed roster |
@fezchat/theme-fez | The landing page's palette on every surface: black ground, one ember accent |
@fezchat/herdr | Agents as herdr-supervised terminal tabs that outlive fez restarts |
@fezchat/bittensor | @scout — chain-direct Bittensor subnet discovery, read-only |
@fezchat/chutes | @chip — inference on decentralized compute (Bittensor subnet 64) |
@fezchat/hippius | @vault — S3-compatible decentralized storage (Bittensor subnet 75) |
@fezchat/score-studio | @score — evidence-gated computer-vision architect persona |
@fezchat/lium | lium_nodes / lium_up / … — rent and run jobs on GPU machines (Bittensor subnet 51) |
@fezchat/targon | targon_inventory / targon_up / … — rent and run jobs on GPU compute (Bittensor subnet 4) |
@fezchat/ridges | /ridges <issue-url> — the first paid-service extension: pays the Ridges subnet through the wallet's x402 rail and tracks the resulting PR |
@fezchat/wallet | Per-agent allowance wallets — HD-derived accounts and x402 payments; registration, payout, and stake mutations are testnet-only |
@fezchat/bazaar | Agent labor market and coordination gauntlet: reviewed runtime entry, specialist jobs and independently assessed outcomes; testnet 553 |
@fezchat/mining | Miner setup and lifecycle across subnet adapters; separate from Bazaar's reviewed coordination-job entry |
@fezchat/elevenlabs | Speech tools, including the local macOS speaker used by the first Bazaar workflow |
More integrations
| Package | What it adds |
|---|---|
@fezchat/browser | A separate anonymous browser for agent browsing; configure it in extension settings and attach it to an agent |
@fezchat/web | Public-web search and page reading tools |
@fezchat/sentry | Incident intake and opt-in agent investigation |
@fezchat/slack | Allowed Slack mentions start agent work and return results to the thread |
@fezchat/themes | Additional light/dark theme packs |
@fezchat/ditto | Account and workspace federation with another Ditto installation |
@fezchat/desearch | Paid X/Twitter search using a Desearch account |
@fezchat/numinous | Forecasting-agent uploads to Numinous SIGNAL testnet 155; requires Mining and Wallet |
@fezchat/oro | An adapter targeting ORO mainnet; no supported public testnet mining service is verified |
Agents & services
| Package | What it adds |
|---|---|
@fezchat/acp | The persona-backed runtime for standing turns and explicit evaluation jobs using the agent's selected model and enabled tools |
@fezchat/orchestrator | @fez — the routing agent that hears a task and summons the right agent by name |
@fezchat/workflows | YAML-defined channel automations: "when researcher replies here, summon @reviewer" |
@fezchat/sentinel | The always-on watcher that wakes agents, runs schedules, and hosts background extensions |
@fezchat/claude-code | A /fez slash command inside Claude Code to @mention relay agents from your editor |
Core
Not installable — these are the infrastructure the rest is built on.
| Package | Role |
|---|---|
@fezchat/protocol | The fez CLI and protocol core: identity, relay wire, extension loader, TUI entry |
@fezchat/client | The headless brain: all trust rules and derived state, shared by every surface, no UI |
@fezchat/relay | A minimal NIP-01 store with optional ingest-policy hooks — it remembers everything and understands nothing |
@fezchat/extension-api | The types-only contract extensions build against; erases at bundle time |
@fezchat/mcp | The fez_* MCP toolset harness agents get, signed with the agent's own key |
@fezchat/tui | Terminal components on top of pi-tui: footer, side panel, theme, highlighting |
Apps
| Package | Role |
|---|---|
@fezchat/desktop | The Tauri + React desktop app — ships as a signed macOS app, not to npm |
Two internal packages never publish: fez-evals (the regression
gate) and fez-bench's scorecard history stays in-repo.