Tri-Head Architecture
How Sigil Wallet's three interfaces share a single brain.
Sigil Wallet operates through three synchronized interfaces — the CLI, TUI, and Web Dashboard — all connected to a shared core backend via WebSockets. We call this the Tri-Head Architecture.
System Overview
The Three Heads
CLI — Headless Automation
The CLI (sigil <command>) is designed for scripting and background operation. It communicates with the core server via REST API calls to localhost:7445.
Use cases:
- Cron jobs and scheduled operations
- CI/CD pipeline integration
- Scriptable agent management
- Quick one-off commands
TUI — Interactive Terminal
The TUI is a full-screen terminal dashboard built with Ink (React for CLI). It connects to the core over WebSocket for real-time updates.
Features:
- Live agent status and heartbeats
- Real-time log streaming
- Agent switching with keyboard navigation
- Guardrail management
Web Dashboard — Visual Interface
The Dashboard is a React application served locally on port 7445. It provides a graphical interface for users who prefer a browser-based experience.
Features:
- Chat interface for agent interaction
- Transaction history and analytics
- Guardrail creation and management
- Provider configuration
Real-Time Synchronization
All three interfaces receive the same WebSocket events from the core:
| Event | Payload |
|---|---|
agent:thought | { agentId, text, timestamp } |
agent:action_pending | { agentId, toolName, params } |
agent:guardrail_status | { agentId, status, reason? } |
agent:transaction_success | { agentId, signature, amount, token } |
system:killed | {} (broadcast to all) |
This means starting an agent from the CLI is immediately reflected in both the TUI and Dashboard — no refresh needed.