Configuration

Noodle stores persistent settings in ~/.config/noodle/config.yml. The file is optional: all fields fall back to defaults if missing.

theme: catppuccin
layout: stacked
confirm_undo_all: true
external_editor: vscode
collections:
  - /home/user/projects/my-api
  - /home/user/projects/other-api
proxy:
  mode: custom
  url: http://proxy.example:8080
  bypass: [localhost, .internal.example]
  auth: true

Fields

Field	Type	Default	Options	Description
theme	string	catppuccin	Any built-in theme name	UI color theme
layout	string	stacked	stacked, side-by-side	Pane arrangement
confirm_undo_all	boolean	true	true, false	Show confirmation before Ctrl+Z undo-all
external_editor	string	First detected editor	zed, vscode, sublime, cursor, windsurf, vscodium	Editor used to open collection and application settings directories
collections	string[]	[]	List of absolute paths	Previously-used collection directories. Managed by the collection switcher (Ctrl+O); listed in most-recently-used order.
proxy	object	System proxy	system, off, custom	Global request-routing policy. A custom proxy needs an HTTP or HTTPS url and may include a string-array bypass list.

Noodle adds and reorders collections automatically when you switch to a new directory. No need to edit this by hand. Use noodle workspace audit --fix to remove stale paths that no longer exist on disk.

Custom proxy URLs cannot contain credentials or variables. When auth: true, the username and optional password live in the OS credential vault and must be managed through Settings. See Settings for proxy scope, precedence, bypass rules, and the interactive workflow.

Partial files are fine: only the fields you include are overridden:

theme: dracula