Skip to content
OneviumDocs
On this page

Settings reference: options, defaults, and when they apply

Look up options by 1.3.3 settings section and understand saved values, installation defaults, scope, and experimental options.

How to use this reference#

Click the account button at the bottom of the left navigation rail and choose Settings. The settings sidebar has four groups, and this page follows the same order:

GroupSections
App settingsGeneral, Notifications, Appearance, Session organization, Keyboard shortcuts, Voice
AI and connectionsPersonalization, Tools, AI services, Claude Code, Browser, Secrets and hosts, Network proxy
CodingWorktrees
Account and dataAccount and license, Claude subscription usage, Activity, System permissions, Privacy, Storage, Archived sessions

Your displayed value takes precedence. Upgrades generally preserve existing choices. The tables distinguish new-install defaults from fallback values used when a saved configuration is missing a field. For worked examples, see settings and data.

General: language, new sessions, and input#

Group → optionHow to chooseEffect and scope
Interface and window → LanguageChoose the interface languageNot a universal response-language switch
Interface and window → Always on TopKeep results visible while using other appsApplies to the window immediately
New session defaults → Default Permission ModeDefault permissions, Auto mode, or Full access; see permissionsNew-session default; existing sessions keep their own choice
Editor → Plain text editorKeep links and references as editable text while composingOff by default; applies immediately to all inputs
Editor → Show context window usageTurn off if you do not want the context indicator in the inputOn by default
Editor → Send shortcutEnter or ⌘/Ctrl+EnterEnter by default; Shift+Enter always inserts a new line
Editor → Follow-up behaviorWhile a reply is running, queue messages or steer the current replyQueue by default; the shortcut in the description performs the other action
External applications → Default open toolChoose a detected editor or terminal, or Remember last usedControls the external-editor entry's main action; the entry itself is enabled in Appearance → Conversation display
Background activity → Keep running in backgroundPrevent sleep while a schedule, channel message, or session runsUses more power; normal power saving resumes afterward; macOS lid-close sleep is not covered
Updates → Check for UpdatesInspect version and available updatesDownload and install, restart to update, or download manually as offered

Notifications now have their own section, and display controls live in Appearance.

Installation defaults and saved choices

OptionFresh-install baselineMissing-value fallback in older configurations
Theme / languageLight / ChineseExisting choice or environment initialization
PermissionsFull accessDefault permissions, or a compatible existing full-access configuration
Notification typesIn-app off, desktop onIf an earlier version explicitly turned desktop notifications off, desktop stays off for every type
Automatic AI namingOffOff without an explicit naming policy; saved choices remain in effect
AI browser controlOffExisting enabled settings remain enabled
Keep running in backgroundOnOff
Memory daily budget$10$1 when a budget was never set

Notifications: types, sounds, and system delivery#

OptionWhat it coversDefault and notes
Notification types → Needs your confirmationClaude asks a question, wants a tool approved, or has a plan for you to reviewDesktop on, Ding sound
Notification types → Secret authorizationThe AI wants to use, change, or read a saved secret, or connect to a new serverDesktop on, its own Rise sound
Notification types → Task completedA conversation finishes its turn and is waiting for youDesktop on, Chime sound
Task completed → When to notifyIn background only, or AlwaysBy default you are notified only when that conversation is not visible, including while Onevium shows another conversation
Notification types → Background tasks and subagentsA background task, subagent, or teammate finishes, fails, or stops, or Claude recalls a memoryDesktop on, Pop sound
Notification types → Errors and failuresA turn ends with an error, or a worktree cannot be created or restoredDesktop on, Alert sound
In-app / Desktop / sound per typeCheck each channel; choose No sound to mute; the speaker button previews the soundSaves immediately; Desktop is unavailable where the system cannot deliver notifications
Desktop notifications → System permissionSend test notification, Open system settings, and setup tipsOn macOS the first test notification raises the permission prompt

Figure 1: the five notification types and their sounds, with the 1.3.2 settings groups on the left. Isolated demonstration of the real notification settings component showing fresh-install defaults; no notification was sent and no system setting changed.

