Files
You want to check a file before you answer Claude, or find where something is used. Files shows the session’s project as a tree, with a viewer for any text file and a search in all of them, next to the conversation. Lines you select go straight into your message.
Files is for reading. To change a file, Open in editor is one click away.
Open it
Section titled “Open it”- Click Files on the session’s tool rail, or press Command, Option, EControl, Alt, E.
- Choose Toggle Files in the command palette.
- Click a file link in Claude’s reply: it opens in Files as a tab (see Preview files).
Files shares the right side with Changes, the terminal and the other tools. Close Files (the X) or Escape closes it.
The size switch in the header is the same as the browser’s:
- Side: beside the conversation, at the width you drag its left edge to.
- Half: half of the session, with the conversation in the other half.
- Full: the whole session. Hide the file tree gives the file all the room. Conversation or Escape goes back.
In a narrow panel, the tree and the file take turns: a file opens over the tree, and Files at the top of the file brings the tree back.
The tree
Section titled “The tree”The tree shows the files of the session’s folder, folders first. In a git repository it leaves out what your .gitignore leaves out.
- Click a folder to open or close it, and a file to open it.
- Type in Filter files to show only the files whose path matches. ReturnEnter opens the first one, Escape clears the filter.
- A dot after a file says Claude touched it in this session: the accent colour for a file it changed, grey for one it only read.
- With the tree focused, Up Arrow or Down Arrow move, Right Arrow or Left Arrow open and close a folder, and ReturnEnter opens a file.
Drag the line between the tree and the file to make the tree wider. The tree shows up to 50,000 files. In a larger project, use Quick open or Search for the rest.
The viewer
Section titled “The viewer”The file you open shows on the right, read-only, with line numbers and syntax colours. Each file you open gets a tab. Click a tab to bring it to the front, and its X to close it.
- The path at the top: click a folder in it to show that folder in the tree.
- Rendered and Source: a Markdown or HTML file opens rendered, the way Preview files shows it. Source shows its text. A Markdown file has an Outline of its headings beside it when there is room.
- Images: a PNG, JPEG, GIF or WebP file shows as the image.
- Find in file (Command, FControl, F) finds text in the file, with Previous match and Next match.
- Go to line (Command, Option, LControl, Alt, L) jumps to a line number.
- Wrap lines, Reload, Open in editor, Show in FinderFile Explorer and Copy path are in the toolbar too. Open in a dialog moves the file over the window.
The file is read again when Claude writes it, so you always see the current version.
What Claude changed
Section titled “What Claude changed”When the file is in Changes, a bar in the gutter marks each line Claude changed, and the top says how many, such as changed by Claude · 12 lines. Hover a marked line for the text it had before. Show diff opens the file’s diff in Changes.
Lines into your message
Section titled “Lines into your message”Select lines in the viewer and a small toolbar shows above them:
- Ask about the lines (such as Ask about lines 12–20) adds them to the message and puts the cursor in the message box, so you can type your question.
- Add to message (Command, Option, MControl, Alt, M) adds them and stays in Files.
- Copy copies the lines.
The lines go in the message box as a chip with the file, the line numbers and the code. With nothing selected, Command, Option, MControl, Alt, M or the speech bubble in the toolbar adds the whole file.
Right-click
Section titled “Right-click”Right-click (or press Shift, F10Shift, F10) for more:
- On a file in the tree or the search results: Add file to message, Open, Open full size, Open in editor, Show in FinderFile Explorer, Copy path and Copy relative path.
- On a folder: Add folder to message, Search in folder, Show in FinderFile Explorer and the two copies.
- In the open file: Add lines … to message and Ask about lines … for the lines you selected, Add file to message, Find in file, Go to line and the rest.
- On a tab: Add file to message, Add open files to message, Close, Close others and Close all.
The files go to this session’s message box, as the VS Code companion sends them from your editor. A toast says what was added.
Quick open
Section titled “Quick open”Press Command, Option, PControl, Alt, P (or Go to file… in the command palette) and type part of a file’s name. Before you type, the list shows the files Claude changed or read in this session, then the files you opened lately.
- ReturnEnter opens the file in Files.
- Command, ReturnControl, Enter opens it at Full size.
- Option, ReturnAlt, Enter adds it to the message instead.
- End with a line number, such as
app.ts:42, to open the file at that line.
Quick open works outside a session too: it looks in the project you selected, and the file opens in a dialog.
Search in files
Section titled “Search in files”Press Command, Option, FControl, Alt, F, choose Search in files in the command palette, or click Search at the top of Files. With text selected in the viewer, it searches for that.
- Type in Search. Match case (
Aa), Whole word (ab) and Regular expression (.*) are next to it. - Include and Leave out take globs separated by commas, such as
src/**, *.tsand*.snap. Search in folder on a folder fills in Include for you. - The results are grouped by file. Click a match, or use Up Arrow or Down Arrow and ReturnEnter, to see it in the file, with every match in that file marked.
- Ask Claude about these results adds the matches to the message and puts the cursor in the message box.
In a git repository the search follows your .gitignore. It shows the first 2,000 matches.
Related
Section titled “Related”- Preview filesNewRead a Markdown, HTML or code file Claude wrote without leaving Seshboard.
- ChangesThe Changes panel shows a session's git diff, and lets you stage, unstage and revert files.
- Working in a sessionChat with Claude, follow what it does, and go back in time when you need to.
- VS Code companionSend what you're looking at in VS Code to a Seshboard session, and answer its prompts from VS Code.