File Tree

The File Tree panel lets you browse a workspace folder. Use it to inspect files, open files in an external editor, or copy file paths. It is read-only: you can’t create, rename, move, or delete files from the tree. File Tree starts hidden. To show it, right-click the sidebar rail and check File Tree. Then open it from its icon in the rail. Click a folder to expand it. Click a file to open it in a preview tab; double-click to keep the tab open. Drag a file or folder into the agent composer to insert an inline mention. This works when the file is on the same host as the composer. See the file context demo. You can also drag a file onto the canvas to open it there.

​

Task Artifacts Are Separate

File Tree browses files on a particular host. It does not turn repository files into shared Task deliverables. Use Artifacts for documents, HTML pages, canvases, and file artifacts saved with the Task. Collaborators can access those published artifacts without access to browse your workspace. To give an agent context from a shared deliverable, type @ and select it under Artifacts instead of using a workspace file path.

​

Workspace Picker

The picker at the top of the panel chooses which folder the tree shows. It lists hosts and their workspace folders, with “Search repo, branch, or path…” to find one.

​

Filter Files

Type in “Filter files by name…” to narrow the tree. If nothing matches, the panel says “No files match the filter.” Very large result sets show only the first matches; narrow the filter to see more. In very large workspaces, some folders hold more files than the tree can show. The panel says so rather than listing them all.

​

Right-Click Menu

Right-click a file or folder for: Editors and Finder appear only when the tree shows a folder on this computer. On a remote host, the menu offers only the copy actions.

​

When The Tree Can’t Load