CLI Reference

The Sigil Wallet CLI is the primary management interface for agents, providers, directives, and system configuration.

Workspace

Command	Description
`sigil onboard`	Launch the guided setup wizard (Recommended for first-time setup)
`sigil init`	Alias for onboard
`sigil start`	Boot the API server and resume all active agent loops (Daemonized by default)
`sigil stop`	Halt the background daemon and all running intervals
`sigil status`	Show daemon health, API URL, and session token info
`sigil kill`	Emergency halt — wipe keys from memory and stop all signing
`sigil health`	Check database validity and connection health

The primary agent is named sigil. It is the system's root agent.

Command	Description
`sigil agent init`	Initialize the main "sigil" agent (generate or import wallet)
`sigil agent start`	Launch the main agent's loop
`sigil agent pause`	Pause the main agent
`sigil agent info`	Show main agent details (address, balance, status)
`sigil agent reset`	Destroy and re-initialize the main agent

You can create multiple sub-agents for specialized tasks.

Command	Description
`sigil agent create <name>`	Create a new sub-agent with its own isolated wallet
`sigil agent list`	List all agents (main and sub-agents)
`sigil agent get <name>`	Show detailed info for a specific agent
`sigil agent start-agent <name>`	Start a specific sub-agent loop
`sigil agent pause-agent <name>`	Pause a specific sub-agent
`sigil agent destroy <name>`	Permanently delete an agent and its data

Command	Description
`sigil chat <agent> "<message>"`	Send a message to an agent's context window
`sigil logs`	View daemon process logs
`sigil tx list <agent>`	View transaction history for an agent

Command	Description
`sigil provider add <name>`	Configure a new LLM provider
`sigil provider set-primary <name>`	Switch the active primary provider
`sigil provider list`	View all configured providers
`sigil provider remove <name>`	Remove a provider configuration

Command	Description
`sigil auth token`	[New] Show the current session token for UI/Extension authentication
`sigil auth rotate`	Regenerate the API session token
`sigil config set --loop-interval <sec>`	Adjust global loop timing

Command	Description
`sigil dashboard`	Open the Web UI in your default browser
`sigil tui`	Launch the interactive terminal dashboard

sigil init
sigil agent create --name "alpha"
sigil agent start "alpha"
sigil logs --follow

sigil provider add ollama
sigil provider set-primary ollama

sigil kill