Boatman Ecosystem documentation is live!
Boatman Desktop
Configuration

Configuration

Settings Overview

Access settings via the gear icon in the top-right corner.

General Tab

SettingDescription
AuthenticationAnthropic API key or Google Cloud OAuth
Default ModelClaude model for new sessions
ThemeDark or light mode
NotificationsDesktop notification preferences

Approval Tab

ModeDescription
Suggest ModeYou approve all changes (safest)
Auto-Edit ModeClaude edits files, asks for bash commands
Full Auto ModeClaude has complete autonomy (risky)

Memory Tab

SettingDefaultDescription
Max messages per session1000Trim older messages beyond this limit
Archive old messagesEnabledMoves old messages out of active context
Auto-cleanup sessions30 daysDelete sessions older than this
Max total sessions100Maximum number of stored sessions

MCP Servers Tab

  • Enable/disable individual MCP servers
  • Add custom MCP servers
  • Configure environment variables per server

Firefighter Tab

  • Okta OAuth configuration (domain, client ID, client secret)
  • Sign in/out controls
  • Access token status display
  • Linear API key for ticket integration

About Tab

  • Version information
  • Links to documentation and support

Configuration Files

User Configuration

FilePurpose
~/.boatman/config.jsonUser preferences and settings
~/.claude/claude_mcp_config.jsonMCP server configurations
~/.boatman/sessions/Session data and history

Build Configuration

Edit wails.json for build settings:

{
  "name": "boatman",
  "outputfilename": "boatman",
  "frontend:install": "npm install",
  "frontend:build": "npm run build",
  "frontend:dev:watcher": "npm run dev"
}

See Wails documentation (opens in a new tab) for details.


Project-Specific Settings

Each project can override global settings:

Right-click project → Project Settings
- Approval mode override
- Model override
- Custom environment variables