Settings and customization

• Appearance: theme, color scheme, reading width, interface scale, diffs, and motion.
• Providers: sign-in and API keys for the providers Pi supports.
• Agent: reasoning defaults, retries, compaction, images, and project trust.
• Usage: local cost and token history, plus subscription limits from an installed usage package.
• Extensions: package installation, reloads, errors, and package-provided settings.
• Workbench: terminal preferences and keyboard shortcuts.
• Access: local and public browser links, connected devices, and token controls.
• System: startup, notifications, updates, versions, diagnostics, and Pi file locations.

On a narrow screen, open the sidebar button to switch categories. Use Back to return to the chat, or press Escape when no dialog or menu is open.

Follow the operating system appearance or choose light or dark mode. NativePi includes ten color schemes, each tuned separately for both appearances. You can also create named schemes by editing semantic colors, then export or import them as JSON.

Open Settings → Workbench for the shortcut list. Select a shortcut and press the new key combination; NativePi reports conflicts before it saves the change. Reset an individual shortcut or restore all defaults at any time.

NativePi owns notification preferences, the preferred editor, pane state, and other window behavior. These settings affect only the desktop and browser surfaces, not how Pi runs a turn.

Settings exposes the user-scoped Pi options that make sense in a desktop window. NativePi reads and writes them through Pi's settings manager rather than editing its file format. The Pi command line sees the same values.