If desktop notifications do not appear, check system notification settings and Do Not Disturb or Focus, then System permissions. For the conversation lists in the Dock menu and menu bar hub, see menu bar hub.

Appearance: theme, sidebar, and conversation display#

Appearance has four tabs. Choices save automatically and apply to all conversations. If saving fails, the last saved appearance is restored and Retry is available.

Theme and typography

OptionHow to chooseEffect and scope
Light / Dark / SystemFix the brightness or follow the operating systemApplies across the workspace
Workspace paletteNeutral, Warm paper, Codex style, GitHub style, Notion style, Claude style, Catppuccin, or NordEight palettes, each with light and dark colors; changing palette also selects its matching link color
Link and focus colorPalette default, Blue, Teal, Plum, or Warm brownColors conversation links and keyboard focus outlines
Visual contrastStandard or Higher contrastMakes muted text and boundaries more distinct
Interface / Message / Code fontChoose each separatelySeparate fonts for interface text, conversation text, and code blocks
Chat / code text size12–16px / 10–16pxAdjusted separately with a live preview
Message weightRegular or MediumHeadings and bold retain emphasis; code weight is unchanged

The built-in terminal and code editor follow the workspace colors; this does not configure an external editor. Restore color and font defaults resets only these choices and keeps reading density and the Light/Dark/System selection.

Sidebar and session list

OptionHow to use itWhat to verify
Layout preset and individual positionsStart from a preset, then place markers, channel/schedule icons, and activity status left or right of the titleCheck the preview and an existing conversation
Sidebar text sizeAdjust navigation, project names, and session titlesMessage and code sizes remain independent
Initial default widthEnter at least 260 pxA manually dragged width stays remembered; double-click the sidebar edge to use the default again
Channel conversation titlesShow or hide sender and group/contact names separatelyWith both enabled, the sender comes first
Navigation entriesToggle entries and drag to reorderHidden entries remain under Explore; New session stays first

Conversation display

OptionHow to chooseEffect and scope
Reading densityCompact, Standard, or RelaxedAdjusts spacing and line height across conversations; Restore spacing default resets only density
Message NavigatorReturn to earlier messages in long chatsOn by default; hover at the chat's right edge
Audio visualizationAnimate conversation ticks with microphone and system soundNeeds Microphone and Screen and system audio permissions; analyzed locally, never recorded or uploaded
File change cardsShow per-turn file change cards and the live summaryHiding them keeps recorded changes and restoration available
Toolbar entries → External editor entry / Commit entryShow the top-right buttons to open the project or commitHidden by default; Review can still commit

Completed turns collapse their process into a summary; click it to inspect tool steps. Collapsing changes display only.

Motion and performance

OptionHow to chooseEffect and scope
Reduce visual effectsFirst adjustment for flicker or stutterReduces decorative animation immediately
Disable hardware accelerationTry if reducing effects does not helpRequires restart; may reduce smoothness

Session organization: naming rules and labels#

This section has Naming rules and Labels tabs. To create labels, apply conversation markers, and filter by label, see Conversation organization. Naming rules save automatically; new or edited labels require Save label.

AI naming is opt-in: under Naming rules, enable Automatically update conversation titles, choose the naming model, and inspect the prompt. Enabling it does not rename old conversations immediately, and manual titles remain protected. Existing saved policies are retained; a missing policy defaults to off. Manual Generate with AI remains a separate action.

Keyboard shortcuts: edit, resolve conflicts, and global commands#

  1. Search for a command, select its row, and press a combination.
  2. A valid, conflict-free combination saves directly; Escape cancels recording.
  3. Transfer resolves a conflict by removing that binding from the previous command.
  4. Clear a binding, restore one default, or confirm a reset of all bindings.

Commands have global, chat, file-panel, browser, and other scopes. Some entries, such as double-Escape stop and Shift+Tab Plan switching, are fixed references.

