Multi-Agent Management
Run dozens of isolated autonomous agents from a single machine.
Sigil Wallet is designed for parallel autonomy. You can create and manage multiple independent agents, each with its own wallet, directives, and reasoning loop.
Isolation by Design
Every agent is a completely isolated entity:
| Resource | Isolation |
|---|---|
| Wallet | Each agent has its own unique Ed25519 keypair |
| Guardrails | Rules for Agent A never affect Agent B |
| Logs | Reasoning traces are stored separately per agent |
| Guardrails | Each agent has independent safety limits |
| Loop | Each agent runs its own setInterval cycle |
Agent Management
Create an Agent
sigil agent create --name "treasury"
sigil agent create --name "minter"
sigil agent create --name "watcher"List All Agents
sigil agent listStart / Pause / Destroy
sigil agent start treasury
sigil agent pause treasury
sigil agent destroy treasuryAgent Info
sigil agent info treasuryShows the agent's wallet address, status, and last activity.
Monitoring Multiple Agents
TUI
Switch between agents using arrow keys in the terminal dashboard:
sigil tuiWeb Dashboard
The Dashboard displays a grid of all active agents with real-time heartbeats, status indicators, and log streams:
sigil start
# Open http://localhost:7445CLI
View daemon process logs:
sigil logs --followCommon Patterns
Treasury + Minter
- Treasury — Manages SOL holdings and liquidity pools
- Minter — Handles token creation and distribution
Arb + Rebalancer
- Arb — Monitors price discrepancies across pools
- Rebalancer — Maintains target portfolio weights
The Watcher
A dedicated agent with a single instruction:
"Close any token account with zero balance and reclaim rent"This agent runs passively, cleaning up dust accounts across all wallets.
WebSocket Scoping
All WebSocket events are scoped to individual agents:
Namespace: /agent/<agentId>
Events are never broadcast globally (except system:killed).This ensures that UI clients only receive events for agents they are actively monitoring.
