Device-wide options live under Settings, while interface colors live under Theme. App settings in the upper-right corner of an app page affects only that AI tool.
General settings
| Setting | Effect |
|---|---|
| Language | Follow the system or choose a supported language |
| Preferred terminal | Terminal used to open sessions; Auto detects the local environment |
| Launch at login | Start OcHub after system login |
| Start without showing the window | Applies only when launch at login is enabled |
| Keep running after closing the window | Close the main window but keep the background process |
| System-menu quick switching | Show connection shortcuts in the macOS menu bar or Windows taskbar |
If you combine silent startup with background operation and system-menu shortcuts both disabled, reopening the main window becomes inconvenient. Keep at least one visible entry point.
Manage apps and plugins
Open Settings → Apps and plugins:
- Toggles control whether an app appears in the sidebar and system menu.
- At least one app must remain enabled.
- Disabling keeps connection data and does not rewrite the tool’s current config.
- User plugins load from
~/.ochub/apps/*.toml. - After editing a manifest, select Reload plugins. Errors appear on the same page.
Illustrated walkthroughClick a screen to enlarge it, then use ← → to walk the steps. The blue outline marks the control or result.
STEP 01Open Settings
STEP 02Open Apps and plugins
STEP 03Toggle visible apps
STEP 04Reload changed plugins
Switch themes
- Open Theme.
- Choose Follow system, Always light, or Always dark.
- Select Apply on a theme.
- Follow system switches between that theme’s light and dark variants.
Illustrated walkthroughClick a screen to enlarge it, then use ← → to walk the steps. The blue outline marks the control or result.
STEP 01Open Theme
STEP 02Choose a display mode
STEP 03Preview a theme card
STEP 04Apply the theme
Import, export, and edit
- Built-in themes are read-only. Use Duplicate and edit to create a user copy.
- A user theme can change its name, author, description, material, opacity, and color tokens.
- Update preview temporarily applies the draft across the app; Save or Cancel ends the preview.
- Configure light and dark variants independently and pass readability checks for text, accent colors, and surfaces.
- Export shares a theme file. Import validates both variants before adding it to the library.
Use full #RRGGBB values. If saving reports insufficient contrast, adjust the
foreground or background named in the error until the ratio is at least 4.5:1.
Restore
- Cancel an unwanted preview to return to the previous theme.
- Built-in themes cannot be deleted.
- Deleting a user theme removes its local file permanently. Export it first if you may need it again.