Docs

Settings

A tour of LinkCode's desktop Settings — appearance and terminal preferences, notifications, the daemon connection, agents, provider accounts, and messaging.

Open Settings from the gear icon in the sidebar footer, the command palette, or ⌘, / Ctrl+,. Tabs are grouped into Personal, Integrations, and System, and there's a search box across all of them.

Personal

General — interface language (Auto follows your system) and whether to share usage analytics. Analytics are off by default and never include conversations, code, paths, or terminal content.

Appearance — theme (System / Light / Dark), text size, reduce motion, list density for long lists like the thread sidebar, which side the Files panel's tree docks to, light and dark code themes for chat code blocks, and custom UI and code fonts.

Terminal — font family and size, and the color scheme (which can follow the app's light/dark mode).

Notifications — system notifications when a thread finishes a turn in the background, needs your approval, or hits an error. Each is switchable on its own.

Integrations

Agents — which agents appear when you start a thread, and the runtime state of each: whether LinkCode is using a Managed, Detected, SDK, or Built-in copy, and whether it's Not installed, Unverified, or Signed out. See agents.

Providers — the accounts your agents authenticate with. Add a subscription (Claude, ChatGPT), a direct API key (Anthropic, OpenAI, xAI), a gateway (OpenRouter, Vercel AI Gateway, Cloudflare AI Gateway), or a custom endpoint, then connect it to the agents that should use it. One account can back several agents; each agent uses one account at a time. An agent with nothing connected falls back to its own CLI login.

Each account declares a protocol shape (Anthropic, OpenAI Chat, or OpenAI Responses), which is what decides where it can be used — LinkCode says why an account isn't available for a given agent rather than letting you connect it and fail later. Some combinations route through a local translation step, which is marked in the list.

Settings → Providers: an account list with connected agents, credential type, and protocol shape

Screenshot coming soon

/images/docs/interface-settings-providers.png

Messaging — connect Telegram so you can drive threads from a group topic. Requires a LinkCode Cloud sign-in; see messaging.

System

Daemon — overrides the address of the host (the LinkCode daemon) this client connects to. Leave it empty and LinkCode discovers the local host automatically; set it explicitly to point at a host on a different port or one you started with a custom configuration. Saving reconnects immediately.

Developer — settings you shouldn't change unless you have a reason to.

About — the installed version and a Check for updates button. Desktop builds also check on their own; when an update is ready the sidebar offers Restart to update.

Where settings are stored

Agent, provider, and account settings live on the host machine — credentials in an encrypted store, everything else in a config file only its owner can read. Appearance and connection preferences belong to the desktop app itself. Neither is synced anywhere. See local data.

On this page