‹ All Kalon docs

Kalon

Settings reference

Every pane in Kalon's settings on the Mac and iPhone, with defaults, plus the Mac's notch and keyboard shortcuts.

Kalon for Mac

Open Settings from your profile card in the sidebar. Settings opens as a panel over the window. Press Esc or click outside it to close. A search field at the top of the pane list filters the panes. Settings cannot be opened from a child profile.

General

SettingDefaultNotes
AppearanceSystemSystem, Light or Dark.

Models

SettingDefaultNotes
Automatic memory sizingOnSizes the context and GPU use to this Mac and declines models that cannot fit. See Models and memory.

The rest of the pane is the model catalogue, with Download, pause, cancel and Uninstall on each card.

Online models

SettingDefaultNotes
Use online modelsOffOff means local only.
Block all network accessOffBlocks all of Kalon's own connections, including downloads.

Below these, each provider has a switch, a field to paste an API key, Test, and a star to set the default online model. Add your own endpoint with Add provider. See Privacy and network.

SettingDefaultNotes
Use this Mac from your phone or iPadOffStarts the Kalon Link listener on port 11435.

Show code under Pair a device starts pairing. Paired devices lists each device with Remove. See Kalon Link.

Controls

SettingDefaultNotes
Press Enter to sendOnShift+Enter adds a line. When off, ⌘Enter sends.
Semantic search for documentsOffNeeds the 35 MB embedding model.

The pane also lists keyboard shortcuts.

Voice

SettingDefaultNotes
Spoken voiceBest availableKokoro voices, cloned voices and system voices.
Voice orb colorTealTeal or Pastel.
Dictate anywhereOn⌃⌥Space dictates into any app.
Voice starts a new chatOff
Push to talkOff
Mic sensitivityMediumHigh, Medium or Low. Hands-free only.

Your voice lists cloned voices and has Record a new voice. Neural voices lists the downloadable voice packs. See Voice and dictation.

Tools

Three tabs: Plugins, MCP and Skills. See MCP servers, skills, and plugins.

Memory

SettingDefaultNotes
Share memories with online modelsOffOff keeps your notes on this Mac.

The pane lists every note, with a delete button on each and Delete all.

Developer

SettingDefaultNotes
Local API serverOff
Port114341 to 65535.
Network accessOffOff keeps the server private to this Mac.
Command-line toolNot installedInstall puts kalon in /usr/local/bin.

See Local API.

Notifications

Under When a reply finishes:

SettingDefault
Play a soundOff
Show a notificationOff
Only in the backgroundOn

Security

SettingDefaultNotes
App passcodeOffFour to eight digits. Locks Kalon at launch.

With a passcode set, Change passcode and Lock now appear. ⇧⌘L also locks Kalon.

Family

SettingDefaultNotes
Family profilesOff
Weekly summaryOnApplies once Family profiles are on.

See Family profiles.

Account

  • Your photo and display name. The name defaults to the name of your macOS account.
  • Data folder with Reveal.
  • Backup: Create a backup and Import a backup. See Encrypted backups.
  • Delete all chats, after confirming. This cannot be undone.
  • About Kalon with the version.

Usage

Totals computed from a ledger kept on this Mac: tokens generated, busiest day, longest session, streaks, a token activity chart, activity insights and the most used models. With Family profiles on, it also shows screen time for each profile. Nothing in it is sent anywhere.

Notch

SettingDefaultNotes
Show the notchOffA small panel on the screen edge, above other windows.

The notch

The notch is a small black panel at the top centre of the screen with three rings. It stays visible when Kalon is in the background. Hover a ring for details.

RingShows
MemoryHow much of the memory Kalon may use is in use by loaded models.
ContextHow full the current conversation's context window is.
Kalon LinkWhether Kalon Link is off, ready, pairing or paired, and when a device is asking. Click it to open Settings › Kalon Link.

Rings are green below 75 percent, amber below 95 percent and red above. The notch is not shown in a child profile.

Keyboard shortcuts (Mac)

ShortcutAction
⌃⌥SpaceDictate into any app.
ReturnSend, when Press Enter to send is on. Also inserts dictation.
⇧ReturnNew line, when Press Enter to send is on.
⌘ReturnSend, when Press Enter to send is off.
⇧⌘LLock Kalon.
⇧⌘FShow the Files panel in Build mode.
EscClose Settings, menus and dialogs, discard dictation, or end voice mode.
Space (hold)Talk, in voice mode with Push to talk on.

Kalon also has a menu bar item with Open Kalon, Lock or Unlock, and Quit Kalon. Closing the window hides it; ⌘Q quits and stops the local API server, MCP servers and terminals.

Kalon for iPhone and iPad

Settings is one list divided into sections. Paths such as Settings › Privacy in these docs refer to those sections.

SectionSettings
AccountName and photo.
AppearanceSystem, Light or Dark, and Text size, which applies on top of your iOS text size.
ToolsLet Kalon use tools (off by default) and Skills.
VoiceThe voice that reads replies aloud, and the voice orb color.
DocumentsSearch documents by meaning.
NotificationsTell me when a reply is ready, Play a sound, Only when I am in another app, and Reminders.
FamilyFamily profiles, Profiles and Weekly summary.
PrivacyKalon Link, Online models, Let online models see your notes (off by default) and Block all network access (off by default).
SecurityPasscode, Change passcode and Lock now.
StorageModels and Fit models to this iPhone's memory (on by default).
DataUsage, Memory, Saved replies, Backup and restore and Delete all chats.
AboutThe engine version and working memory.

Reminders schedules a notification at a time you choose. It arrives as a normal notification whether or not Kalon is open.