> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clideck.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Projects

> Group your sessions by project with drag-and-drop organization

Projects are a lightweight way to organize sessions. If you're working on multiple codebases at once, projects keep things tidy.

## Creating a Project

1. Click the **New Project** button in the sidebar
2. Enter a project name
3. Choose a folder path (the default working directory for sessions in this project)
4. Pick an accent color (8 colors available)

Sessions created within a project automatically use the project's folder path.

## Organizing Sessions

### Drag and Drop

Drag any session in the sidebar to a project header to move it into that project. Drag it to the area above all projects to remove it from a project.

### Context Menu

Right-click a session and use **Move to project** to assign it to any project, or remove it from its current project.

### Session Launcher

When creating a new session, you can pick a project from the dropdown in the launcher. The working directory auto-fills from the project path.

## Project Groups

Sessions are visually grouped under their project header in the sidebar. Each project header shows:

* Project name (with accent color)
* Session count
* Collapse/expand toggle
* Menu button

Click a project header to collapse or expand it. Collapsed projects still show their session count.

## Managing Projects

Right-click a project header (or click its menu button) to:

* **Change color** — Pick from 8 accent colors
* **Rename** — Double-click the project name to edit
* **Delete** — Removes the project grouping. You'll be asked to confirm if the project has active sessions (sessions are closed, not just ungrouped)

## Resumable Sessions

When CliDeck restarts, previously saved sessions appear grouped under their original project in the **Previous Sessions** section.