Settings

The Settings sheet holds where Cuewire keeps its data and where new layers go, and leads to every other sheet of settings.

To open it, do one of these:

Press Ctrl+, (Cmd+, on a Mac).
Click Settings at the bottom of the sidebar.
Press Ctrl+K and choose Settings….

The data folder

Cuewire keeps your canvases, notes, logs and layers’ checkouts in one folder:

Windows	macOS	Linux
`%LOCALAPPDATA%\Cuewire`	`~/Library/Application Support/Cuewire`	`~/.local/share/cuewire`

Settings shows where the folder is now, and how big it is.

Move it to another drive

When your system drive is filling up, move the data folder to a drive with room, such as D:.

In Settings, under Data folder, click Move….
Choose an empty folder, or make a new one. It can’t be inside the data folder.
Read the note and click Move and reopen.

Cuewire closes, copies the data, checks the copy and opens again on the new folder. A notice says where your data now lives. The old copy is then deleted. Only a small file stays at the old place: location.json, which tells Cuewire where to look.

Note

Moving stops running terminals. You can resume your agents’ conversations afterwards, as after a restart. See Pick up a conversation.

Layers come along: their checkouts move with the folder, and git is told where they went.

If the move fails, nothing changes. Cuewire opens on the old folder and says why.

To move the data back, use Move… again and choose the old place. It must be empty, apart from location.json.

If the drive is missing

If the data folder is on a drive that isn’t connected, for example an external one, Cuewire won’t start. It says where it looked. Connect the drive and start Cuewire again.

To start with an empty data folder instead, delete location.json from the default place in the table above.

When the folder is set for you

If CUEWIRE_STATE_DIR or --state-dir sets the data folder, Settings says so and doesn’t offer Move…. Change the folder where it is set.

Where new layers go

Each layer is a full checkout of your project, plus whatever your agents build in it. Under New layers, choose:

Choice	Where the checkout goes
In the data folder (default)	Inside the data folder, under `worktrees`
Next to the project	Beside your project folder, in `<project>-layers`. For `D:\code\app`, that is `D:\code\app-layers\<layer>`

Next to the project keeps layers on the same drive as your code, and builds there are often faster. The choice only affects new layers: layers you already have stay where they are.

More settings

The buttons under More settings open the other sheets:

Button	What it sets
Account	Sign-in, your plan and the free trial. See Sign in.
Team	Your organisation, seats and policy. See Teams and organisations.
Roles	Roles you can give agents. See Roles, models and options.
Agent accounts	Accounts and API keys for your agents. See Roles, models and options.
Sync	Settings sync between your computers. See Settings sync.
Privacy	What Cuewire may send. See Privacy and security.
Phone companion	Pairing your phone. See Your phone as a companion.
About and updates	The version, and checking for updates. See Install Cuewire.

Cuewire also cleans up after updates by itself: an update’s setup program is deleted once that version is installed.

Keyboard shortcuts