Settings
Configure Broski to work the way you want.
Connection Section
When connected, shows your current bridge status:
Active Connection Card
- Device icon - Laptop/Mac icon
- "OpenCode Bridge" - Connection name
- Quality indicator - Signal strength bars
- Expand arrow - Tap to show details
Expanded Details
- Local IP - WiFi address
- Port - Connection port
- Tailscale IP - VPN address (if available)
- Latency - Round-trip time in ms
Device Manager
- Paired Systems - List of known devices
- Connection History - Previous connections
Disconnect
Tap "Disconnect" to end the current session and return to the scan screen.
Appearance Section
Customization
Opens the full customization screen with:
| Setting | Options |
|---|---|
| Theme Selection | System, Light, Dark, OpenCode, plus 27 themes |
| Theme Colors | View/modify palette |
| Input Bar Style | Standard, Rounded, Outlined |
| Navigation Style | Classic or Glassmorphic |
| Prompt Accent | Input border color |
| Highlight Color | Star/favorite color |
Available Themes (27)
Broski includes 27 built-in themes:
OpenCode (default)
OpenCode Light
Tokyo Night
Dracula
Catppuccin Mocha
Catppuccin Frappe
Catppuccin Macchiato
Nord
Gruvbox
Aura
Monokai
Flexoki
One Dark
Solarized Dark
GitHub Dark
Matrix
Synthwave 84
Vesper
Rose Pine
Vercel
Cobalt2
Night Owl
Palenight
Material
Everforest
Kanagawa
Zenburn
Icon Packs
Choose how tool icons appear:
- Material Outlined - Clean, default style
- Material Filled - Solid icons
- Minimal - Simple, lightweight
- Rounded - Soft corners
AI Section
AI Backend
Switch between supported backends:
| Backend | Badge | Description |
|---|---|---|
| OpenCode | OC | Multi-provider AI coding assistant |
| Claude Code | CC | Anthropic's Claude with tools |
| Codex | CX | OpenAI's official CLI agent |
Providers
- Model providers - OpenAI, Anthropic, etc.
- API keys - Configure credentials
- Model selection - Choose default model
OpenCode Section
Only visible when OpenCode is selected:
| Setting | Description |
|---|---|
| Terminal Sessions | PTY terminal sessions - create, attach |
| Skills | SKILL.md management |
| Commands | .opencode/command/*.md |
| Agents | .opencode/agent/*.md |
| Plugins | .opencode/plugin hooks |
| MCP Servers | Model Context Protocol servers |
| Tools | AI tools - enable/disable each |
| Permission Rules | Default session permissions |
Claude Code Section
Only visible when Claude Code is selected:
| Setting | Description |
|---|---|
| Settings | Language, gitignore, channel |
| Skills | SKILL.md management |
| Commands | .claude/commands/*.md |
| Hooks | hooks.json management |
| MCP | .mcp.json configuration |
| Subagents | Custom subagent definitions |
| Custom Tools | HTTP APIs, scripts, and more |
| Plugins | Commands, skills, hooks, MCP |
Subagents
Create custom subagent definitions:
- Subagent list - View all definitions
- Create/Edit - Define new subagents
- Delete - Remove subagent
Custom Tools
Define your own tools:
- HTTP tools - API endpoints as tools
- Script tools - Local scripts as tools
- Enable/Disable - Toggle each tool
Codex Section
Only visible when Codex is selected:
| Setting | Description |
|---|---|
| Skills | SKILL.md management |
| Agents | AGENTS.md configuration |
| MCP | Servers and configuration |
Voice Input
Use speech-to-text to dictate messages to your AI agent. Voice input is entirely optional and off by default.
| Setting | Description |
|---|---|
| STT Provider | Choose Groq (fast, free tier) or OpenAI Whisper |
| API Key | Your own API key for the chosen provider (stored encrypted on-device) |
| Test Key | Validate your API key works before saving |
Privacy Note
Voice audio is sent directly from your phone to the STT provider you choose (Groq or OpenAI), using your own API key. No audio data passes through Broski or the bridge. If you don't configure voice input, no audio is ever recorded or sent anywhere.
Account Section
Subscription Usage
- API limits - Current usage vs limits
- Credits - Remaining balance
- Billing - Subscription management
Support Section
- Setup Guide - Opens broskiapp.com/docs/setup
- Contact Support - Email broskiappp@gmail.com
Legal Section
- Privacy Policy - How we handle your data
- Terms of Service - Usage terms and conditions
About Section
Replay Onboarding
See the first-launch experience again. This:
- Resets the onboarding flow
- Clears current connection
- Shows setup flow from the beginning
Clear Cache
Delete all cached data:
- Sessions and messages
- File browser history
- Offline data
- Connection settings are preserved
Clear Cache
Clearing cache will delete all offline data. You'll need to be connected to load sessions again.
Version
Shows the current installed app version.