# Agent Workspace

The Agent Workspace shows the files [Bkper Agent](https://bkper.com/docs/ai/bkper-agent.md) works with: your [agent context](https://bkper.com/docs/ai/agent-context.md) and the code of the Apps you develop. You and the agent change the same files, and nothing reaches anyone else until you save.

![Agent Workspace panel with a file tree: domain, marked Company and Empty; user, marked You, holding .agents, .gitignore, and AGENTS.md; and apps, holding My App with its client, scripts, server, and test folders and its files.](https://bkper.com/docs/_astro/agent-workspace.BTje03zl.png)

## Open it

1. **Click Agent Workspace** at the bottom of the session list, above Connected services.

2. **Open a folder** and click a file to open it beside the conversation.

## What's in it

| Folder              | Holds                                                                                          |
| ------------------- | ---------------------------------------------------------------------------------------------- |
| `domain`            | Your Company's agent context, when your account has a company domain                           |
| `user`              | Your own agent context                                                                         |
| `books/` | The agent context of the Book you are in                                                       |
| `apps/`   | The code of each App you develop. Apps hosted elsewhere, such as on GitHub, link to their code |

A place you can only read, such as a Book you can only view, opens read only.

## Change files

- **Edit** a text file right where it opens. A dot in the tree marks every file you or the agent changed. **Diff** shows what changed.
- **Add** with a folder's menu: **New file**, **Add AGENTS.md** in an empty place, or **New skill**, which fills the message box with a request for the agent to finish.
- **Drop** files or folders from your computer onto a folder to add them.
- **Rename** a file, or drag it onto another folder of the same place.
- **Copy to…** or **Move to…** another place, such as from You to your Company. The dialog says who will see it there.
- **Delete** a file or folder. It asks first, and History can bring it back.
- **Ask agent**, beside text you select, adds those lines to your message.

PNG and JPEG pictures open as pictures, and SVG files show a **Preview** beside their **Code**.

The agent sees your changes as you make them. Your next message tells it which files you changed.

## Review and save

1. **Open History** from a folder's menu.

2. **Open Not saved yet**, its first row, to see every change in that place, yours and the agent's.

3. **Click Save.** The changes reach everyone in that place at once: only you, your company, the people who can view the Book, or the App's developers.

- **Discard changes**, on a file's menu, and **Discard all**, in the review, put things back as they were last saved. Both ask first, since some changes may be the agent's.
- **When someone saved the same lines meanwhile**, nothing is saved. Your changes stay, and **Ask agent to combine** asks the agent to bring both versions together for you to review.
- **Where you can't save**, such as a Book you can only view, Save is off and says who can.
- **Saving agent context your conversation uses** reloads it there, so the agent follows the new version at once.
- **Saving an App's code** does not deploy the App. Ask the agent to deploy it. A new App the agent just made shows **Not published yet**: ask the agent to publish it before you save.

## Look back and undo

**History** lists every saved change in a file, a folder, or a whole place, with who made it and when. Changes made with the agent's help carry its icon. Click a change to see what it changed.

- **Restore this version**, on a file's change, brings that version back into the file.
- **Undo this change**, on a change to a folder or a whole place, reverses it. It asks first and says who is affected.

Restored and undone files are changes like any other: review and save them.

## Limits

- **Text files:** up to 256 KB.
- **Pictures:** PNG and JPEG, up to 5 MB.
- **Adding from your computer:** up to 100 files and 10 MB at once.
- **Large folders:** only the first 500 files are listed.

Agent context has its own limits, such as 50 skills per place. See [Agent Context limits](https://bkper.com/docs/ai/agent-context.md#limits).

## Next steps

- [Learn what agent context is and where it applies](https://bkper.com/docs/ai/agent-context.md).
- [Build Apps with Bkper Agent](https://bkper.com/docs/ai/bkper-agent/build-apps.md).
- [Back to Bkper Agent](https://bkper.com/docs/ai/bkper-agent.md).