Settings

Open Settings with Ctrl+,. Use the search box to find a setting. Changes apply immediately, and Settings works while the server is offline.

Sections

Section	What’s in it
General	Closing behavior, the app that opens files, window size, worktree locations
Composer	Dictation, clearing, image submission, font
Appearance	Language, light and dark themes, sidebar, status bar
Keyboard	Every shortcut. See Keyboard shortcuts
Commands	Your own commands, each run in a new tab, with optional shortcuts
Terminal	Fonts, spacing, transparency, colors, cursor, padding, selection, scrolling, key bindings
Browser	The built-in browser: terminal links, search engine, home page, profiles, import
Server	This computer’s server: shell, history, shell integration, stop and restart
Kibbles	Installed kibbles and the marketplace
AI	Tools and prompts for Git actions
Backup & Restore	Export and restore

Files

Settings are plain files in Nana’s profile folder. Edit in… at the top of a section opens its file.

File	Holds
`settings.toml`	App preferences, shortcuts (`[keymap]`), commands, remote servers
`terminal.toml`	Terminal preferences and key bindings
`themes/`	Your own themes
`server.toml`	Server settings

Restart the app after editing settings.toml by hand. If the file has an error or an unknown key, the app won’t open; see Troubleshooting.
Hand edits to terminal.toml apply when Nana or Settings becomes active. If the file has an error, Settings shows it and keeps the last good values.

Terminal configuration

Use Settings → Terminal for:

Font family, fallback fonts, bold and italic fonts, size, line and character spacing, ligatures and other font features, fonts for Unicode ranges, thicker strokes, and bright colors for bold text.
Background transparency, optionally including colored cells.
Cursor shape, blinking, opacity, and thickness. Thickness accepts an adjustment in physical pixels or a percentage: 1 adds one pixel and 100% doubles it. It applies to bar, underline, and outlined cursors. Terminal programs can override cursor shape and blinking.
Separate sliders for left, right, top, and bottom padding, with balanced unused space and a padding color.
Background, text, cursor, selection, and the 16 ANSI colors. Each replaces the theme’s color; leave it empty to use the theme.
Copy on select, clearing selection when typing or copying, mouse reporting, separate trackpad and mouse wheel speeds, and scrolling to live output.
The working directory for new panes.
Key bindings the terminal handles while focused: record a key, then pick an action such as sending text. They win over app shortcuts. You can also turn off the built-in terminal bindings.

Numeric controls use sliders, on/off options use switches, and fixed choices use dropdowns. Sliders preview changes while dragging and save when released or when Settings closes. Spacing and thickness offer a pixels/percent dropdown; changing units keeps the numeric adjustment within the supported range.

Reset terminal settings, at the bottom of the section, returns everything on it, including key bindings, to its default after you confirm.

Themes remain in Settings → Appearance. Shell and history limits remain in Settings → Server.

Themes

Nana ships about 490 themes. Pick the app’s light and dark themes in Settings → Appearance, or press Ctrl+Alt+K. Nana follows the system’s light or dark mode.

Custom themes in the profile’s themes/ folder show up too. The chosen theme colors the app and its terminals.

Backup and restore

Export… saves a .nana file with your settings, terminal.toml, themes, server settings, kibble preferences, remote server list, and local projects with their layouts.
Choose file… under Restore backup restores on the next launch. Nana keeps a recovery copy in the profile’s Backups/ folder. Existing projects are kept and get the saved layouts.
Backups never include running terminals, paired phones, kibble packages, remote projects, or project files.

Kibbles

Settings → Kibbles → Browse installs kibbles from the marketplace. New kibbles start disabled; review their permissions and turn them on. Updates are manual: use Update all, or update one from its page. Building your own? See Kibbles.

Language packs are kibbles too. Pick a language in Settings → Appearance → App language, or choose Browse language kibbles….