Settings and first launch

Settings open with Ctrl+, (on macOS — ⌘,) or from the column on the left. Pressing Ctrl+, again or Esc closes them; next time they open on the same tab.

First launch

On first launch the window gives a three-step introduction. Any step can be skipped, but every choice changes something:

1. What do you do? — which mode new sessions start in: “Development” → “Edit on its own”; “Questions and code review” → “Ask” and “Plan”; “Documents and knowledge” → “Ask”.
2. Theme and text size — as in the system, light or dark, and the text size; it changes immediately.
3. What to turn on? — the project memory (AGENTS.md) and checking project hooks and commands (see trust).

At the end — “Sign in to Buff” if you are not signed in yet; “Later” leaves the window without a model, and above the input field there will be a reminder “No model — sign in to Buff”. To go through the introduction again — “Settings → General → Go through again” or Ctrl+Shift+H. How to sign in and choose a project — Sign-in and working context.

General

• Language — Russian or English. The window switches language immediately; the console and buff run take the same language and pick up a change on the fly. Russian by default.

• Where to start sessions, Auto-accept permissions, follow-ups during a turn (“steer” the current turn or queue up; Ctrl+Enter switches) — the default behaviour.

• Feed detail — compact (work grouped, details collapsed) or expanded.

• Getting to know Buff Code — “Go through again”; shortcut Ctrl+Shift+H.

• Network (in the window only):

  • Proxy server, login and password (the password is stored encrypted by the system’s means);
  • No proxy — addresses and patterns, comma-separated; your own machine is always direct;
  • Organization certificate — a .pem file, if the company proxy substitutes certificates.

  The proxy applies to the whole app and takes effect after a restart — after saving, the window offers “Restart now”. Empty — the system proxy.

Appearance

• Color scheme — as in the system, light, dark.
• Fonts — for the interface, code and the terminal.
• Font size — interface (12–20) and code (10–24: files, changes, code blocks in answers, the terminal), with a live sample; “Default sizes” returns everything as it was.
• Tabs — vertical (a column on the left with the session list, the default) or horizontal at the top.

Keyboard shortcuts

A list of all window commands with their shortcuts.

• Click a shortcut and press a new one. A shortcut without Ctrl, Alt or Shift is not accepted — the reason is written right in the row (the F1–F24 keys work without a modifier too).
• If a shortcut is taken, the window asks: “Keys taken: Ctrl+P already belongs to … Reassign?” — it is removed from the other command only after “yes”.
• “Find by keys” in the header: press a shortcut — only the commands with it stay in the list.
• Reset all shortcuts — after a confirmation.

The most useful defaults:

On macOS use ⌘ instead of Ctrl (except Ctrl+B). The full list with search is in the section itself.

Phone

“Phone” — the Buff app on an iPhone or Android connected to this machine: “Pair a phone” (a QR code, or a link and a code), “Paired phones” with renaming and disconnecting. The Buff Code service keeps the connection, so the phone sees the machine even with the window closed. In the console the same — the /phone command. Step by step — Connecting to Buff Code.

Providers

“Settings → Providers” — the Buff sign-in and the organisation’s models: the line Buff · Sign-in through the connector · your login · organisation and “Disconnect”. If you have no organisations yet, the window says so and suggests asking the administrator. In detail — Sign-in and working context, Models and usage.

Extensions

MCP servers, skills, commands, subagents, memory and hooks are on a separate page: Extensions.

In the console