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

# Projects

> Persistent workspaces for sessions, files, and ongoing work

## What is a Project?

A Project keeps related work in one workspace: sessions, files, and ongoing work. Use one Project for a codebase, campaign, client, research topic, content pipeline, or any task you expect to continue over time.

This makes Projects useful for work that spans more than one conversation. Start a task in one session, continue in another, and the files are already there.

## Start a Project

Click **New Project** in the sidebar, then describe what you want Happycapy to work on. Happycapy creates the Project and names it automatically based on your first prompt.

You can start with a prompt, upload files, or open an existing file in the Project.

<Tip>
  One Project per codebase or initiative is a clean setup. Use multiple sessions inside that Project when you want to run related tasks in parallel.
</Tip>

## Work across sessions

<div style={{ display: 'grid', gridTemplateColumns: 'minmax(220px, 0.8fr) minmax(280px, 1fr)', gap: '28px', alignItems: 'start', marginBottom: '24px' }}>
  <div style={{ borderRadius: '14px', border: '1px solid rgba(45, 36, 27, 0.12)', boxShadow: '0 18px 46px rgba(56, 38, 20, 0.09)', overflow: 'hidden', background: '#FFFFFF' }}>
    <div style={{ padding: '12px 16px', borderBottom: '1px solid rgba(45, 36, 27, 0.08)', background: '#FFFFFF', fontFamily: '-apple-system, BlinkMacSystemFont, "SF Pro Text", "SF Pro Display", "Helvetica Neue", Arial, sans-serif' }}>
      <span style={{ display: 'block', color: '#2E2929', fontFamily: 'Instrument Serif, Georgia, "Times New Roman", serif', fontSize: '22px', fontWeight: 400, lineHeight: '1' }}>Sessions</span>
      <span style={{ display: 'block', marginTop: '6px', color: '#8A8178', fontFamily: 'Instrument Serif, Georgia, "Times New Roman", serif', fontSize: '16px', fontWeight: 400, lineHeight: '1.15' }}>Parallel work, shared workspace.</span>
    </div>

    <img src="https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/features/desktop-sessions.png?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=8cee715f6e9fd0147fafbeefff607cf2" alt="Multiple sessions in a Project" style={{ maxWidth: '100%', display: 'block', margin: '0 auto' }} width="554" height="598" data-path="images/features/desktop-sessions.png" />
  </div>

  <div>
    <p style={{ marginTop: 0 }}>Inside each Project, you can run multiple sessions at the same time. Each session is its own conversation thread, but they work in the same Project workspace.</p>
    <p>Practical uses:</p>

    <ul>
      <li>One session generates images while another writes the accompanying copy</li>
      <li>One session handles frontend code, another handles the backend</li>
      <li>One session researches a topic, another drafts the report</li>
    </ul>
  </div>
</div>

<p><strong>To open a new session:</strong> click the <strong>+</strong> button next to the session name at the top of the Project.</p>
<p><strong>To switch between sessions:</strong> click the session name dropdown at the top.</p>

## Keep files together

Sessions in the same Project can read and write the same files. Generated images, edited documents, code changes, reports, and other outputs stay with the Project instead of being scattered across separate conversations.

For more detail on browsing and managing project files, see [Files](/en/features/files).

## Folders and favorites

Folders group Projects in the sidebar. Click the **+** icon next to "Projects" (Create Folder) to make one.

Folders only change how Projects appear in the sidebar. They do not change the Project itself.

Click the **☆** icon in a session's header to pin it to the **Favorites** section at the top of the sidebar. Click again to remove it.