File Preview
- Desktop, mobile and web
- All plans
What it does
One preview window for every file the app shows you: a file in the Files tab, a changed file in the Changes tab, an attachment in the composer, a result of the command palette, a path clicked in a terminal. Deliverables open rendered rather than as source: Markdown as a document (```mermaid blocks are drawn as diagrams), an HTML report in a sandboxed frame, a CSV or TSV as a table, a PDF in the built-in viewer, a Word file (.docx) as pages, an Excel workbook (.xlsx) as tables with one tab per sheet, images, video, audio, fonts and SVG as media. Code opens in an editor you can save from. Arrow keys move to the previous or next file of the list you came from without closing the preview. The same window also opens any file of the disk, even one outside the project (a log, a dotfile, a snippet in another folder), through File > Open File… or Cmd O / Ctrl O.
Where to find it
- Right panel > Files: click a file. To keep it open as a tab of the bottom bar instead (next to the terminals), hover the file and click Open in a tab, or click Open in a tab in the header of the preview. Right panel > Changes: click a changed file (diff or raw, as filtered).
- Composer attachments tray: click an attached file.
- Command palette (Cmd K / Ctrl K): a file (
/) or commit (:) result opens as a peek above the palette. - A file path in a terminal, a link to a local file in the conversation view, and the session information panel. A long path that the agent's CLI broke over several lines is opened whole, whichever line you click. Since 2026-10-28 a name that contains spaces is linked too, once the project confirms the file exists, and documents and images an agent names (
.pdf,.doc,.docx,.xls,.xlsx,.ppt,.pptx,.odt,.ods,.odp,.csv,.tsv,.png,.jpg,.jpeg,.gif,.webp) are clickable like code files. Since 2026-11-03 a path holding Chinese, Japanese, Korean, Cyrillic, Arabic or accented letters (docs/方案/规格.md,été/résumé.md) is linked whole, on the computer and on the phone. In a sentence written without spaces, a name with no folder only counts on its own or between backticks. - Menu bar > File > Open File… (Cmd O on macOS, Ctrl O on Windows and Linux): the system file picker, over the whole disk, hidden files shown. Works from anywhere in the app, including the projects home, the settings and the Open space.
How to use it
-
Open a file. Rendered formats show a Preview / Source toggle in the header ("Show raw source" / "Show rendered preview"). Binary files show "Binary file: this file cannot be displayed as text"; this includes PowerPoint and the Office formats from before 2007 (
.ppt,.doc,.xls) and OpenDocument files, which keep Open with default app. -
Navigate: Previous file (←) and Next file (→), with a
3/7counter; the list wraps at both ends. The list is the one you came from: the tray's attachments, the Changes list as filtered, the search results or the current folder of the file browser. An isolated preview (palette, terminal link) shows no arrows. -
Edit: click Edit in the header (outlined, next to the search magnifier), or simply start typing in the source view: the first key switches the file to edit mode and is kept at the cursor. Then Save (⌘S); closing with unsaved changes asks "Discard unsaved changes?". What you type is kept on this computer as you go: after a restart, a crash or a quit, a card at launch lists the files with unsaved edits, Open shows the edits back in the editor, and you Save or Cancel them. If the file changed in the meantime, a bar above the file asks first: Restore my edits (they replace the current content when you save) or Discard. While the cursor is in an editor, the arrows move the cursor, not the file.
-
Header actions: Copy content, Copy path, Show in folder, Open with default app, Download, Download as PDF, Expand to full window / Restore default size, Read this document aloud, and for images Annotate ("Annotate this image in the sketch canvas").
-
CSV: the separator (comma, semicolon, tab, pipe) is detected on the first line; a summary shows rows × columns.
-
Expand: Expand to full window lifts the reading column of a Markdown file so wide code blocks and tables use the whole window; Restore default size brings the column back. The choice is remembered on this machine from one opening to the next.
-
Search inside the file: press Cmd F (macOS) or Ctrl F (Windows, Linux), or click the magnifier in the header (Find in file). The search panel opens on the source with Find, next / previous / all, match case, regexp, whole word, and a live counter such as 3 of 12 (No results when nothing matches). Enter and Shift+Enter walk the matches, Escape closes the panel before the window. A rendered Markdown, HTML or CSV view switches to Source first. To replace, press Ctrl H (Windows, Linux) or Cmd Alt F (macOS): the file enters edit mode and the panel gains Replace, replace and replace all; save afterwards as usual.
-
Open any file: File > Open File… (or Cmd O / Ctrl O), pick a file in the system picker. To type a path instead of browsing, use the picker's own shortcut (Cmd Shift G on macOS,
/or~in the GTK picker on Linux). The file opens in the same preview, with rendering, source, editing and saving. When it sits outside the open project, the header shows an Outside the project badge with its full path ("This file is not part of the open project. Its full path is shown, and saving writes to that file on disk."). The same badge appears on any external file the preview shows, such as a screenshot dropped from Downloads or a CLI transcript. -
Open in a tab: in the Files tab, hover a file and click Open in a tab, or click Open in a tab in the preview header. The file becomes a tab of the bottom bar, next to your terminals, and shows in the centre pane with the same preview, source, editing, saving and search. It stays open while you go back to an agent; an edit you have not saved yet is kept when you switch to another tab. Opening the same file again brings its tab back rather than adding a second one. The tab can be split, moved and detached like a terminal. Close it with its ✕.
Download as PDF (since 2026-11-04, in the preview window and in file tabs) saves what is on screen, in the place you choose: code, text or a diff with colours and line numbers, a rendered Markdown document with its images, tables, formulas and Mermaid diagrams, a CSV or TSV as a landscape table, an HTML page with its scripts and charts, or an image. The page is Letter in the United States, Canada and Mexico, A4 elsewhere, and an HTML page can set its own size.
Links between Markdown files (since 2026-11-08): in a rendered Markdown file, a link to another file of the project ([setup](./setup.md), [api](/docs/api.md#L12)) opens that file in a preview laid over the document; close it (Esc or the cross) to come back to the document. A relative link starts from the folder of the open file, a link that starts with / from the root of the project, as on GitHub. Only real links are clickable, not a path written in the text or in inline code. A link that leaves the project is not opened and a line at the top of the document says "This link leads outside the project, so it was not opened."; a missing file says "The linked file does not exist in the project." Web links still open in your browser.
Word and Excel (since 2026-11-06, reported by Volkan): a .docx opens as pages, scaled down when the window is narrower than a page, with its images, tables, headers and footers; a link of the document opens in your browser. A .xlsx opens as tables: one tab per visible sheet, a summary of rows and columns, and the values as Excel shows them (dates, percentages, TRUE / FALSE); a formula shows the result Excel saved. Download in the header saves a copy of any PDF or Office document. A file the preview cannot draw shows "This document could not be shown here." (or "This document is too large to be shown here.") with Open with default app.
Open with default app opens the file in the application your computer associates with it (a .pptx in PowerPoint or Keynote, a .docx in Word). A file the preview cannot show (binary) offers the same button in its body. Programs and scripts are never launched from here ("Programs and scripts are not launched from here: use Show in folder."); with no application for that type the button says "No application on this computer can open this file."
Settings
fileTreeOpensInTab(global, Settings > View > Open files from the file tree in a tab): a click on a file of the Files tab opens it as a tab of the bottom bar instead of the preview window. Default off. Synced with your account. A content search result still opens in the preview window, which jumps to the matched line.settings_get/settings_setread or change it.
Agent tools (MCP)
None. Agents read files with their own tools; the preview is a surface for the user.
Providers
All providers, no difference.
Mobile
Partly. The phone has a code viewer in the file explorer, a diff viewer in the Changes screen, and a shared image viewer for ticket attachments, chat images and generated media. Previous / next navigation exists there too, with the same chevrons and counter, plus a horizontal swipe on images and media (not on code, where the gesture would fight text selection). Long lines wrap in the code viewer, as on the desktop; a file opened from the conversation no longer shows a blank page. Since 2026-10-31 the phone colours code with the same languages and colours as the desktop (JavaScript, TypeScript, JSON, Python, Shell, YAML, SQL, Markdown, HTML, CSS, Go, Rust, Swift, Kotlin and the other desktop languages), and a wrapped line continues under its own indentation instead of at the left edge. A file of another language, or over about 100 KB, shows uncoloured. Tapping a file path in an agent's console (a long path cut over several lines included) looks in that agent's worktree first, so the file the agent just wrote opens rather than the stale copy in the main checkout. Since 2026-10-18 an HTML file opens rendered on the phone too, with the same Preview / Source switch at the top; a link tapped inside the page opens in the phone's browser, and only styles and images written inside the file show (relative ones such as ./style.css do not load there). Since 2026-10-29 a file an agent names in the conversation opens with one tap on the phone too, documents included: tap the link, the computer finds the file (in that agent's worktree first) and the viewer opens. A PDF or an Office document (.pdf, .doc, .docx, .xls, .xlsx, .ppt, .pptx, .odt, .ods, .odp, .rtf, up to 50 MB) is read in the viewer on an iPhone. On Android, since 2026-11-06 (reported by Volkan), a PDF and a Word file are drawn in the viewer too (pinch to zoom) and an Excel workbook opens as tables with one tab per sheet; any other format, or a file the viewer cannot draw, shows a card with the file name and its size and an Open in another app button that hands it to a document app ("No app on this phone can open this file." when there is none); the same Open in another app button sits in the viewer header on both systems. The file is copied to the phone only while you read it. Since 2026-11-03 a file an agent names outside the project (a neighbouring repository, a scratchpad, the agent CLI's own folder) opens on the phone too, read-only, with the same Outside the project badge next to its full path. A file that may hold secrets (.ssh, .aws, private keys, .env, the credentials of an agent CLI, the app's own ~/.agentsroom folder) answers "Protected file" and only opens on the computer. Since 2026-11-08 a Markdown file opens rendered on the phone too (titles, lists, tables, code blocks with copy, Mermaid diagrams), with the same Preview / Source switch at the top; a large file stays smooth. In the rendered view, a link to another file of the project opens it with one tap in a viewer laid over the document (close it to come back), with the same rule as the computer: relative to the file's folder, or to the project root when it starts with /; a file outside the project or missing shows "Could not read this file". An image of the project () is drawn when it stands alone on its line; an image inside a sentence, a web image, an SVG or an image over 2 MB shows its alternative text instead. The file explorer stays inside the project, and so does a project opened on a server over SSH, whose paths belong to the server's disk. Since 2026-11-04 the header of the viewer has Download as PDF too: your computer builds the PDF and sends it to the phone, which opens the share sheet on an iPhone and the PDF viewer on Android. The phone always gets the rendered page, even from the Source view of an HTML file. The CSV table, Open File…, the in-file find and replace, Open with default app and files opened as tabs are not on the phone (a phone shows one screen at a time, so a preview there is already full screen): the companion reads files through the desktop and never edits them.
Limits
- Video and audio play in the built-in player. A format it does not support (ProRes, for example) or a file that is corrupt or incomplete shows "This video can't be played here" with Open with default app. Which formats play depends on the computer, HEVC most of all.
- In the Changes tab and the review, the before / after comparison of a media file needs its previous version from git: above 50 MB only the current version is shown.
- The CSV table shows the first 2000 rows; beyond that a banner sends you to the Source view, which handles large files.
- The HTML frame runs the document's own scripts (reports need them for their charts) but in an opaque origin: no access to the app, its storage or other local files;
alert()dialogs are blocked so a page cannot freeze the window. - Relative resources of an HTML file (
./chart.png,./style.css) resolve against the file's folder. - A held arrow key moves one file per press: each step reads a file or runs a diff.
- Windows and POSIX paths are both handled.
- A file opened with Open File… stays outside the project: it is not indexed, not watched, not added to the Files tab or the search, and the agents do not see it. Saving writes to that file on disk. One such file at a time.
- There is no list of recently opened external files.
- File tabs are not restored after quitting the app, but their unsaved edits are: see below. Unsaved edits stay on this computer (never sent to the account or to another device), for 30 days and up to 50 files; a file over 5 million characters has no copy kept, only the prompts and the wait before a restart. A sketch or a form in progress is not kept.
- A file opened with Open File… or from the Changes tab opens in the preview window only.
- Download as PDF is not offered for a PDF (use Download), Word, Excel and PowerPoint files, video, audio, fonts or binary files. A CSV stops at the 2000 rows of the preview, with a line in the PDF saying so. An HTML view with live data prints without its data, and an HTML page loses any resource from outside its own folder.
- On the phone, Download as PDF needs the main window of AgentsRoom open on the computer, stops at 50 MB and is not offered for a project of another computer of your account. An older desktop version answers "Update AgentsRoom on your computer to download this file as a PDF."
- Word and Excel are drawn up to 30 MB on the computer. Excel shows values, not formatting (colours, fonts, merged cells, charts), and at most 2000 rows and 200 columns per sheet, with a line saying so; the phone shows fewer rows on a very wide sheet. Hidden sheets are left out. A password-protected or damaged file falls back to Open with default app (computer) or Open in another app (phone).
- On Android, a PDF has no text selection and no clickable links, and a Word link does not open: use Open in another app for that. A PDF whose fonts are not embedded may show a substitute font.
- Find and replace work on the text of a file (source or editor), not on a diff of the Changes tab, and not on a PDF, an image or media. The counter stops at 10000 matches and shows 10000+.
Common questions
Can an HTML report show live data? Yes, in a project where you turned on Live data for HTML views: see that fiche. The page then has no direct network and no links, and a line above it says what it reads.
-
A video stayed grey at 0:00 when I opened it again, or a click on its timeline sent it back to the start. Fixed on 2026-11-03, audio files too: a video can be reopened as often as you like and you can move anywhere in it. MP4 files that used to never open (index at the end of the file, the default of many export tools) open too.
-
Opening a large video from the Changes tab froze the app for a few seconds. Fixed on 2026-11-03: the app no longer reads a binary file as text to build a diff, on the computer or for the phone.
-
What does "This video can't be played here" mean? The built-in player does not support the format, or the file is corrupt or still being written. Click Open with default app to open it in your usual player. If an agent is still generating the file, reopen it once it is finished.
-
A link to a report in the assistant opened my file manager instead of the report. Fixed on 2026-11-01: a Markdown, HTML or CSV file now opens in the app's preview, with Show in folder in its header. Other files (attachment, PDF, office document, folder) still open in the file manager.
-
Can I copy a code block from a Markdown file in one click? Yes, since 2026-11-02: hover the block and click the copy button in its top right corner (on the phone, tap the button always shown in the corner). A Mermaid diagram keeps its Show code button there instead.
-
A link from my README to another Markdown file did not open in the app. Since 2026-11-08 it does, on the computer and on the phone: click (or tap) the link in the rendered view and the linked file opens over the document. Close it to come back.
-
Does the Markdown preview render Mermaid diagrams? Yes, on the desktop. A fenced
```mermaidblock is drawn as a diagram in the file preview, in file tabs, in the Conversation view and in backlog tickets and comments. Hover the diagram and click Show code to read its source, Show diagram to come back. A diagram with a syntax error stays as code, with the line "This diagram could not be drawn: its code is shown instead." On the phone, diagrams are drawn in the Conversation view, in side questions and in tickets: Show code sits under the diagram, and a tap opens it full screen with pinch to zoom. A.mdfile opened in the phone's file viewer still shows as text. -
How do I save a Markdown, code or CSV file as a PDF? Open it in the preview and click Download as PDF in the header, on the computer or on the phone. The computer saves what is on screen and shows "PDF saved"; if it fails, the message is "The PDF could not be created."
-
Can I read a Word or Excel file without downloading it? Yes, since 2026-11-06 (reported by Volkan): click it in the Files tab, a terminal link or the conversation, and it opens in the preview, on the computer and on the phone (iPhone and Android). Download in the header still saves a copy.
-
How do I open a PowerPoint or Word file from the preview? Click Open with default app in the preview header: the file opens in the application your computer uses for that type. Desktop only.
-
Why does my
.htmlreport open rendered instead of as code? A deliverable is not code. Use Source to see the markup. -
Can I see an HTML report rendered on my phone? Yes, since 2026-10-18: open it from the file explorer and it shows as a page, with Preview / Source at the top. Before, the phone only showed the markup.
-
Can I search inside the file? Yes: Cmd F / Ctrl F or the magnifier in the header opens Find in file with a 3 of 12 counter; Ctrl H (Cmd Alt F on macOS) opens the same panel with the Replace field, in edit mode. The palette itself only matches paths; use the Files tab's content search (⌘⇧F) to search across files.
-
Cmd F / Ctrl F jumped to the app's search bar instead of searching the file. Fixed on 2026-09-23: while the preview has the keyboard, the shortcut stays with Find in file. If it still reaches the app search, click once inside the preview first.
-
Ctrl F in the preview used to open the sidebar search instead. Fixed on 2026-09-18: the shortcut now stays in the open file as long as the preview is up.
-
Why no arrows on this preview? It was opened alone (palette, terminal link, session info); arrows only follow a list.
-
The table says "Only the first 2000 rows are shown". Switch to Source for the whole file.
-
AgentsRoom closed or restarted while I was editing a file. Are my changes lost? No, since 2026-11-04: they are kept as you type. The next launch shows a card Unsaved edits kept; click Open and they are back in the editor, or simply reopen the file. Closing the card loses nothing, it comes back at the next launch. Discarded on purpose ("Discard unsaved changes?") means gone.
-
I type in the file preview and nothing happens. How do I edit? Since 2026-11-16, typing in the source view switches to edit mode on the first key, which is kept. You can also click Edit in the header. A rendered view (Markdown, HTML, CSV) has no cursor: click Source or Edit first. A past version of a file or a file whose kept draft conflicts stays read-only.
-
How do I open a file that is not in my project, like
~/.zshrcor a log? File > Open File… or Cmd O / Ctrl O, then pick it. It opens with the Outside the project badge; you can edit and save it without adding its folder as a project. -
Can the agent read the file I opened this way? No. Only the preview shows it; the project remains its folder. Give the agent the path or attach the file to a message if it needs it.
-
The agent named a file with spaces in its name and it was not clickable. Fixed on 2026-10-28: the name is linked as soon as the project confirms a file of that name exists, so
My report final.pdfopens like any other path. Until that check answers, the text stays plain rather than guessing where the name ends. -
A link with a line number (
src/app.ts#L42) said "file not found" in the conversation view. Fixed on 2026-10-28. -
I clicked a long path the agent printed and got "not found", but the file exists. Fixed on 2026-10-08: some CLIs (Claude Code among them) cut a long line themselves, so only the clicked piece of the path was looked up. The pieces are now joined back before opening, in the terminal on desktop and phone. A Markdown link to a local file in the conversation view (
[values.txt](/path/to/values.txt),file://…,path#L12) now opens in the preview too instead of a browser. Windows paths written with backslashes are not joined across lines. -
The phone says "File not found" for a file the computer opens. Fixed on 2026-11-03 (reported by Zbd20): the phone refused any file outside the project folder, a document of a neighbouring repository for example. It now opens read-only with the Outside the project badge. It takes the latest version of the phone app and of the desktop app.
-
Why does the phone say "Protected file"? The file may hold secrets (see Mobile above), so it only opens on the computer. Code and documents named after a secret, such as
token.goorsecret-rotation.md, are not concerned. -
The phone says "Computer unreachable" when I tap a file. The computer could not be asked: the connection dropped or the app is closed on it. Nothing is wrong with the file, try again once connected. Before 2026-11-03 this showed as "File not found".
-
A path with Chinese characters or accents was cut, or underlined in the wrong place in the terminal. Fixed on 2026-11-03: the whole path is linked, and the underline sits on it even after double-width characters.
-
A linked folder (symbolic link, Windows junction) showed as a file I could not open. Fixed on 2026-10-13: in the Files tab, on the computer and on the phone, a link that points to a folder is listed and opened as a folder. A broken link still shows as a file.
-
Can I open files in tabs instead of a popup? Yes (asked by Tammix): hover a file in the Files tab and click Open in a tab, or use Open in a tab in the preview header. To make every click do it, turn on Settings > View > Open files from the file tree in a tab.
-
Where do file tabs appear? In the bottom bar, with the terminal tabs, above the New terminal and Commands buttons. The file shows in the centre pane while its tab is selected.
-
Why does the preview open expanded every time? The Expand to full window choice is remembered on this machine. Click Restore default size and it stays restored.
Related
- Mermaid Diagrams: where else the app draws Mermaid blocks, and what the drawing cannot do.
- Command Palette: file and commit results open as a peek.
- Sketch: where Annotate sends an image.
- Read Aloud: the "Read this document aloud" button.
- Per-Agent Review: the Changes tab the preview opens from.