> For the complete documentation index, see [llms.txt](https://docs.nimbalyst.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nimbalyst.com/session-management/view-files-in-agent-mode.md).

# View Files in Agent Mode

View and edit the files an AI session touches directly inside Agent mode, without switching to Files mode to check what the agent did.

When an agent edits or reads files during a session, those files appear in a panel on the right side of the Agent window. You can open, review, and edit them there, next to the conversation, instead of switching to Files mode to check what the agent did.

<figure><img src="https://562749618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVUeHZHlFlZrZt02syRC%2Fuploads%2FH6FXj4W3TzqUfvw0sVLx%2Fimage.png?alt=media&amp;token=85de293b-24c9-4563-9fd9-c60d8ef3ab31" alt="The Agent window with a session transcript in the center and the Files Edited panel on the right, showing an edited file with Keep and Revert controls"><figcaption><p>The Files Edited panel on the right lists what the session changed, with per-file review controls and a commit area below.</p></figcaption></figure>

### How to use

* When a session, workstream, or worktree touches a file, it appears in the right panel.
* Click a file to open it. You can open multiple files in tabs, and resize or hide the panel as needed.
* Edit files directly while collaborating with your agent.
* Right-click any file to open it in Files mode if you prefer the full editor experience.

Seeing agent output as rendered files rather than terminal text is the core idea behind the [visual editor for Claude Code](https://nimbalyst.com/visual-editor-for-claude-code/). In a workstream, the same panel combines files from every session; see [Workstreams](/session-management/workstreams.md).

### Collapsing sections

The panel groups files under section headers (Edited, Referenced, Read). Click a header to collapse or expand that group, which helps when a long session has touched many files.

### Tips

* **Long filenames** are truncated. Hover to see the full relative path from your workspace.
* **Multiple edits** to the same file are aggregated, so you see the total lines added and removed across all changes.
* **Git status updates** automatically when you switch back to Nimbalyst from another app.
* **Empty state**: if no files have been touched yet, the panel shows "No file interactions yet."


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.nimbalyst.com/session-management/view-files-in-agent-mode.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.