Projects
A project is a git repository you've opened. The sidebar groups all your work by project, and one project can hold many parallel workspaces.
Opening a repository#
Click the folder-plus icon in the Projects header (or Open a repository…when empty) and choose a folder. NeuralCode verifies it's inside a git work tree, resolves the repository's top level, and reads its current branch as the project's base branch. The project name is derived from the folder.
Anatomy of a project row#
| Element | Meaning |
|---|---|
| Chevron | Collapse / expand the project's workspaces. Collapse state is remembered per project. |
| Folder icon + name | The repository. Hover the name to see its full path. |
| Branch label | The project's base branch (e.g. main), shown with a branch icon. |
| Bug icon | Open the repo's GitHub issues to turn one into a workspace. |
| Plus icon | Create a new workspace in this project. |
The base branch#
The base branch is what new workspaces branch from and merge into. It defaults to whatever the repo's HEAD was when you opened it, but you can choose a different base each time you create a workspace.
Worktree storage#
A project's workspaces are checked out as git worktrees in NeuralCode's data directory — not inside your original repo folder — so your working copy stays clean. You can see the exact location under Settings → Git → Worktree storage.