Reference

Settings

Settings are saved automatically when you change them from the menu or a panel. There is no account and no syncing to a server.

File locations

What the settings hold

Open the Preferences dialog (Ctrl+,) for the color scheme, focus and typewriter modes, autosave, and the assistant model. Any command can also be searched with the Command Palette (Ctrl+Shift+P).

• The color scheme (follow the system, light, or dark), and the sidebar, its view that was last chosen, its width, and which sections of the Files view are folded or hidden, with their sizes (sidebar-sections)
• The last folder and the tabs with files that are open (order, active tab, cursor position), including the Home tab
• home: show Home when no document is open; recent-files: the 30 files that were opened last
• visual: the visual editor (on), or the live view with the syntax on the cursor line (off); focus mode, typewriter mode, and autosave; the window size
• The Assistant panel: open or not, the model, and thinking mode
• projects and project-options: the mapping of project name → folder for external harnesses, and its options. These (and machine-projects) are kept for each work folder separately: a folder opened for the first time starts with a copy of the lists of the folder before it, and Home, the Recent list, and the agents list only show what belongs to the open folder. The machines themselves are shared by every folder.
• Agents (Preferences → Agents): harness-machine, where harnesses run (in this window, on this computer through markworkd, or on a machine you added), machines, the SSH host of each machine, machine-projects, the project folders on those machines, and daemon-command, the markworkd command on them when it is not on the non-interactive PATH. See markworkd
• Collaboration (Preferences → General → Collaboration): forge-poll-seconds, how often to look for pull requests (30 to 3600 seconds), and forge-notify, whether a new or updated pull request raises a notification. The server and the repository come from the git remote of the folder; the token is not in the settings. See Collaboration

The API key and the access tokens of the servers are never written to the settings.

In a narrow window (below about 900 pixels), the Assistant panel floats over the editor instead of docking on the right; below about 600 pixels the sidebar does too. The panels are closed when the window narrows, and your panel choices are restored when the window is widened again.

The command palette

Ctrl+Shift+P opens a list of every command with its shortcut. Type a few words in any order (table row) and press Enter to run the first match.

Preferences

Ctrl+, opens Preferences with three pages: General (color scheme, the visual editor, focus and typewriter modes, Home, autosave, and how often to look for pull requests), Assistant (the model, thinking mode, and whether conversation history is saved), and Agents (where agents run, the machines, and the projects).

Default values

The API key

Markwork looks for the API key in the DEEPSEEK_API_KEY environment variable, then in the keyring, then in the fallback file. Enter or replace the key from the gear icon in the Assistant panel.