Documentation
Put Fabric to work
Fabric is a local-first multi-agent runtime for terminal, desktop, web, messaging, API, and IDE workflows. Start with one useful task, then add memory, skills, automation, and operational views as you need them.
What do you want to do?
Start
Get to a working prompt
Install Fabric, connect one model route, and verify a real tool-assisted task.
Accounts
Use a subscription you own
Connect a supported ChatGPT or xAI account with a profile-scoped browser approval flow.
Local models
Keep inference on your machine
Run a keyless Ollama model and understand the boundary between local inference and an air gap.
Interfaces
Work where you are
Choose the native desktop app, CLI, full-screen TUI, a messaging channel, or the web experience's coordinated Workspace and Admin surfaces.
Capabilities
Build a reusable workflow
Give Fabric durable memory, focused skills, scheduled jobs, and delegated work.
Operations
Run it with confidence
Inspect the effective profile, repair an install, and review platform and security boundaries.
The shortest useful path
On macOS, Linux, or WSL2, install Fabric and prove one model route before adding more providers or automation:
curl -fsSL https://raw.githubusercontent.com/ObliviousOdin/fabric/main/scripts/install.sh | bash
fabric model
fabric status --deep
Then run fabric and ask it to complete a small, observable task in a non-secret
workspace. A model appearing in a picker is not the same as a successful request;
the Quickstart shows the complete verification loop.
Profiles and the web experience
Your selected profile owns an agent's model routes, credentials, memory, skills, approval policy, and sessions across supported interfaces. In the web experience, Workspace organizes agent work and Admin exposes runtime controls. A profile remains an isolated agent configuration; it is not a tenant, team workspace, site, or human role.
- See and compose work: Desktop or Fabric Workspace
- Stay in the terminal: CLI or TUI
- Keep a conversation running: Messaging gateway
- Connect applications and editors: API server, ACP, or MCP
The responsive Workspace/Admin shell, route structure, Home, and three-panel Chat are available now, alongside Design and the persistent SQLite-backed Work surface with Board, Graph, and Outline views. Chat projects Task, Evidence, and Artifacts from the existing TUI event stream on a best-effort basis; Memory shows the selected profile's provider/configuration status. Server-enforced enterprise tenancy and roles, durable approvals, unified activity, and a provider-neutral typed Memory ledger remain staged backend contracts. The delivery map keeps this boundary explicit.
Install from this repository or from a release published on the
ObliviousOdin/fabric release page.
Published desktop packages should include the expected checksum and platform signature.
Need an exact answer?
Use the Reference for command syntax, configuration keys, model
and skill catalogs, and troubleshooting. Required copyright and attribution
notices are preserved in LICENSE
and NOTICE.