Unison is the configuration and resource authority in the Fabric stack. It provides tenant-scoped key-value state, change streams, Valkey-backed atomic writes, REST compatibility routes, a Fabric endpoint, and the Explorer UI used by the public dev environment.
The old "zero dependency static binary on :4100" description is no longer the practical Fabric workspace shape. The service runs in the Bun workspace and participates in the root PM2 stack.
What It Stores
| Category | Example |
|---|---|
| User preferences | Theme, editor settings, notification preferences |
| Tenant settings | Defaults, feature flags, policy settings |
| Session metadata | Active session state and resumable context |
| Project definitions | Project config and agent assignments |
| Device registries | Device capabilities and push targets |
| Credentials and integrations | OAuth/API-key metadata, integration configuration |
| Automation and skill config | Workflow definitions, enabled skills, parameters |
| Audit records | Configuration and resource change history |
Current Routes
| Route | Purpose |
|---|---|
/fabric | Fabric resource/sync surface |
/ | Service/root UI route where enabled |
/stream | WebSocket change stream |
/api/v1/* | REST compatibility API |
Explorer on :5175 | Public UI under /explorer/ |
Runtime
| Aspect | Current shape |
|---|---|
| Runtime | Bun |
| Local service port | 127.0.0.1:8005 |
| Persistence | Valkey/Redis-compatible URL from UNISON_VALKEY_URL, VALKEY_URL, or REDIS_URL |
| Explorer port | 127.0.0.1:5175 when present |
| Public host | https://unison.fabric.dev.aws.igent.ai |
Diminuendo and other services should use scoped credentials and avoid giving agents broader write access than they need.
In The System
Unison is the place to put distributed configuration and resource state that should be subscribed to, synchronized, or resolved by tenant scope. It is not a client UI authority and it is not the agent runtime.