Settings

Open Settings with ⌘,. The Mac app also keeps every setting in ~/.knighn/settings.json, grouped as below. A change to the file applies at once, and a value that is not valid is left out with a warning in the log. Passwords and tokens are never in the file: they stay in the macOS keychain.

Open the settings file (on the web)

General

In the file: general.

Key	What it does	Default
autosave	Saves a design 3 seconds after your last edit, when it has a place to save.	true
agentGlow	Shows a soft light around the window while an agent edits a design.	true
recoverUnsavedWork	Keeps a copy of designs that are not saved yet, in case the app closes.	true
shareUsageAnalytics	Sends anonymous product events. Never design content or file names.	true
notifyInBackground	Notifies you when a job or a reply ends while Knighn is in the background.	true

Editing

In the file: editing.

Key	What it does	Default
snapToGeometry	Snaps to the edges and centres of other layers while you drag.	true
snapToObjects	Snaps to the spacing between layers while you drag.	true
snapToPixelGrid	Keeps positions and sizes on whole pixels.	true

View

In the file: view.

Key	What it does	Default
pixelPreview	Shows the canvas as pixels, as it looks at 1x.	false
layoutGrids	Shows the layout grids of frames.	true
minimap	Shows the minimap of the canvas in a corner.	true

Storage

In the file: storage.

Key	What it does	Default
provider	Where new designs save: knighn-cloud (on Knighn) or this-mac.	"knighn-cloud"

Agents

In the file: agents.

Key	What it does	Default
speed	How much Claude Code thinks before it acts: fast, balanced or thorough.	"balanced"
allowEverything	The chat allows every edit, command and tool an agent asks for, without asking you.	true
claudeModel	The model Claude Code uses in the chat; "default" lets it choose.	"default"
codexModel	The model Codex uses in the chat; "default" lets it choose.	"default"
mcpTools	The tools the local MCP server offers: native (search and execute), or the tools of Paper or Pencil, so agents made for them work on Knighn designs.	"native"
mcpDisabledTools	MCP tools to leave out, by name.	[]
mcpRequireToken	The local MCP server asks each client for its token.	true

Import

In the file: import.

Key	What it does	Default
webPageDarkMode	Web page and HTML imports capture the page in its dark colour scheme.	true
webPageHideOverlays	Web page and HTML imports leave out cookie banners, chat widgets and pop-ups.	true

Connections

In the file: connections.

Key	What it does	Default
vercelTeamId	The Vercel team that preview deploys go to.	null
convexUrl	The Convex deployment that data bindings read.	null

Project tabs

In the file: code.

Key	What it does	Default
hideOverlays	Project tab frames hide the app's start-up overlays: onboarding, cookie banners and chat widgets.	true