New sessions and workspaces
A new session: N
N starts a new Claude session in the project in front of you, in a tmux window of its own. What you type in the box is its first prompt.
| Key in the box | What it does |
|---|---|
Tab | give the session a git worktree of its own (claude --worktree), so two sessions do not edit the same files |
Ctrl-O | pick another folder |
Enter | start the session |
After Ctrl-O, type a path. The matching folders are listed underneath: Tab completes and the arrows choose. A folder that is not there yet is made when the session starts.
Trusting a folder
The first time Claude Code starts in a folder, it asks whether you trust it. aq shows the question in its own box:
| Key | What it does |
|---|---|
y | trust the folder |
n | close the new session |
a | trust every folder waiting |
When several sessions ask at once, they are asked about in turn.
Workspaces: O
A workspace is a set of git repos in one folder, for work that spans them. O opens one:
- Pick the folder that holds the repos. aq finds the git repos inside it, up to two levels down, and ticks them all.
Spaceunticks a repo you do not want;aticks all or none.Enterstarts a Claude session in each repo, as windows of one tmux session named after the folder. They share a row of tabs in the sessions view.
aq saves the set in its config, and O lists it next time. Opening it again starts only the repos that have no session in that tmux session yet.
Sessions opened from a workspace are told about each other and about aq tell, so they can ask each other for work.