> ## 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.

# Files

> Find uploads, output files, and project files in one place

## What are Files?

Files is the file browser for your Happycapy sandbox. Use it to find uploaded materials, Project files, and output files Happycapy creates while working.

Files is especially useful after tasks that produce assets, reports, code, data exports, images, or videos.

## Open Files

<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', marginBottom: '24px' }}>
  <div style={{ padding: '12px 16px', borderBottom: '1px solid rgba(45, 36, 27, 0.08)', background: '#FFFFFF' }}>
    <span style={{ display: 'block', color: '#2E2929', fontFamily: 'Instrument Serif, Georgia, "Times New Roman", serif', fontSize: '28px', fontWeight: 400, lineHeight: '1' }}>Files</span>
    <span style={{ display: 'block', marginTop: '6px', color: '#8A8178', fontFamily: 'Instrument Serif, Georgia, "Times New Roman", serif', fontSize: '18px', fontWeight: 400, lineHeight: '1.2' }}>Browse uploads, output files, and Project files.</span>
  </div>

  <img src="https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/features/files-browser.png?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=ec788d745afc8278c71d79afc3029bc2" alt="Files browser" style={{ maxWidth: '100%', display: 'block', margin: '0 auto' }} width="1586" height="1016" data-path="images/features/files-browser.png" />
</div>

Open **Settings**, then click **Files**.

You can browse files from:

* **Home** — files in your sandbox
* **Projects** — files grouped by Project
* **Skills** — installed Skill files

## Find and manage files

Use search to find files by name. Switch between grid and list view when you need to scan images, folders, or file details.

You can open files, preview supported formats, rename, move, delete, or download files from the file browser.

## Upload files

Attach files from the input box with **+**, or drag files into the conversation. Happycapy can use those files as context for the task.

Happycapy can work with many common file types, including documents, spreadsheets, presentations, images, videos, archives, code files, Markdown, CSV, JSON, and more. If you are unsure, upload the file and ask Happycapy to read or inspect it.

## Work with outputs

When Happycapy creates files, they are saved in your sandbox and can be found in Files.

For example, you can ask:

```text theme={null}
Package the images in this Project into a zip file so I can download them.
```

## Files and Projects

Project files stay with the Project. Sessions inside the same Project can read and write the same files, so you can continue work across sessions without re-uploading the same files.

See [Projects](/en/features/projects) for how Projects organize sessions and files.

## Locate files from a Project or session link

When a conversation link matches either format below, the value after `/s/` is the Project ID. Use that Project ID when searching Files for JSONL logs or workspace files.

<div style={{ border: '1px solid rgba(250, 161, 92, 0.44)', borderRadius: '14px', padding: '18px 22px', overflowX: 'auto', fontFamily: 'ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace', fontSize: '0.95em', lineHeight: '1.8', whiteSpace: 'nowrap' }}>
  <div>Conversation link</div>
  <div>https\://<a href="https://happycapy.ai" style={{ fontWeight: 400 }}>happycapy.ai</a>/s/<strong>d94c8b54-161d-4278-a3f5-16e5046d66cd</strong></div>

  <br />

  <div>Conversation link with a sub-session</div>
  <div>https\://<a href="https://happycapy.ai" style={{ fontWeight: 400 }}>happycapy.ai</a>/s/<strong>d94c8b54-161d-4278-a3f5-16e5046d66cd</strong>?sub=48c366cc-a0e0-4bf4-ac56-4fa52c7cd7a7</div>

  <br />

  <div>Project ID</div>
  <div><strong>d94c8b54-161d-4278-a3f5-16e5046d66cd</strong></div>
</div>

### Find JSONL logs

Open **Files**, go to `Home > .claude > projects`, and search for the **Project ID** from the link.

The matching folder contains `.jsonl` logs for conversations under that Project. Each `.jsonl` represents one conversation, including the main session or a sub-session.

### Find the workspace files

Open **Files** and use either route:

* Open **Projects** and search for the same **Project ID**.
* Or go to `Home > a0 > workspace` and search for the same **Project ID**.

The matching Project or workspace folder contains files Happycapy created or edited under that Project.

### If something went wrong

You can inspect those files yourself, or open a new session and ask Happycapy:

```text theme={null}
Under /home/node/.claude/projects/, find the folder for d94c8b54-161d-4278-a3f5-16e5046d66cd (Project ID), back up the corresponding JSONL log, diagnose what went wrong, fix it, and resume this conversation.
```