Files panel
The Files panel in chat lists every Library file the running agent can see, shows a live diff for anything it changed, and falls back to the last staged state when the sandbox is paused.
While an agent works in chat, the Files button in the top bar opens a panel with the files that session can reach. The button shows a count of files with pending changes.
What the panel shows
The panel lists the Library folders mounted in the agent's sandbox, in the same layout the agent
sees under ~/context. Paths with a pending change are coloured in the tree.
Click a file to see it.
- An unchanged file shows its content.
- A changed file shows a diff between the staged version and the version the agent started from. A Changes toggle switches between the diff and the content.
- A file the agent cannot write carries a Read-only badge.
Live while the sandbox runs
While the sandbox is running, the panel reads from the sandbox itself. You see the file as it is on the agent's disk right now, including edits that have not been staged yet.
Staged fallback when the sandbox is paused
A sandbox stops after a period of inactivity. The panel then shows a notice that the sandbox is paused and switches to the last staged state. That is the set of files Helios captured before the sandbox stopped. Send the agent another message to resume the sandbox and the panel goes live again.
Approving from a chat
The panel is for looking. Approvals happen in the Changes inbox. Open Library, then Changes, and pick the session. See reviewing changes.
Related
- Library overview - scopes and mount paths.
- Proposing changes - when edits are staged.
Last updated on
Library permissions
Library access starts from your organization and project roles. Library path grants add viewer or editor access on any folder, for a person, a group, a service account, or the whole organization.
Library limits
What the Library does not do today, the size limits on previews and writes, and what happens to staged files after a review.