Settings

Tucan Studio -> Settings opens the settings window. A list of sections runs down the left; the Save button at the bottom writes everything at once. Closing the window without saving leaves the stored settings untouched.

Settings are stored beside the studio binary in config/settings.json, so they follow the INSTALL rather than the open project -- every workspace sees the same values.

File tree

Filters for the folder tree in the left sidebar. All three are off by default, so a fresh install shows everything.

• Hide .info files -- drops the Workbench metadata sidecars.
• Hide .git folders -- hides git's internal directory. Repo detection and the per-row git colouring still use it; it is only hidden from the tree.
• Hide .studio folders -- hides the per-workspace state folder. Off by default so you can open the files in it.

Git

• Git path -- the git executable the Git tab runs. EMPTY by default, because most Amiga systems have no git: the Git tab prompts you to set this or to install the am-git extension, which points it at its own binary. A bare name like git is looked up on PATH; an absolute path is used as given. Browse... opens a file requester.
• Repo scan depth -- how many folder levels below the workspace the studio looks for repositories, each with its own .git. The workspace root is 0, its children 1, and so on; the default is 3 and the range is 0-16. Keeps vendored clones deep in a dependency tree out of the Git tab.

Shortcuts

One field per editor action -- Copy, Cut, Paste, Undo, Redo, Save. Type the platform modifier plus a letter (Cmd+C, Ctrl+C, or Amiga+C). See the Keyboard Shortcuts topic for the defaults.

• Hold Shift to select text -- on, selection works the desktop way: hold Shift while moving the caret. Off, selection is a mode toggled with Ctrl+B, which suits keyboards without a comfortable Shift+arrow reach.
• Shift+Up/Down = Page Up/Down -- on by default. The dedicated Page Up / Page Down keys always page, whatever this is set to.

Shortcuts live in config/shortcuts.json, next to the settings.

Editor

• Cache rendered lines as bitmaps -- draws each text row once into a bitmap and blits it on later paints instead of rendering glyphs again. Faster scrolling on 68k, at the cost of RAM proportional to the visible lines. Off by default.

Input

Mouse-wheel behaviour, applied to every scrollable in the studio -- editor, sidebars, chat, terminal, lists, and anything an extension adds later. The wheel delta is scaled once, where the window dispatches it, rather than per widget: each scrollable multiplies it by a step in its own units, so this is the only place a single setting can reach all of them.

• Scroll speed -- wheel notches applied per physical tick, 1 to 10. 1 is the studio's original speed; raise it if the wheel feels slow. A value outside the range, or one that is not a number, is ignored and the stored value kept -- 0 in particular would read as a dead mouse.
• Reverse wheel direction -- off, rolling the wheel down moves the view down, which is the AmigaOS, Windows and Linux convention. On gives the "natural" direction macOS defaults to. Which one feels right is a habit, not a fact.

Both take effect on the next wheel tick -- no restart.

CLI

• Stack size (bytes) -- the stack given to a command the Workspace CLI spawns. Default 100000.

  This matters most on AmigaOS and MorphOS, where a task's stack is a fixed allocation made when the task is created: a child that recurses deeper than its allocation corrupts memory instead of failing cleanly, and the symptom shows up a long way from the cause. Compilers and parsers need far more than a shell command. On macOS and Linux the value is a floor -- it raises the stack limit when that is lower, and never lowers it.

Downloads

• Aminet download path -- where the Aminet panel and Studio Transfer write received files. Defaults to $HOME/Downloads on desktop systems and RAM: on AmigaOS and MorphOS. Browse... opens a folder requester.

AI Agent

Everything in this section is stored in config/ai-agents.json, together with the configured services themselves.

• Instructions -- overall instructions given to the agent in every workspace, on top of the studio's own system prompt. Use it for house style, target platform, or anything you would otherwise repeat in each session. Skills are NOT listed here: the agent discovers them itself through its get_skills / get_skill tools.
• Shell commands -- one per line, as command | description. The agent is told to prefer these, which is what stops a model reaching for Linux commands on AmigaOS. It can propose additions through add_command when you ask it to.
• Allow all commands beyond the list -- on by default, which makes the list a hint: run_command accepts anything. Off makes it a real allow-list, and the agent may only run the commands named above. Shell metacharacters are rejected either way.
• Compact older turns at ... % -- when the conversation reaches this share of the model's context window, older turns are summarised to make room. Range 10-95, default 75.
• Hosted tools -- Web search and Code execution (provider-side sandbox) ask the AI provider to run its own tools on its servers during a turn. They are independent of agent mode, which runs tools here on your machine, and only apply to providers that offer them.

Settings with no window entry

A few values are read from config/settings.json but have no control in the window. Edit the file and restart:

syntaxHighlightingEnabled set to false opens every file in a plain editor, whatever its type -- worth trying on a slow machine where per-line tokenizing costs more than the colours are worth.

A missing key takes its default, so a settings file written by an older studio still loads cleanly.

The other configuration files

All of these sit in config/ next to the binary and are read at startup.

Per-WORKSPACE state lives in <workspace>/.studio/ instead: menus.json (Workspace menu commands), repos.json (the git repo registry) and ai-sessions.json (chat history for that project).