Projects and files

Projects and workspaces

buster7 handles the place you work in two levels.

For a Git project, a workspace can be created as a worktree. For other projects, adding a workspace creates a dedicated directory. Workspace lists and session creation menus include the project root, Git worktrees, and added workspaces. Ordinary directories such as src and docs are excluded. Git worktrees outside the project directory are also available.

From the list on the left you can:

• Add a project (the + button; b7 dirs can suggest candidates)
• Pin a project to hold it at the top
• Add a workspace to a project
• Filter the list by search

Looking at files

Images can be zoomed and panned. Markdown opens as a rendered preview; use the code button above it to switch to source. PNG, JPEG, GIF, WebP and BMP images up to 8 MiB are supported. Images without an extension or saved as .bin also open as images in a tab.

The right column is the file list of the workspace you have open. Walk into folders and press a file to open it. Source code can be read right there.

You can also open a file by clicking a path printed in the terminal (Terminal). Use that when you want to check a file the agent edited without waiting to be told.

Find and open

Use the search button in the file list or Cmd+P (Ctrl+P on Windows / Linux) to search filenames and paths in the current workspace, including unopened folders. Select a result with the arrow keys and press Enter. An already open file reuses its tab.

Use Search in folder, or Cmd+Shift+F / Ctrl+Shift+F, to search file contents. Right-click a folder, or long-press it on mobile, to search within that folder. Results include line numbers and open at the matching line. Enable Include ignored files when needed. A notice appears when limits or unreadable files cause results to be omitted.

Use the search button in an open file, or Cmd+F / Ctrl+F, to find text within it. Markdown searches use the source text.

Navigate the tree

Opening a file reveals and selects it in the tree. Use Up / Down to select, Left / Right to open or close folders, and Enter to open a file. The collapse-all button closes the expanded folders. Expansion state is saved per workspace.

The menu offers separate actions to copy relative and absolute paths. When the server runs on the same machine, Reveal in Finder (Reveal in File Explorer on Windows, Open Containing Folder on Linux) shows the item in your file manager. Changes made by an agent or another app automatically update the tree and open file contents. Reconnecting also refreshes the current state.

On mobile, open Files in the left drawer to access these tools.

Resume a past conversation

The Conversations tab in the right column lists the agent conversations of this project, newest first. Conversations from every worktree and every account appear in the same list (claude and codex). Under each one you see the agent, the account, where it started, and when it was last used. Conversations started in the selected workspace are highlighted.

Tap a conversation to open a new tab that continues it in the selected workspace. The account is chosen the same way as for a new session: the project's account, or you pick one. You can also continue a conversation from another account. Its record is copied to the account you use now before it opens; the original account keeps its copy.

On mobile, open Files in the left drawer and switch to Conversations at the top.

Review Git changes

Filename colors and badges show the Git status: M (modified, yellow), A (added and staged, green), U (untracked, green), R (renamed, green), D (deleted in the changes list, red), and ! (conflict, red). Folders containing changes show a colored dot even when collapsed. Ignored files are dimmed. Hover over a filename for a description. Decorations refresh after files are saved or staged.

Git status appears beside filenames. Use Toggle files and changes to list only changed files, then select a file to open its diff.

• Staged compares the last commit with the content selected for the next commit.
• Unstaged compares the staged content with the working file.

Untracked files appear as new content. Deleted and renamed files also appear in the list. This view is read only; it does not edit, stage, or discard changes.

Send line notes on the diff to an agent

Click a line number on the left of the diff to add a note to that line. Notes are kept per workspace, so you can go through several files and send them together. Send to agent opens the terminal of the agent running in that workspace and pastes a message listing each file and line, the line's content, and your note into its input. It is not sent automatically; review it and press Enter. If several agents are running, choose one. If none is running, use Copy instead.