VCode home

Browse for a folder and set the default

Agents: claude, codex, opencode · On: phone, desktop

The folder button above the folder box lets you walk the machine's folders instead of typing a path. Set as default then makes that folder the one new threads start in.

Why you would use it

New threads start in your home folder. If most of your work lives in one place, such as ~/git or a single repo, you would otherwise pick it on every new thread. Browsing also helps on a phone when you do not remember the exact path.

How to use it

  1. Open the new-thread card (#newthread), or the NEW THREAD section of the Threads sheet.
  2. Tap the folder button (.cwd-browse, "Browse folders") at the right end of the Folder label line, above the box. A folder list slides in from the right (#folderpick), open on the folder in the box.
  3. Tap a folder to go into it. Tap the up arrow (#folderpick-up, "Up") to go to the folder above.

The folder list over the new-thread card: the up arrow, the path ~/git, and two folders.

  1. Tap Use this folder (#folderpick-use). The list closes and the folder box holds the folder you were in.
  2. Tap Set as default (.new-default) to make it the default. Or tap Start thread to use it only this once.

The new-thread card with the picked folder in the box, Set as default and Start thread under it.

What you see

Options and settings

Option Default What it changes
default folder your home folder Where a new thread starts when no tab is open to take the folder from, and where the folder list opens when the box is empty

The default is kept per workstation. In the VCode app, Set as default saves it on the workstation picked in the card. It is the one setting that does not sync between workstations on your account: a change from another workstation never replaces it.

Limits and known gaps