Project Tree Overview
The project tree is the left sidebar of Needlecast. It organizes all your projects into color-coded folders, making it easy to switch between contexts.
Features
Color-Coded Folders
Each folder can have its own color:
- Blue — Work projects
- Green — Personal projects
- Orange — Experiments
- Red — Urgent/priority
- And more…
Right-click a folder → Change Color to customize.
Git Status Indicators
Projects show their git status at a glance:
- Clean (no changes) — shows branch name
- Dirty (uncommitted changes) — shows ● indicator
- Ahead/behind remote — shows ↑ or ↓
File Watcher Auto-Refresh
When build files change (pom.xml, package.json, etc.), Needlecast automatically rescans and updates the command list.
Keyboard Navigation
- Ctrl+P — Open project switcher (fuzzy search)
- Arrow keys — Navigate tree
- Enter — Activate selected project
- F5 — Rescan all projects
Context Menu
Right-click any item for options:
- New Folder — Create organizational group
- Add Project — Add project directory
- Rename — Rename folder or project
- Delete — Remove from tree (not from disk)
- Change Color — Customize folder color