eigent/docs/projects/workspace.md

84 lines
3.1 KiB
Markdown

---
title: Workspace
description: Use the Workspace landing page, project picker, instructions, agents, and recent sessions.
icon: desktop
---
The Workspace is the starting surface for the active Space. Use it to start work, select a project, review recent sessions, configure project behavior, and manage the agents available to Workforce mode.
## Open the Workspace
1. In the project sidebar, select **Workspace**.
2. Confirm the active Space in the sidebar.
The main composer starts a new project unless you select an existing project.
> **Screenshot placeholder:** Add a screenshot of the complete Workspace landing page with the composer, mode toggle, recent sessions, agent list, and instructions panel visible.
## Select a project
The project picker behaves differently depending on the current state:
- In a fresh Workspace, select an existing project before submitting a task.
- After work has started, the selected project is displayed as context.
- Selecting a recent session opens that Project's live Session.
Use **All sessions** to review more projects than the recent-session list shows.
## Start a task
1. Enter a request in the composer.
2. Select Single Agent or Workforce mode.
3. Attach required files.
4. Select **Send**.
Eigent creates a Project when no existing Project is selected.
## Use example prompts
Example prompts appear for an empty Project that does not use a custom agent folder or replayed history. Select a prompt to understand the expected level of task detail, then adapt it to your goal.
## Manage Workforce agents
The Workspace shows built-in and custom workers available to Workforce mode.
You can:
- Review the built-in Developer, Browser, Document, and Multimodal roles.
- Add a worker.
- Edit a custom worker.
- Assign tools to a worker.
- Remove workers that are no longer required.
See [Workers](/core/workers) for configuration details.
## Configure instructions, rules, and tone
Project instructions provide persistent guidance for work in the active Space or Project. Use them for:
- Output conventions
- Brand or writing tone
- Coding standards
- Required files or workflows
- Safety and approval rules
Keep instructions focused and actionable. Put step-by-step reusable expertise in an Agent Skill instead of one large instruction file.
> **Screenshot placeholder:** Add a screenshot of the instructions panel with a short example instruction. Do not include private repository rules.
## Toggle workspace memory
The Workspace includes a memory toggle for instruction behavior. This local setting is separate from the Agent Memory page, which is currently marked coming soon.
## Open recent sessions
Recent sessions display project names and current state. Select one to open its Session. Use the project sidebar or Home dashboard for the complete project history.
> **Video placeholder:** Add a 60-second MP4 showing project selection, instruction editing, worker management, and opening a recent session. Include captions.
## Related guides
- [Create a project](/projects/create-project)
- [Agents overview](/agents/overview)
- [Agent Skills](/core/agent-skills)
- [Sessions](/projects/sessions)