Opening the File Explorer

• Press Cmd+F / Ctrl+F
• Click the Files icon in the session header
• The file explorer opens as a right-side panel that coexists with other panels (Git, Browser, etc.)

File Tree

The main area shows your project's directory structure:

• Folders — Click the chevron to expand/collapse
• Files — Click to open in the File Viewer panel
• Icons — Files show type-specific icons (code files, JSON, images, markdown, etc.)
• Selection — The currently selected file is highlighted

Starred Files

You can star frequently-used files for quick access:

1. Right-click a file and select "Add to Favorites"
2. Starred files appear in a dedicated section at the top of the file explorer, separated by a divider
3. Click the star icon on any starred file to remove it
4. Stars are saved per project and persist across sessions

Search

Click the search icon in the file explorer header (or it may auto-focus):

• Type to filter the file tree in real-time
• Matching files are highlighted and their parent folders auto-expand
• Clear the search to return to the full tree

Header Toolbar

The file explorer header has these buttons:

Context Menus

File Context Menu (right-click a file)

• Open — Open in the File Viewer
• Add to Chat — Add the file content to your current chat message
• Add to Favorites / Remove from Favorites — Toggle star
• Reveal in Finder — Open the containing folder in your system file manager
• Copy Path — Copy the file's absolute path
• Copy Name — Copy the filename

Folder Context Menu (right-click a folder)

• New File — Create a file in this folder
• New Folder — Create a subfolder
• Reveal in Finder — Open in system file manager
• Copy Path — Copy the folder's absolute path
• Expand All / Collapse All — Expand or collapse all children

File Viewer

When you open a file from the explorer (or click a file path in chat), it opens in the File Viewer panel:

• Tab bar — Each open file gets a tab. Click to switch, click X to close.
• Syntax highlighting — Code files are highlighted based on language
• Line numbers — Shown on the left side
• Scroll — Full vertical scrolling for large files

File Finder (Cmd+P)

For quick file access without browsing the tree, use the File Finder:

1. Press Cmd+P / Ctrl+P
2. A search modal appears — type part of a filename
3. Results update in real-time with fuzzy matching
4. Use arrow keys to navigate, Enter to open, Escape to close