System commands that work from any app—Open quick access, Open secrets quick window, Open verification codes, Open password generator, and Show or hide Onevium—have no default binding, so they never take a key another app already uses. ⌥⌘K (secrets quick window) and ⌥⌘T (verification codes), the 1.3.1 defaults, are no longer bound by default starting with 1.3.2; bind your own here if you want them. Capture active window defaults to the double-Command gesture, which requires Accessibility permission; a normal key combination does not. See menu bar hub for how the quick-access commands are used.

Voice: recognition, polish, and history#

ControlHow to configure itHow to verify
Recognition modelsDownload a suitable language model, then make it currentVerify with a short recording
AI transcript polishEnable for homophone and punctuation cleanupOn by default; sends text to the model provider
Polish modelChoose a working modelDefaults to a low-cost role
Enable voice inputOff hides the microphone and disables its shortcutCheck the composer; on by default
Microphone selectionAuthorize access, then choose system default or a detected deviceVerify the selected device with a recording
History and recordings folderInspect records and local audioCheck the latest record and open its audio file
Copy transcript / Download recording / Delete recordingUse the actions on a history recordPaste or open the export to check; confirm the target before deleting

Local recognition and AI polish are separate stages. There is no visible recording-retention-days setting. See voice dictation.

Correction preferences and vocabulary

Open Voice → Correction preferences → Manage. Write a short rule such as “Keep product names in English and preserve numbers,” then click Save preferences. Industry templates fill editable instructions; review them before saving. Closing the dialog does not save.

Under My words, add a correct spelling and optional common misspellings, then save the word. Learned words come from clear edits made before sending and are extracted by a later AI correction, with no extra model request at send time; one edit does not guarantee a learned word. Clearing learned words also removes pending examples while keeping manual words and instructions.

Personalization and the memory space#

Group → controlPurpose and when to change itDefault, scope, and effect
Personalization (master switch)Controls user rules, memory, and tool assessmentOn by default
User Rules → Enable user rulesStable preferences and habitsOff by default; up to 4,000 characters; autosaved; user scope
Memories → Use memoryExtract and use durable information from conversationsOn by default; not a switch for saving all chat history
Memories → Extraction frequencyHigh: each turn; balanced: every 3; economy: every 5; or offBalanced by default; off stops new extraction, not recall
Memories → Deep extractionInclude reasoning, alternatives, and tradeoffsOff by default; adds extraction usage
Memories → Extraction languageLanguage of new memoriesFollows interface by default; does not translate existing items
Memories → Excluded projectsProjects that should not create new memoriesAll included by default; exclusion does not delete existing items
Recall and upkeep → Recall thresholdStrict, balanced, relaxedStrict for fresh installs; balanced fallback for older configurations
Recall and upkeep → Cross-project searchRetrieve relevant memories from other projectsOff by default; not blanket cross-project injection
Recall and upkeep → Context lengthCompact, balanced, detailedBalanced by default; memory volume, not the model window
Recall and upkeep → Auto-organise frequencyDaily, weekly, offDaily by default
Background AI model and budget → Tool Assessment, Background AI modelModel shared by memory extraction and tool assessmentMust be callable
Background AI model and budget → Budget used / Budget LimitToday's usage and the daily cap for automatic extractionCounted at actual cost; $10 for fresh installs, $1 for early installs that never set one; not a total chat budget
Memory spaceBrowse, search, correct, disable, or forget memories, and inspect sources, links, and usageOpened from Personalization; the sidebar keeps Personalization highlighted

See memory and recaps for the full workflow. @Memory initiates work on Claude Code rule or memory files; it does not save a database memory to the memory space. Daily Briefing is retired; see the separately installed Daily review Skill.

Tools: built-in capability groups#

