Settings
Curt and Trish from corporate IT live here.
Settings is a built-in app at kaba://settings/. Open it from your avatar’s menu, with /s or /settings in the omnibar, or with Ctrl+, (Cmd+, on macOS).
The sidebar lists the pages below. Search at the top (Ctrl+F or /) finds any setting by name or keyword, for example cookies, i3 or DNS, and jumps to it.
[todo: add screenshot of Settings and of parts the sidebar, the search palette with results, the General page.]
Most changes apply immediately and show a Setting updated notice. A few apply only to pages loaded afterwards; those say so.
General
Section titled “General”Account settings
Section titled “Account settings”Your avatar, name and email, Edit Account (name and password) and Logout. See accounts.
Updates
Section titled “Updates”Check for updates, opt in to beta releases, and choose whether to check automatically. Automatic checking is off by default. On a fleet-managed device, updates are pushed centrally. When an update has downloaded, Restart now installs it.
Automatic updates are available on production builds. If you built Kaba from source, update by rebuilding.
Group info
Section titled “Group info”The Group and Policy that apply to your account. Groups are on the way; see accounts.
Memory Saver
Section titled “Memory Saver”Frees memory from panes you are not using. A frozen pane reloads when you click it.
| Setting | Default |
|---|---|
| Enable Memory Saver | on |
| Never Freeze Active Frames | on. Keeps every pane in the visible frame alive, not just the active one. |
| Wake all panes when switching to a frame | on |
| Idle timeout | 10 minutes. Options from 2 minutes to 1 hour. |
| Always Keep Active | A list of domains that are never frozen. Add one from a pane’s status-bar menu. |
System Theme
Section titled “System Theme”The visual theme for Kaba. Smart Theme Change switches between a day theme and a night theme, by custom times or by sunrise and sunset. In kaba 0.146 this is on the Look & Feel page.
Terminal
Section titled “Terminal”Font size, scrollback, GPU acceleration, background transparency and colour theme, with the option to have the terminal follow the system theme. See terminal. Whether the terminal is available, and how it routes, is under Security & Privacy.
Background
Section titled “Background”Your desktop wallpaper: pick an image, upload your own, or use a solid colour.
Search
Section titled “Search”The search engines the omnibar can use, and which is the default. Add your own with a name and a query URL. See omnibar.
Adblock
Section titled “Adblock”The filter lists the in-browser blocker uses: enable, add or remove them. The global on/off switch is Disable Blocker in your avatar’s menu; per-site and per-pane switches are in the Kaba bar and the pane menu. In kaba 0.146 the lists are on the Security & Privacy page.
Import from another browser
Section titled “Import from another browser”Bring bookmarks, history and passwords from Chrome, Chromium, Brave, Edge, Vivaldi, Opera or Firefox. See accounts.
System
Section titled “System”| Setting | Default | Notes |
|---|---|---|
| Set Kaba as the default browser | off | |
| Open HTML files with Kaba when double-clicked | off | |
| Default zoom | 100% | |
| Display language | English | |
| Run In Background | off | Keep kabactl running for cluster, proxy and training use after the window closes. |
| Launch on Startup | off | Start Kaba when you log in. |
| System monitor refresh interval | 3 s | How often the header chart samples. Off hides the widget and stops polling. |
| i3-style compact header | off | See UI layout. |
Features
Section titled “Features”These switches decide what Kaba does beyond browsing.
| Setting | Default | What it controls |
|---|---|---|
| Enable AI | off | The on-device model features: context-menu text actions (Analysis, Format, Question, Respond, Debug, Convert), the toasts they open, Projects, Toolbench, and the Policies and Models pages. When off, the model worker never starts and those menus are hidden. |
| Enable Memory | on | Saving pages to your local memory store, both manually and automatically as you browse. When off, the memory menu items are hidden, nothing is captured, and the Memories and Extraction views are removed from Hippocampus. |
| Remember terminal sessions | Save each terminal session as a searchable memory. See what is kept out. | |
| Remember file activity | Save what you do in the file explorer as a searchable memory. | |
| Enable Learning Data | Record how you use the browser (navigation chains, searches, form inputs other than passwords and payment fields, and assistant task steps) so your on-device model can learn from your usage. Stored locally and encrypted with your memories; always off when Memory is off; never records Ghost sessions. |
Two related controls sit here: Remove a password or other text from memory, and Delete all learning data.
[todo: add screenshot of the Features section and of parts Enable AI, Enable Memory, Remember terminal sessions, Remember file activity, Enable Learning Data, Delete all learning data.]
Memory Ignore List
Section titled “Memory Ignore List”Pages and domains in this list are skipped by automatic memory capture and excluded from training. Add one from the status-bar menu of a page in the Memories view: Ignore this domain or Ignore this page. A domain rule also covers its subdomains. Remove entries here.
Downloads
Section titled “Downloads”| Setting | Default |
|---|---|
| Download location | Your system Downloads folder. A file that would overwrite another is renamed, for example file (1).pdf. |
| Ask where to save each file | off |
Look & Feel
Section titled “Look & Feel”| Section | Controls |
|---|---|
| Theme | The visual theme. Smart Theme Change switches between a day and a night theme by custom times or by sunrise and sunset. |
| Wallpaper | Desktop background image or colour. |
| Zoom & text | Default zoom and text size. |
| Terminal | Font size, scrollback, GPU acceleration, background transparency, colour theme, and whether the terminal theme follows the system theme. |
| Pane gaps | The default gap between panes. |
| Layout | i3 mode, One frame group open at a time, and Fold a group back down after. |
| Animations | Experimental. Motion for panes, frames, the omnibar and every overlay, with per-surface overrides. New installs start with Reduce motion on. |
[todo: add screenshot of Look & Feel and of parts Theme with Smart Theme Change, Wallpaper, Pane gaps, i3 mode, Animations.]
Keyboard
Section titled “Keyboard”Every shortcut, with a filter box. Click one and press new keys to rebind it; a marker shows chords that are shared. Reset all restores the defaults. This page also sets what Mod+Enter opens: a new desktop, a new terminal, or a custom address. See keyboard shortcuts.
Policies
Section titled “Policies”Everything in Kaba (kaba and kabactl) can be policy driven. Every UI element, every backend service, and everything in between. Out of the box in the UI we expose the ability to create a new policy for which models you want running as defaults in Kaba. For example, you could have a “low resources” policy for machines and systems that lack compute power or memory and automatically load models that can operate within those constraints.
But under the hood, everything is configurable in this manner. The upshot here is that for enterprise, corporate, or high stakes environments, policy can now be enforced in real-time given any arbitrary input (e.g. line of business, role based access, system info, etc.).
- Main LLM
- Policy allowed models & selections
- ad block
- Default search engines
- Enforced themes & branding
- Proxy & Comms
- Local vs Remote
Shown when AI is enabled. In Kaba Personal you create, edit, import and export policies here. On a fleet-managed device, policies are pushed to your group centrally and you cannot loosen them. What a policy can set today is listed under machine learning.
Models & Adapters
Section titled “Models & Adapters”Shown when AI is enabled. The library of base models and LoRA adapters on this device or a peer. See machine learning.
Devices
Section titled “Devices”Welcome to your intelligent cluster. Create a ticket, paste it into another device running Kaba, and now you have your own p2p cluster.
Out of the box Settings contains simple information like
- System info
- System id
Once you add devices to your cluster, a new world opens up. No more walking around with open laptops, no more managing ssh to access boxes and data elsewhere.
Click the breadcrumbs next to a device and you can access that system’s terminal, filesystem, sync data to it, or even use it as an exit node.
Much more to come here. Watch this space.
In Kaba Personal you add and remove devices yourself. Under fleet management, enrolment, grouping and removal are central.
The same menu starts training or memory enrichment on a device, and its row shows progress with Pause, Resume and Stop. The table lists each device’s status, role, node ID and last-seen time. See cluster & mesh.
[todo: add screenshot of Devices and of parts Invite a device, Join a cluster, the device table, the breadcrumbs menu (terminal, filesystem, sync, exit node, train).]
Containers
Section titled “Containers”The base images and running containers of the tool sandbox, on this device or a peer.
- Running containers: session, image, status and current step, with Stop and Delete.
- Base images: import any image by reference, for example
docker.io/library/alpine:3.20. Each shows its languages, size and whether it is cached. Terminal opens a shell inside an image.
[todo: add screenshot of Containers and of parts Manage on (device picker), Running containers, Base images with Import, the Terminal button.]
Security & Privacy
Section titled “Security & Privacy”| Section | Controls |
|---|---|
| Terminal routing | Whether the terminal is available, and whether it uses the Kaba proxy by default. |
| Tor routing | Send all browsing through Tor. |
| Ad block | Filter lists: enable, add or remove. |
| Privacy & anti-tracking | The privacy layer master switch and each protection. |
| Lockdown | The global default, with an explanation of what it turns off. |
| Safe Browsing | Indicator count and last update for the local threat database, and Block connections to known-malicious sites. |
Every protection is explained under privacy.
Every site that has cookies, permissions or privacy overrides, with filters for each kind and for memory-ignored sites. For one site or all the sites shown, clear cookies, forget permission decisions, remove overrides, or Forget everything.
[todo: add screenshot of Sites and of parts the filter chips, a site row with its override badges, Cookies / Permissions / Overrides / Forget actions.]
Passwords
Section titled “Passwords”| Section | Controls |
|---|---|
| Password store | The storage backend: Kaba’s encrypted vault, pass, or 1Password. For pass: the store directory and entry prefix. For 1Password: the account. |
| Passkeys | Kaba as the passkey provider (default), browser only, or off. |
| Saved logins | Search, copy a username or password, copy the current 2FA code, edit, or delete. Passkeys are listed with Delete only. |
| Lock now | Drop the in-memory key. Sign in again to unlock. |
[todo: add screenshot of Passwords and of parts Storage backend, Passkeys, the saved logins table (Site, Username, Password, 2FA, Last used), Lock now.]
Out of the box, we ship logs for your viewing pleasure. We included some basic manipulation (types of logs to include) and the ability to pause them.
In the sidebar this page is System Logs. It is the client’s log, live; the engine’s log is kabactl-server.log on disk.
Information
Section titled “Information”All of the basics for your Kaba system live here, like version and user data. Additionally, Kaba gives you some diagnostics (Processes and WebContents by default). You can copy the JSON or grab a Heap Snapshot to do other fun things.
| Section | Shows |
|---|---|
| About Kaba | Versions of Kaba, Electron, Chromium and Node, and the user data path. |
| Diagnostics | Total memory, the main process heap, the engine’s memory, per-process figures, and uptime. Copy JSON copies it all for a bug report. |
| Processes | Each process by memory, with the page it belongs to. |
| Troubleshoot | Probe a page that will not load: Kaba runs the load step by step through your own session and gives a verdict. Reset Kaba Chrome Settings clears engine caches and developer-tools state and restarts; your data, logins and preferences are not affected. |
[todo: add screenshot of Information and of parts version details, Diagnostics with Copy JSON, the Probe tool and its verdict, Reset Kaba Chrome Settings.]