Settings
Configure MadoHub preferences, API keys, and notifications.
Open settings from the top-right area of the app. The settings panel has seven tabs: General, Account, Agent, Memory, Appearance, Voice, and Logs.
General
Language preference, the Claude Code stop-notification toggle (see below), a system notifications toggle, an analytics opt-out, and Companion pairing (mirrors the canvas to the MadoHub iOS app over your local network).
Account
Cloud sign-in, current plan, and billing. When agent API access is cloud-managed rather than a self-supplied key, this is also where you see and refresh that connection.
Agent
Agent-related configuration, grouped under AgentApiConfig:
Provider
Configure the AI model used for intelligent routing between agents.
| Provider | Default model | API key format |
|---|---|---|
| Anthropic (Claude) | claude-haiku-4-5-20251001 | sk-ant-... |
| OpenAI | gpt-4o-mini | sk-... |
| Custom (OpenAI-compatible) | User-specified | Depends on provider |
For custom providers, you can also set a Base URL for the API endpoint.
Test connection
Use the Test Connection button to verify your API key and model configuration. A status indicator shows the current provider and model, or "No API key set" if unconfigured.
When is an API key needed?
Only if you use the ai-routing or summary transform types in your connections. The prompt-wrap, full-output, and raw transforms work without an API key.
Other agent options
Auto-submit for agent prompts, tile-close confirmation, and a Resume Session toggle that controls whether closed agent tiles offer to resume their prior session. An approval-mode selector controls how permission prompts from agents are handled.
Memory
Toggle automatic memory extraction and injection, and review the candidate queue: memory candidates awaiting approval before they're promoted to active memory entries.
Appearance
Theme (dark or light) and terminal font size.
Voice
Enable or disable voice input and choose its destination (which agent or tile a voice dictation is sent to). Voice input can also be toggled from the command palette (Cmd+Shift+P).
Claude Code Stop Notifications
Toggle real-time sensory notifications when an agent finishes execution or pauses for human interaction. This toggle lives on the General tab.
When enabled, MadoHub monitors agent lifecycles and provides instant feedback:
- Ambient Edge Glow: Highlights the active tile with a subtle animated border pulse when the task completes.
- Audio Chime: Plays a crisp acoustic sound so you can focus on other windows without missing when an agent is ready.
- Auto-Dismiss: Notification states automatically clear after 15 seconds or upon interacting with the tile.
Logs
View the last 200 lines of MadoHub's local system log (~/.madohub/logs/madohub.log). Useful for diagnosing workspace events, auditing agent handoffs, or validating connection configurations.
Click Refresh to reload the log contents.
What's logged
- Agent state transitions and lifecycle events
- Completion signals and idle status updates
- Routing transform execution and session handoffs
- Content delivery events between canvas tiles
- System errors and operational diagnostics