Do my settings apply to every project or only one?
Both, depending on the setting. The Agent behaviour controls on the full settings page (final checks, sliders, persona and UI style) are the global default for every project. Each project can override those from a second gear (⚙) that sits on the quadrant itself, and that override follows the folder, not the quadrant slot. Appearance settings like theme and layout are global only; there is no per-project version of those.
The two gears
codus has two gear buttons, and they do different things:
- The ⚙ at the top-right of the titlebar opens the global settings, which apply everywhere. See Where do I change settings in codus?.
- The ⚙ on a quadrant's own header opens that project's settings, which apply only to the project pinned in that quadrant.
The per-project modal
Open a project in a quadrant, then click the ⚙ on that quadrant's header. A large modal opens. Its heading names the quadrant and project, and shows the full folder path and branch, so it is always clear exactly what you are changing. The modal has, among other things:
- Project label, a short name for what you are working on there.
- App preview address, a pinned address for that project's preview.
- Start commands, the commands codus runs to boot that project (dev / workers / free).
- Agent behaviour (folder), the per-project final checks, sliders, persona and UI style. See Final checks.
- Mini terminal text size, for the smaller terminal panes. This is a quadrant display preference, not a provider model or reasoning setting.
In the Agent behaviour (folder) area you see the same Testing rigor, Security rigor, Response style, and Brain chat sliders, plus Persona / vibe and UI fidelity / style, as on the global page. Change one and it applies to this project only. The hint under them reads:
Overrides the global defaults for this project only. Inherits global where unset; applies without a restart.
How overrides show and reset
When a slider or control here differs from the global default, it gets an Override badge and a Reset button next to it. Anything you have not touched stays inherited from the global default (no badge). Click Reset on a control to drop the override and go back to following the global value.
The override follows the folder
The per-project settings are tied to the project folder, not to the quadrant box. If you move that quadrant to a different folder, you see the new folder's own overrides instead. Bring the first folder back and its overrides come with it. This keeps each project's behaviour with the project. For more on quadrants and folders, see What is a quadrant?.
Before you start
You can only set per-project behaviour once a folder is pinned in the quadrant. With no folder pinned, the panel reads:
Choose a project folder to set project-specific agent behaviour. Global defaults apply until then.
Common problems
- I changed the global slider but one project ignored it. That project has an override for that slider. Open its quadrant ⚙, find the control with the Override badge, and click Reset to follow the global value again.
- I cannot find the per-project agent behaviour controls. They are inside the quadrant's own ⚙, not the titlebar ⚙. Make sure you clicked the gear on the quadrant header, and that the quadrant has a folder pinned.
How do I know it worked?
The project control shows the intended override, or follows the global value after Reset. Reopen that project's settings to confirm; changing an unrelated project's controls should not be needed.