Reference
Settings reference
Kition settings configure device behavior, accounts, model providers, network, co-editing, extensions, and diagnostics. This reference identifies each section and the scope of each choice.
Updated
By Kition Docs
Verified against Kition 0.2.0 (7d49036f) on 2026-11-06
Change a setting and verify its effect
Choose the setting by what it controls. A provider configuration is different from the project content you want to send, and a sync server address is different from the documents you choose to share. Use the section list below when comparing these instructions with your installation.
- Open Settings and identify the relevant section, or use the search field at the top of the Settings sidebar.
- Review the account, path, or provider affected by the change.
- Change one value and use the available save or test control.
- Follow any explicit restart instruction shown for that setting.
- Return to the relevant work surface and verify the intended behavior.
| Kind | Example |
|---|---|
| Device preference | Appearance or application behavior |
| Service connection | AI provider, Kition Account, or sync server |
| Project content | Note, table, Board, or other kit file in the workspace |
| Execution configuration | A workflow’s trigger, actions, and inputs |
Current navigation
Settings opens as a window over the workspace; use the search field at the top of its sidebar to find a setting, and press Esc to close it. Settings has no MCP, Hooks, Shortcuts, or Email Providers sections.
- General
- Account
- AI Providers
- Display
- Advanced → Network
- Advanced → Co-editing
- Advanced → Extensions
- Advanced → Data
- Advanced → Developer
- About
General, account, providers, and display
- General — language and translation language; Restore workspace on launch, Confirm before quitting, and Auto-check for updates; the first-run guide; Sample data; and the Share anonymous usage data control, which is off by default
- Account — Kition Account sign-in, plan credits, purchased credits, Top up credits, and Manage plan
- AI Providers — connect model providers, sync their models, and choose the default model
- Display — theme, UI zoom, UI density, Reduce motion, Show document toolbar, code font, and code font size
Heads up
Provider keys and the proxy password are stored in plaintext .secret files under the local application data directory. They are not protected by the operating-system keychain, and the proxy form says so.
Network
Network configures one proxy for the whole desktop app, including the auto-updater. Supported schemes are HTTP CONNECT, HTTPS CONNECT, SOCKS5, and SOCKS5 with remote DNS. The form accepts host, port, optional username and password, and a bypass list, and provides a Test button plus the restart needed to apply changes.
Protect the application data directory, and revoke or rotate remote credentials if the device is lost or transferred.
Co-editing and Extensions
- Co-editing — the WebSocket address of your sync server, a connection test, Sync all my documents, and Synced documents from your other devices; co-editing needs a Kition account
- Extensions — install an extension from a workspace folder, its extension.json, or a .zip; each extension adds commands to kit documents and runs sandboxed with only the permissions it declares
Advanced and About
Use Support diagnostics before sharing raw logs. The copied summary leaves out documents, prompts, paths, keys, tokens, and logs; raw logs still require inspection and redaction.
- Data — shows the local data, cache, logs, and exports directories and opens each one
- Developer — Debug mode, which makes Agent logs include model requests and turn details, plus a clipboard inspector
- About — version, commit, and build time; Auto-check and Beta channel for updates; Contact support, Send feedback, and Support diagnostics; privacy, terms, source code, license, and open source licenses
Implementation sources
- kition@7d49036f: src/features/settings/sections/sectionRegistry.ts
- kition@7d49036f: src/features/settings/DesktopSettingsPage.tsx
- kition@7d49036f: src/i18n/locales/en-US/settings.json
- kition@7d49036f: src/features/settings/NetworkSettings.tsx
- kition@7d49036f: src-tauri/src/secure_store.rs
- kition@7d49036f: src-tauri/src/proxy.rs
Related pages
Privacy and telemetry
Privacy and telemetry describe where workspace data goes and which optional usage events are collected. Local storage does not mean every connected feature operates without network requests.
Keybindings
Keybindings are keyboard shortcuts interpreted by the application, the workspace, or the focused kit editor. Where focus is determines which action a key combination performs.
Log and configuration locations
Find the active data, cache, log, export, workspace, and configuration locations from the running Desktop app.