GroupPurposeDefault or behavior
SchedulesManage automationsOpt-in; enable in Settings → Tools or through the relevant capability card
Charts and interactive contentCreate visual artifactsOn by default
Browser PreviewBrowser toolsOn by default; also requires AI browser control in Browser
Sessions and titlesWork across conversations, child sessions, teams, and title organizationOpt-in; enable in Settings → Tools or through the relevant capability card
Recap (work activity)Generate work recapsOpt-in; enable in Settings → Tools or through the relevant capability card
Image creationGenerate and edit imagesOn by default; an image service must be configured
Services (managed processes)Manage servicesOn by default
Channels (manage bots)Let the assistant manage channel configurationOff by default; not the switch for connected bots
Secrets and hostsUse secrets and SSH by referenceOff by default; turned on in Secrets and hosts
Turn Continuity / Channel MessagingAutomatically supplied runtime toolsInformational rows, not switches

An opt-in group with no saved setting is off; already enabled choices are retained. Disabling a group prevents further calls, and newly enabled tools are available with the next message. Switches do not undo completed actions or delete existing conversations, schedules, or recap data.

AI services: model connections#

Add or adjust providers, models, and connection configuration here. Confirm the endpoint, credentials, and model, then send a short message; saving does not prove a working model. See providers and custom providers for the fields.

Open the provider's model configuration and expand Default reasoning effort to choose a starting level for models with multiple levels. Each choice saves immediately for that provider and model and seeds new conversations; existing conversations keep their own effort.

For an Anthropic-compatible relay, declare 1M support under the provider editor → Advanced Options → Endpoint supports 1M context, and enable the global 1M Context Window in Claude Code. Native OpenAI Responses, Chat Completions, and Gemini connections use Manage models → Advanced → Confirm 1M support for this model. Follow 1M context window.

Claude Code: shared CLI configuration and advanced options#

Group → controlPurposeSaving, scope, or limitation
Reasoning and context → Extended ThinkingAdjust extended reasoning on supported modelsSaves immediately; model support varies
Reasoning and context → 1M Context WindowEnable long context according to connection and per-model supportExperimental; account and model eligibility still apply
Reasoning and context → Auto-compact timingDefault, or 50%–95% in 5% steps; 70% is marked recommendedThe description shows the compaction point for 200K and 1M contexts; it can only compact earlier than the default; stored as an environment variable in ~/.claude/settings.json, so claude in the terminal follows it too
Experimental collaboration → Agent TeamsEnable experimental CLI teamsSeparate from Onevium's @Team workflow
Experimental collaboration → Teammate Modeauto, in-process, and platform-dependent tmux/iterm2Shown when teams are enabled; affects Claude in a terminal only
Permissions → Permission RulesEdit CLI permission JSONValid JSON plus Save; a different layer from the session selector
Advanced → Environment VariablesChange variables passed to ClaudeEdit JSON, save, and confirm; retain unrelated fields
Advanced → Edit Raw JSONEdit the whole configurationFormat, review, and save; a settings file that cannot be parsed is not overwritten

Compacting earlier sends fewer tokens per turn but drops detail sooner; start with the recommended value and adjust from long-task results. An unchecked CLI boolean does not describe every model's underlying defaults. Configuration can contain credentials; remove them before sharing screenshots.

Browser: control, identities, and site data#

ControlPurposeOperation and limitation
AI browser controlEnable AI browser toolsOff for fresh installs; existing enabled settings remain; off does not clear site data
Browser to controlBuilt-in, External, or AutoBuilt-in uses the browser inside Onevium; External controls your Chrome through the Claude in Chrome extension; Auto currently works the same as Built-in
External Chrome connectionExtension and connection status for external ChromeShown only when External is selected
Built-in browser settings → Default viewportPreset dimensions for new tabsExisting tabs can override from the toolbar menu
Identities → New identity / Import from a browser…Create an identity with its own cookies, sign-ins, and networkA new identity starts empty; importing does not guarantee a site stays signed in
Identities → Network for this identityBrowser default, Follow system proxy, Direct, or a routeRoutes are managed in Network proxy; open pages may switch on their next load
Identities → Make app defaultUsed when a conversation has not chosen an identity yetNew tabs remember the identity per conversation
Identities → Delete identity…Delete the identity with its sign-ins, cookies, and saved passwordsCannot be undone; wait if one of its tabs is running an action
PasswordsLogins imported from your other browsersEncrypted with this machine's credential storage; credentials the AI uses in commands belong in Secrets and hosts
Browsing data → Clear browsing dataDelete cookies, cache, and site data shared by all browser tabsAffects shared login state

