Project Management

What is a project?

A project is a folder on your filesystem. Conductore scans a root folder (your repos directory) and groups all discovered repositories as projects. Each project can have multiple terminals, an accent color, git integration, and a task list.

Scanning projects

On first launch, Conductore prompts you to select a root folder to scan. All direct subdirectories that contain a .git folder are recognized as projects.

You can rescan at any time with the Refresh button in the sidebar header, or add individual folders via + Add Project.

Project groups

Projects are displayed in the sidebar as collapsible accordions. Click the project name to expand/collapse its terminal list. The project header shows:

• Project name
• Number of active terminals
• Git branch name (if a git repo)
• Accent color indicator

Right-click a project to access: New Terminal, Open in Explorer, Collapse/Expand, and Set Color.

Standalone terminals

Terminals not associated with any project appear at the bottom of the sidebar under a Standalone group. These are useful for system commands, package managers, or anything not tied to a specific repo.

Create a standalone terminal with the global + button at the bottom of the sidebar.

Shell configuration

Each terminal uses the shell configured for its project. Configure per-project shells in Settings → Shells:

• Default shell — used for all new terminals unless overridden
• Per-project shell — override the shell for a specific project
• Shell arguments — pass custom flags (e.g., --login, -c "source ~/.zshrc")

Supported shells:

Startup commands

Define a startup command for each project in Settings → Workspace. The command runs automatically in each new terminal for that project. Useful for:

• Activating a Python virtual environment: source .venv/bin/activate
• Loading environment variables: export $(cat .env | xargs)
• Starting a dev server: npm run dev

Accent colors

Each project has a configurable accent color. The color is used for:

• Terminal cursor color
• Active pane border highlight
• Project sidebar indicator

Set via right-click → Set Color or in Settings → Projects.

Search / filter

The search bar at the top of the left sidebar filters projects by name and terminals by title (case-insensitive). Standalone terminals are also filtered.