Skip to content

Workspace Panel

Workspace Panel

The Workspace Panel is a file browser and editor for directories configured in the Spaces panel. Open it by clicking the Files button in the top bar.

  • Open: Click the Files button in the top bar.
  • Close: Click the Files button again, or the close (x) icon in the panel header.

Files and folders are displayed in an expandable tree:

  • Click a folder to expand or collapse it.
  • Directories show a chevron indicator.
  • Expanded/collapsed state is persisted in localStorage.

A breadcrumb trail at the top shows your current path. Click any breadcrumb to navigate to that directory.

If the workspace directory is a git repository, a status badge appears showing:

  • Branch name: The current git branch.
  • Dirty state: A dot indicates uncommitted changes.
  • Ahead/Behind: Numbers show commits ahead of or behind the remote.

Click a file to preview its contents. The preview mode depends on file type:

Displayed as raw text with syntax-appropriate formatting.

Rendered directly in the panel.

Rendered as HTML with full markdown formatting (headings, lists, code blocks, etc.).

When you open a skill from the Skills panel, its SKILL.md content is rendered here in markdown format.

  • Click the Edit button in the file preview header.
  • Or double-click a file to open it directly in edit mode.
  • The file content appears in an editable text area.
  • Make your changes directly in the text.
  • Press Ctrl+S (or Cmd+S on Mac) to save.
  • Or click the Save button in the header.
  • Press Escape to cancel edits and return to preview mode.
  • Or click the Cancel button.
  • New File: Click the New File button, enter a filename, and press Enter.
  • New Folder: Click the New Folder button, enter a folder name, and press Enter.

Double-click a file or folder name in the tree to rename it. Enter the new name and press Enter.

Click the delete (trash) icon next to a file or folder to remove it.

Click the download icon to save a file to your local machine. Both text and binary files are supported.

Drag the left edge of the Workspace Panel to resize it. The panel width is persisted in localStorage and restored on next open.