Workspaces and Files

1 What is a workspace?

A workspace is the folder where you keep a project or topic. It can be a writing project, a research folder, a client folder, a code repository, or a personal knowledge base.

OpAgent works best when each workspace has a clear purpose. This makes it easier for you and your agents to understand what belongs together.

2 Recommended folder habits

Start simple. You do not need a complex system.

A practical structure could be:

• README.md — what this workspace is about;
• notes.md — raw notes and ideas;
• draft.md — the document you are actively writing;
• references/ — source material;
• archive/ — old drafts or finished work.

You can change the structure at any time. The important part is to keep related material near the task you are working on.

3 Files and conversations

OpAgent treats Markdown files as first-class work material. A saved conversation can become a Markdown document, and a Markdown document can become the starting point for a new conversation.

This gives you a simple loop:

1. write or collect material;
2. ask an agent for help;
3. move the useful result back into the document;
4. continue editing.

4 Working with agents in folders

Some folders can have an agent associated with them. When you see an agent badge in the sidebar, it means that folder has an agent context attached to it.

Use this when a folder has a clear role. For example:

• a writing folder can use a writing agent;
• a research folder can use a research agent;
• a coding folder can use a development agent.

5 Keep it clean

A clean workspace helps both you and the agent.

• Use meaningful file names.
• Delete or archive old drafts.
• Keep reference material close to the task.
• Put final decisions into Markdown instead of leaving them only in chat.