Temporary identities are created in the browser and erased when their last tab closes; they are not listed in settings. See the browser guide.

Secrets and hosts#

Manage server, database, API, and cloud account credentials that the AI can use by reference; AI use is off by default. The quick-access row at the top opens the quick window. See Secrets and SSH for item types, SSH, import, and authorization.

Network proxy: routes, app proxy, and browser default network#

In-app hints also call this page “Settings → Network”. It has three parts:

Part → controlWhat to enter or chooseEffect and check
App proxy → ModeOff, App Only, or GlobalCovers model requests, image generation, and commands started in a new terminal; running programs, SSH, and external MCP servers are not moved. Off connects directly (a VPN on the computer still applies)
App proxy → RouteChoose a saved route, then TestShows “Saved · applied to Onevium's requests” and the exit check; with several routes, the proxy turns on only after you choose one
App proxy → System Proxy StatusApplied or Not Applied in Global modeGlobal writes the route into the system proxy and restores your previous setting when you switch back
App proxy → Extra Direct Addresses (Optional)Comma-separated domains or hostsLocal and private addresses already connect directly
App proxy → Check Browser Exit IPOpens a check page in your default browser in Global modeVerifies the system browser's exit separately
Browser default network → Browser defaultFollow system proxy, Direct, Same as app proxy, or a routeApplies only to identities set to Browser default; Follow system proxy reads system settings and never changes them
Routes → Add route…Name, protocol (HTTP/HTTPS/SOCKS5), address, port, optional username and passwordPaste socks5://user:password@host:1080 to fill every field; saving a route does not turn it on
Routes → Edit… / Test / DeleteUse each route's “⋯” menuA new address applies immediately wherever the route is used; replace the app proxy's route before deleting it

Figure 2: ① status and exit check for the app proxy's route, ② a saved route's protocol, address, test result, and usage count. Isolated demonstration of the real 1.3.2 network proxy component; addresses use example domains, and the exit IP and test result are simulated. No system proxy was changed and no test was actually run.

Test scope: a test reaches an IP-check service through the route and records the exit IP, location, latency, and time that service saw. It prefers the built-in browser's network stack; otherwise it runs as an app network test and is labeled that way. It does not test Anthropic or a custom model endpoint and does not validate a model account; other sites may see a different exit.

Deleting a route used by identities or the browser default asks what they use instead: keep them disconnected until you choose, switch them to follow the default, or replace it with another route. Windows cannot store proxy credentials in system settings, and GNOME's SOCKS system proxy has no credential fields; Onevium's own requests still authenticate, while other apps may prompt separately or connect without credentials.

When you upgrade from 1.3.1 or earlier, a complete old proxy becomes a route named “host:port”; an old proxy that was on but missing a host or port is treated as off.

Worktrees#

Manage the isolated Git checkouts Onevium creates for conversations and each project's local environments, which tell Onevium how to set up a worktree. See Worktrees; you can also reach worktree cleanup from Storage → Manage worktrees.

Account and license: account and devices#

Inspect email, license status/type, start and expiry dates, and remaining days. Replacement is controlled by account eligibility. When offered, enter the new activation code, submit, then verify the updated status and dates.

The device list shows name, platform, version, and recent activity. It has no delete-device action. Signing out does not clear local conversations.

Claude subscription usage: subscription limits#

This section shows the official Claude subscription account, limit windows, and behavior analysis, with refresh or retry. Relevant limits require a Pro/Max subscription login. API keys and third-party providers may not supply this data.

Temporarily unavailable does not mean zero quota. Read local token and cost statistics in Activity separately from these subscription limits.

Activity: local usage and cost observations#

