Files & history

File browser

The Files tab shows the active project folder as a tree. Folder expansion is remembered per project, and switching projects closes open file tabs so a file from one project does not stay mixed into another project.

Git status decorations flow into the tree for files and parent folders. When the active session is running in a dispatched worktree, the tree reads from that session workspace instead of the base project folder.

Additional folders

Use Add Folder to attach extra directories to a project. Attached directories appear below the main tree and can be removed later. They are useful for nearby docs, generated examples, or sibling packages that the agent should inspect without changing the project root.

File tabs

Opening a file creates a tab next to Threads. The thread tab stays mounted while you inspect files, so streaming state, queued messages, approvals, and the editor stay intact when you switch back.

Viewers

AgentsOS chooses a viewer from the file type:

• Code files use a virtualized code viewer with line numbers and syntax highlighting for files small enough to highlight.
• Markdown files render as formatted Markdown with GitHub-flavored syntax.
• Images render through the native file URL bridge and stay inside a scrollable preview.

Mentioning files and lines

Every file viewer has a floating action bar. Mention in chat inserts the file into the chat editor. In code files, select one or more lines and use Mention line or Mention lines to send a precise line reference.

Diff mode

For changed git-tracked text files, View Diff switches the file tab from the current file to its git diff. Images and deleted files do not expose diff mode.

File Changes

The History tab shows the current session's file changes. Each entry includes path, relative time, additions, deletions, and an inline patch view. New agent diffs move to the top as they stream in, and reverted files disappear from the list.