# Project context menu

Right-clicking a project header in the sidebar opens a native context menu with actions for that project as a whole.

## How to open it

- **Right-click** the project name or header area in the sidebar.
- On a trackpad, use a two-finger click or `Control+click`.

## Available actions

The menu groups related actions into a **Commands** submenu and an **Add** submenu, followed by project-level actions.

### Commands

The **Commands** submenu holds the bulk lifecycle actions, then command-management actions when they apply.

| Action | What it does |
|--------|-------------|
| **Start all commands** | Starts commands that aren't already running. |
| **Stop all commands** | Stops running command processes in the project. |
| **Restart all commands** | Stops and restarts command processes in the project. |
| **Restart running commands** | Restarts only command processes that are currently running. |
| **Duplicate all commands to** | Opens a submenu of other projects, grouped by workspace when you have more than one. Choose one to copy every command in this project into it. Appears when the project has commands and at least one other project exists. |
| **Trust all commands** | Appears when the project has [untrusted commands](../commands/trust-security.md). |
| **Show lesser-used commands (N)** | A checked toggle that appears when stopped commands have been marked as [lesser used](../commands/lesser-used.md), where **N** is the current number eligible to show. |

These bulk actions apply to managed commands, not to agents or ad hoc terminals.

### Add

The **Add** submenu creates something new in the project.

| Action | What it does |
|--------|-------------|
| **Scratchpad** | Creates and opens a new scratchpad for the project. |
| **Todo** | Creates and opens a new empty todo for the project. |
| **Command...** | Opens the [add-command flow](../commands/adding-removing.md) for the project. |
| **Terminal** | Creates a new terminal in the project. |
| **Agent** | Opens a submenu of enabled, launchable [agent tools](../agents/setting-up-tools.md), or shows **No ready agents** when none is ready for the project environment. |
| **Agent with flags** | Opens the same agent-tool submenu, then opens the selected tool's launch flow with custom flags. |

### Project management

| Action | What it does |
|--------|-------------|
| **Add project...** | Opens the add-project flow. This item sits at the top level of the menu, not inside **Add**. |
| **Copy link** | Copies a Solo [deep link](../integrations/deep-links.md) for the project. |
| **Go to todos** | May appear from navigation-oriented project menus. |
| **Go to scratchpads** | May appear from navigation-oriented project menus. |
| **Move to workspace** | Opens a native submenu where you can choose another [workspace](../workspaces/overview.md) or create one and move the project there. |
| **Edit project...** | Opens the project details pane where you can rename, [change the icon](./project-customization.md), or customize. |
| **Remove project** | Removes the project from Solo. Doesn't delete any files. |

## Notes

- **Remove project** first asks for confirmation. After you choose **Remove**, a successful removal has no undo: Solo deletes the project record, its managed processes, and associated project-scoped Solo data such as todos, scratchpads, comments, agent coordination state, and, by default, project prompt templates. Files on disk, including `solo.yml`, remain untouched. You can re-add the project while its directory still exists and is a directory, provided the applicable [project and process license additions](../account/free-tier.md) are permitted.
- The **Move to workspace** submenu marks the current workspace and disables it. Choose another workspace to move immediately, or choose **New workspace…** to enter a name and move the project in one step. If the destination list is too large for the native menu, **Choose workspace…** opens a searchable picker instead.
- If the enabled agent-tool list is too large for the native menu, the **Agent** and **Agent with flags** submenus show **Choose agent…**. It opens a searchable picker for the same ready tools.
- Quick actions like **Open in editor**, **Open in terminal**, **Reveal in Finder**, and **Open on GitHub** live on the hovered project header, not in this context menu. **Open on GitHub** appears only when the project has a GitHub remote. Their visibility is controlled under [Settings > Sidebar](../settings/sidebar-settings.md#project-header-quick-actions); **Open in editor** also needs a project editor override or configured default editor, and **Open in terminal** also needs a configured default terminal.
- The context menu is built from native system-menu primitives.

---

Are you a human? Read this doc on the web: https://soloterm.com/docs/projects/project-context-menu