File Browser
The file browser provides read and write access to project workspace files from the Command Center.
Browsing Files#
The Files tab in the left sidebar shows a tree view of the project workspace. Navigate directories and click files to view their contents in the right panel with syntax highlighting.
File Operations#
| Operation | Description |
|---|---|
| Browse | Navigate the directory tree |
| View | Open a file with syntax highlighting |
| Create | Create new files or directories |
| Upload | Upload files via drag-and-drop or file picker |
| Rename | Rename a file or directory |
| Move | Move a file to a different directory |
| Delete | Remove a file or directory |
| Edit | Modify file content directly in the editor |
| Download | Download a file to your local machine |
Filtering and Searching Files#
Filter by filename#
The file tree toolbar includes a Filter files… input. As you type, the tree hides entries whose name does not contain the filter string (case-insensitive). This is a local, client-side filter — it does not search file content.
Search by content#
Press Ctrl+Shift+F (or use the command palette) to open the content-search panel. Enter a search term and press Enter (or click the search button) to find all lines across workspace files that contain the query string. Results show the file path, matching line number, and a preview of the matched line. Click any result to open the file at that line in the editor. The search is case-sensitive and scans text files only; binary files, files larger than 1 MB, and directories such as .git, node_modules, __pycache__, .venv, dist, and build are excluded.
Editor Toolbar#
When a file is open and editable, a toolbar appears above the editor with the following controls:
| Control | Default | Description |
|---|---|---|
| Undo / Redo | — | Step through edit history (Ctrl+Z / Ctrl+Shift+Z) |
| Auto-save (timer icon) | Off | When enabled, saves changes automatically after a short pause; click to toggle |
| Markdown preview (eye icon) | Off | Visible only for .md files; renders the file side-by-side with the source |
| Word wrap | Off | Toggles soft line wrapping in the editor |
| Font size (− / +) | 14 px | Adjusts the editor font size (10–24 px) |
Editor settings (auto-save, word wrap, font size, markdown preview) persist across sessions via local storage.
Real-Time Updates#
File operations performed from this browser window (create, rename, delete, move, upload) update the tree immediately. Changes made by agent tasks or terminal commands are not automatically reflected — click the Refresh button (↻) in the file tree toolbar to reload the directory listing from the server.
Troubleshooting#
| Symptom | Likely cause | Resolution |
|---|---|---|
| File tree does not show files created by an agent task | Tree cache is stale | Click the ↻ Refresh button in the tree toolbar |
| Upload rejected with an error | File exceeds 10 MB or has a blocked extension (.exe, .dll, .ps1, etc.) | Reduce file size or rename to an allowed extension |
| File content is read-only | Your role has EXECUTION_VIEW permission but not PROJECT_SETTINGS | Contact your workspace administrator to adjust your permissions |
| Search returns no results | Query is case-sensitive; binary or large files are skipped | Try a different case or use the tree filter to locate the file by name |
| Edit save fails with "Content too large" | File exceeds the 1 MB inline-editor limit | Use the terminal to edit large files directly |