Accounts by folder

ccam folder work ~/code/company makes every launch without an account name inside ~/code/company, and in any folder below it, start Claude Code as work. Outside it, the default account starts as before. Naming an account, with ccam personal or a shortcut such as ccpersonal, always starts that account.

Usage

ccam folder work ~/code/company     # use work in ~/code/company and below
ccam folder personal                # use personal in the current folder
ccam folder                         # list the folders and the account used here
ccam folder --remove ~/code/company # stop using an account there
cd ~/code/company/api && ccam -p "summarise the open issues"   # runs as work

$ ccam folder work ~/code/company
✓ /home/me/code/company → work
  ccam without an account name starts work here and in every folder below.
$ cd ~/code/company/api && ccam folder
/home/me/code/company → work

Here (/home/me/code/company/api): work, set for /home/me/code/company

These launches use the folder's account:

• ccam -p "…" and any other launch whose first argument is an option for Claude Code
• ccam run without a name, and ccam --dry-run
• ccam --fallback -p "…" for its first attempt
• the picker, ccam alone, which starts with its cursor on the folder's account

Options

How it works

Each folder is one [[folder]] entry in ~/.config/ccam/config.toml, the file every launch reads anyway:

[[folder]]
path = '/home/me/code/company'
account = 'work'

1. ccam folder resolves the folder to an absolute path with symbolic links resolved and saves it. Setting a folder again replaces its account.
2. A launch without a name calls launcher.HereProfile. With no entries it takes the default account at once.
3. Otherwise it compares the working directory with each path as strings: the folder itself or one below it, never a folder that only starts with the same letters (/code/company does not cover /code/companyx). The deepest entry wins, so ~/code can be personal while ~/code/company is work.
4. Only if the working directory as it is matches nothing, ccam resolves its symbolic links and compares once more.
5. On Windows the comparison ignores upper and lower case, as Windows does.

No file besides config.toml is read, so a launch inside a folder costs no measurable time (4.0 ms with or without entries, hyperfine, 300 runs).

Safety and edge cases

• ccam rename carries the folder entries to the new name, and ccam remove deletes the entries of the removed account.
• An entry whose account no longer exists stops a launch without a name in that folder: <folder> is set to account "<name>", which does not exist. Change it with ccam folder. ccam doctor reports such entries, and entries whose folder is gone.
• ccam folder --remove inside a folder that gets its account from a folder above names that folder instead of removing anything.
• ccam next chooses by rotation or usage and does not look at folders.

Related

• Launching Claude Code
• Shortcut commands
• Managing accounts
• Command reference