Docs › Workspaces
Files
A Sidetrack widget that shows the workspace's files beside your work, to read and to change a little.
Where Sidetrack › + › Files
Agents use it
1 min read
How it works
- Add Files to Sidetrack from its +. Press the well at its head to find a file by name, or the tile at its left for the Folder tree. With no file open, it lists your Recent files.
- Files open here from a loop's file badges, a Changes row, an artifact's menu, a path ⌘-clicked in a terminal, the command palette's Files, or an agent.
- Each open file is a tab under the head. ⌘W closes the one showing.
- Edit it and press ⌘S to save; nothing is saved otherwise. Right-click selected lines for Add to loop, which hands them to a loop with their line range.
- The button at the head's right opens the file in your editor, and its arrow, Open with, lists the other apps that can.
Good to know
- If the file changes on disk while you have unsaved edits, it says Changed on disk: Reload takes the new one, and Keep mine keeps yours for the next save to write over it.
- A file outside the workspace's folders is read-only until you press Allow editing. A binary or very large file is not shown, and offers Open in editor.
- Quitting, or removing the workspace, asks before unsaved edits are lost.
Related
- SidetrackA second sheet on the right that keeps a tab in view beside the one you work in.
- AttachmentsWhat you hand a loop beside your words, from artifacts and cards to files, tabs and pictures.
- ChangesThe git view's first page, where you read, stage and commit what has changed in a workspace's folder.