> ## Documentation Index
> Fetch the complete documentation index at: https://help.plannotator.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Plannotator Workspaces

> Keep plans, specifications, decisions, diagrams, and wireframes together so teammates and agents can work from the same material.

Planning as a team matters more as agents take on more of the work. A plan is
not always one document. It may include a main plan, specifications, decision
records, HTML diagrams, wireframes, and other supporting files.

Plannotator Workspaces keeps those files together so teammates and agents can
work from the same plan. Teammates can comment and edit Markdown together.
Agents can read and update the same files.

<div className="not-prose my-8 overflow-hidden rounded-2xl border border-gray-200 bg-white dark:border-white/10 dark:bg-[#0B0B0D]">
  <img className="block w-full dark:hidden" src="https://mintcdn.com/plannotator-help/1IkVOQqKeGgFrCkx/images/workspaces-team-planning.webp?fit=max&auto=format&n=1IkVOQqKeGgFrCkx&q=85&s=d5428f30613a6111b91722c9f75d7141" alt="Two teammates, Totman, and a coding agent share a main plan connected to a specification, decision record, HTML diagram, and wireframe." loading="eager" decoding="async" width="1774" height="887" data-path="images/workspaces-team-planning.webp" />

  <img className="hidden w-full dark:block" src="https://mintcdn.com/plannotator-help/1IkVOQqKeGgFrCkx/images/workspaces-team-planning-dark.webp?fit=max&auto=format&n=1IkVOQqKeGgFrCkx&q=85&s=9e1ad138338e84fc0d19c8368707513a" alt="Two teammates, Totman, and a coding agent share a main plan connected to a specification, decision record, HTML diagram, and wireframe." loading="eager" decoding="async" width="1774" height="887" data-path="images/workspaces-team-planning-dark.webp" />
</div>

## Keep the whole plan together

A workspace can hold one document or many related files organized by path:

```text theme={null}
plan.md
specs/api.md
decisions/0001-auth.md
diagrams/system.html
wireframes/onboarding.html
```

The main plan can point to its supporting files. People and agents can find the
current requirements, designs, and decisions without putting everything in one
document. Workspaces keeps a version history for each file.

You can start with one file. Drop a Markdown or HTML file without an account,
and Workspaces opens a temporary workspace with a collaborative link. If you
sign in first, **New workspace** creates a private personal workspace.

<CardGroup cols={2}>
  <Card title="Share your first plan" icon="link" href="/workspaces/get-started/share-your-first-plan" arrow="true">
    Drop one Markdown or HTML file, copy its collaborative link, and claim the
    workspace before it expires.
  </Card>

  <Card title="Create and organize a workspace" icon="folder-tree" href="/workspaces/get-started/create-and-organize-a-workspace" arrow="true">
    Create a private personal workspace and organize documents with full paths.
  </Card>
</CardGroup>

## What Workspaces includes

* Workspace-level access for owners, organization members, and guests.
* Live Markdown editing, presence, comments, replies, and version history.
* Read and comment support for HTML documents.
* Files organized in a shared path tree and published artifacts such as images
  and HTML previews.
* API keys, MCP tools, a live HTTP API, and read-only Git clone and fetch.

Workspaces does not include approval gates, inboxes, planning boards, or pull
request review rooms.

<Card title="Review plans and technical decisions" icon="file-pen" href="/workspaces/review-plans-and-technical-decisions" arrow="true">
  See how a main plan can sit beside specifications, decision records,
  wireframes, and an agent handoff.
</Card>

## Choose the right Plannotator product

| Use                                                                                       | Best fit                                                                   |
| ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| Private feedback returned to one active coding-agent session                              | [Open-source Plannotator](https://docs.plannotator.ai/open-source/)        |
| Shared plans or technical documents that several people or agents need to read and change | Plannotator Workspaces                                                     |
| A collaborative room centered on one public GitHub pull request                           | [Plannotator Live Code Review](https://docs.plannotator.ai/code-review/)   |
| A local place to inspect files produced or used by agents                                 | [Artifact Server](https://docs.plannotator.ai/open-source/artifact-server) |

*Reviewed July 22, 2026. Maintained by the Plannotator documentation team.*