The Files page
The Files page lists a project's linked folder, shows what Haruno has read, edited or created, writes a short summary of the selected file, and offers the usual file actions. Opening a file is limited to plain documents.
- Mac appNot availableBuilt, but not shown. Projects replaced it in 1.3.61.
- Windows appAvailable
The Files page shows the files of a folder that a project uses, the way a file manager would. Its extra is the Haruno column, which shows what Haruno has done to each file.
Open it with Files in the navigation pane, or press Ctrl+2.
Which folder it shows
Files works on the linked folders of the project you are in, the one named in the menu bar. A linked folder is a folder you added to the project with Add source ▸ Choose folder. See Project sources.
At the top are the project's name, a Linked folder drop-down and a Refresh folders button. The drop-down lists each linked folder with its name and path. A folder that cannot be reached is greyed out. Pick one to see its files.
- With no linked folder the page says No available linked folders. Add one in Projects.
- With folders but none picked it says Choose an available linked folder to continue.
A folder linked with Read only access can be looked at but not changed. The page says This linked folder is read only. New File, New Folder, Rename, Duplicate and Delete are switched off. Add to chat, Show in File Explorer and Get Info still work. To change files here, add the folder again with Read and write.
The list
- Double-click a folder to open it. Use Up one level to go back, or select a folder in the path bar above the list.
- Select a column heading to sort by Name, Type, Size or Date modified. Select it again to reverse the order.
- Refresh reloads the list. It also refreshes by itself shortly after files change in the folder, and when Haruno creates a file.
- New File and New Folder at the top ask for a name.
Build output and dependency folders are not listed: node_modules, target, dist, bin, obj, .next, .nuxt, .venv and __pycache__. Files and folders whose names start with a dot are not listed either, except a few tool folders such as .github and .claude.
What Haruno changed
The Haruno column shows what Haruno is doing, and has done this session, to each item.
| The column says | Meaning |
|---|---|
| Reading…, Editing…, Creating… | Haruno is doing it to the file now. |
| Working… | Haruno is working inside a folder now. |
| Read, Edited, Created | What Haruno did earlier in this session. |
Hover for more. A file's tooltip says what happened and how many times. A folder's says how many files in it Haruno touched this session.
The summary
Select a file or a folder and a Summary panel opens at the bottom. Drag the bar above it to make it taller or shorter.
- For an image, the panel shows the picture.
- For another file, it shows its type, size and dates, and a short paragraph written by Haruno: what the file is for, what it contains, and any decisions, deadlines or risks it states. While Haruno writes it, the panel says Generating summary…. If it cannot, the panel says No summary available.
- For a folder, the summary is based on a listing of what it holds and a few of its key files.
The summary is written in the language of the app.
To write a summary, Haruno sends the start of the file's text to its service. Word, Excel, PowerPoint and PDF files are read in a protected way. If one cannot be read safely, Haruno does not read it another way and the summary is based on its name, type and size alone.
Haruno does not read a file whose name looks like it holds passwords or keys, such as .env, credentials, secrets, a key or certificate file (.pem, .key, .pfx), or an SSH key. It also leaves out text that contains a recognisable secret, such as a cloud key, a private key or a password setting. In those cases the summary is based on the file's type and size only.
File actions
Right-click a file, or press Shift+F10 or the Menu key, to open its actions.
| Action | What it does |
|---|---|
| Add to chat | Adds the file to your next message as a reference. Files only, not folders. |
| Open in preview | Shows the document in the chat's side panel. Offered only for documents the preview supports. |
| Rename | Changes the name. If the name is empty, has characters Windows does not allow, or is already used in that folder, Haruno says the item couldn't be renamed and asks you to check the name. |
| Duplicate | Makes a copy next to the original, named "name copy", then "name copy 2" and so on. |
| Delete | Asks "Delete 'the file's name'? This can't be undone." and then removes it for good. It does not go to the Recycle Bin. |
| Show in File Explorer | Opens Windows File Explorer with the item selected. |
| Get Info (Ctrl+I) | Shows Kind, Size, how many items a folder Contains, Where it is, and when it was Created and Modified. |
Opening a file
Double-click a file, or press Enter, and Haruno asks Open file? with the question: Open "the file's name" in the default application? Choose Open or Cancel.
Haruno hands a file to Windows only when it is a plain document, and only when its name and its contents agree. It does not open:
- programs and installers, scripts, and shortcuts;
- Office files that can carry macros, and PDFs with active content;
- disk images;
- files whose name says one thing and whose contents are another;
- file types it does not know to be plain documents.
For these the file simply does not open. To reach one anyway, use Show in File Explorer.
For a web page (.html), a Word, a PDF or an Excel file, a second question follows once you choose Open: Open this file? It warns that the program that opens the file can follow links and load things from the internet by itself. Choose Open file or Cancel. Enter chooses Cancel.
What to tell a customer
- Files shows what a project's folder holds and what Haruno has done in it. It is not a separate place to keep files.
- Delete cannot be undone. A folder is deleted with everything inside it.
- Haruno writes a summary only for the file or folder that is selected. Files in a folder that is not linked to a project are never shown here.