Files and previews
Browse the working directory, preview and edit files in place, download and upload.
The file panel is the "Files" tab of the right panel on a conversation page. It shows the working directory of the project the task belongs to. On a cloud host that is /home/user/ClawsGO/<project>; attachments you upload and files ClawsGO produces both land there.
Directory tree
- Click a file to preview it; click it again to close the preview.
- Click a folder to expand or collapse it. Subfolders load on demand, and each folder shows at most 500 entries.
- Four buttons at the top act on the root: New file, New folder, Upload files, Refresh.
- The letter beside a file name is its Git status (M modified, A added, D deleted, R renamed, U untracked).
- Figures produced by the task are listed separately in a "Figures" group above the tree.
Right-clicking a file, or its "More" button, opens the same menu:
| Item | What it does |
|---|---|
| View / Download | Open the preview, or download to your computer |
| Add to chat | Insert a reference in the composer, the same as typing @path |
| Copy path / Copy relative path | Absolute, or relative to the working directory |
| Cut / Copy / Paste | Move or copy between folders |
| Rename / Delete | Delete cannot be undone |
Folder menus add New file, New folder, Upload files and a zip download. On your own device there are also "Reveal in folder" and "Open in VS Code".
node_modules, .git, .venv, __pycache__ and similar folders are not shown.
Previews
| Type | What you can do |
|---|---|
| Code and text | Syntax highlighting, edit in place |
| Markdown | Switch between "Preview" and "Source". Source is editable and changes show in Preview immediately |
| Loads page by page, with paging, jump to page, zoom, fit to width and text selection | |
| Office | docx, xlsx and pptx open ready to edit; legacy doc, xls, ppt and ODF formats are read-only |
| Images | Shown centred |
| SVG | Opens the graphics workbench: select, rectangle, ellipse, line and text tools, fill and stroke. "Source" is editable |
| LaTeX | .tex opens the LaTeX workbench: source and PDF side by side, compiled on the cloud host |
| Audio and video | Play in the browser |
Other binary files show "Preview isn't available for this file" with a download button. Oversized text files show "File is too large to preview": code above 10 MB, Markdown above 1 MB and SVG above 4 MB do not open inline.
The preview card sits between the conversation and the right panel. You can open several files at once, each in its own tab.
Editing and saving
Code, text and Markdown source are editable in the preview. Changes save automatically 800 ms after you stop typing; ⌘S (Ctrl+S on Windows) saves at once. The status in the corner reads Unsaved / Saving / Saved / Save failed.
Office documents are edited in the built-in editor. ⌘S or the editor's own save button writes back to the host immediately; after you close the tab the editor saves once more within a few seconds. Watch the editor's own status bar for save state.
You and ClawsGO editing the same file
There is no locking; the last write wins. If ClawsGO is writing a file, wait until it finishes before you edit.
Automatic previews
When ClawsGO delivers a file of a previewable type, it opens automatically. When it writes a Markdown file with its tools, the preview grows along with the content. An automatic preview folds the right panel away to make room; closing the preview brings the panel back. Nothing opens automatically on phones.
Downloading
- One file: "Download" in the menu, or the download button in the preview header. Markdown files can be downloaded as Markdown, Word, PDF or plain text.
- A whole folder: "Download" in the folder menu produces a zip. Folders with more than 500 entries show "Folder is too large to download as a zip"; download subfolders instead.
- If the cloud host is asleep, the first download wakes it. The button may spin for tens of seconds.
- Download links are signed and valid for one hour.
Uploading
- "Upload files" in the panel uploads to the root; the folder menu's "Upload files" uploads into that folder. Files with the same name get a suffix rather than overwriting.
- Files dropped on or pasted into the composer become task attachments and upload to the root of the working directory. Up to 10 per message; the per-file limit depends on your plan, see Plans.
Host tab
The "Host" tab of the right panel is the machine running the task: terminal sessions, the desktop view entry on cloud hosts, CPU / memory / disk usage, and whether the SSH servers you have connected are reachable from this host. Kernel and architecture and the installed toolchain, Python packages and global npm packages are under Host Management → Environment.
When disk usage nears the limit, "Clean caches" under Host Management → Storage clears pip, npm and similar package caches without touching project files or installed software. Disk quotas per plan are in Plans.