ControlWhat it showsUseful approach
Token activityA yearly heatmap of daily tokens or messages, with streaks, daily peak, and longest turnClick a day to focus the views below on it
Overview / Models / Sessions / ImagesTotals and trend, usage by model and connection, sessions by usage, image generation attemptsClick a model or session for details
Time rangeToday, Yesterday, 7/30/90 days, with previous and next period; 7 days by defaultNarrow the range to investigate a spike
Connection and model filtersAll connections / All models, or one of eachIdentify which connection contributes usage
Daily usageTokens, Output only, or Usage recordsCompare like with like
Cost reference and cache hit rateService-reported charges and current-price estimatesUnknown prices stay unpriced; not a paid invoice

Estimated cost, cache savings, and an official invoice are different.

System permissions: status and recovery#

Each permission—Microphone, Camera, Screen and system audio, Accessibility, Automation, Files and folders, Notifications—shows its purpose and system status: Allowed by the system, Not allowed by the system, Restricted by system policy, Not requested yet, or Check in system settings. Actions include Request permission, Open system settings, and a link to the related feature; Check permissions again refreshes the status. Opening the page does not request access.

On macOS, Already enabled, but still not working? explains recovery: fully quit and reopen from Applications; if access is still denied, turn the permission off and on in System Settings, or remove the old entry and add the current app. On Windows, microphone access also depends on allowing desktop apps to use it; on Linux it depends on your desktop environment's privacy, audio, and notification settings. See settings and data for the steps.

Privacy: diagnostics and cleanup#

SDK event telemetry log is off by default. Enable it for a specific investigation, reproduce the issue, then disable it. Review session metadata before sharing logs.

Clear Local Data deletes the database and companion files, media, uploads, and images. It does not delete backups in db-backups or upgrade-backups, and it is not a way to clear CLI configuration, project files, browser identities, or voice recordings. See settings and data for locations and cleanup distinctions.

Local storage does not mean offline processing; data destinations still depend on the services you use.

Storage: usage, cleanup, and database backups#

ControlPurposeNotes
This deviceTotal Onevium usage by database and conversations, attachments, images and media, worktrees, previews, database backups, logs, and other dataSizes are estimates; Refresh rescans; Storage locations shows the real folders
Clean up old conversations → ReviewReview conversations and their sub-conversations before moving them to the trashRestore or permanently delete trash in Archived sessions
Manage worktreesOpens WorktreesChoose how many old worktrees to keep
Clear rebuildable previews → Review cleanupDelete cached image previewsOriginal images, attachments, and logs are kept
Database backups → Back up nowCreate a consistent snapshotWorks while you use Onevium; manual backups are not limited by the copies-to-keep setting
Database backups → Automatic database backupEvery day or every week, backup time, and automatic copies to keep (1–100)Off by default; when enabled it starts at every day, 03:00, keeping 7; click Save schedule; a missed backup runs at the next launch
Backup history / Backup locationDownload a backup or see its folderdb-backups in the data directory by default

The Storage page never deletes an active database or compacts it automatically; deleted records may leave reusable space inside the database.

Archived sessions: restore or permanently delete#

Use search, project, and date filters to find a conversation. Preview it before restoring or deleting. After restoration, check the content in its project. Bulk actions are supported; Delete all applies to the filtered results.

Permanent deletion removes the selected conversations and messages and cannot be undone. Practice with a demo conversation rather than real history.

If an option is missing#

  • Check the applicable version at the top of this page and whether the relevant feature is enabled. Account and license appears only in builds that require sign-in.
  • Platform-specific options appear only where supported; inspect the settings on the device where you will run the task.
  • CLI Agent Teams and the 1M context option remain experimental and depend on model, account, or platform support even when a control is visible.
  • After upgrading from 1.3.1: an incomplete old proxy is treated as off, ⌥⌘K/⌥⌘T are no longer bound by default, memory calls count their actual cost, and 1.3.1 cannot read the upgraded data.
  • After changing a setting, verify it with the relevant message, notification, browser action, or recording.

Next steps#

Return to settings and data for common adjustments, use permissions to choose execution controls, or follow workflow tips.