---
title: "Using MySpec"
description: "A tour of the MySpec web app and where to find each guide."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.myspec.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Using MySpec

These guides cover the MySpec web app at
[app.myspec.dev](https://app.myspec.dev). If you are new, start with the
[Quickstart](/get-started/quickstart/) and [Core concepts](/get-started/concepts/).

## The main areas

| Area | Where to find it | What it is for |
|---|---|---|
| **Projects** | The top bar | Search your projects, switch between **All projects**, **Created by me** and **Archived**, and create a **New Project**. |
| A project page | Select a project | **Home**, with everything that has happened in the project, the **Chats**, **Discussions**, **Tasks** and **Settings** tabs, the file explorer with spec files and attachments, the comments panel and **Share**. **Settings** holds the project's details, access, **MCP servers** and **Custom skills**. |
| A chat | Select a chat, or start one from the project page | The conversation with the AI, the workflow's stages and the spec files it writes. |
| **Notifications** | The bell in the top bar | Mentions, replies, finished sessions and plan limit alerts. |

## The avatar menu

Select your avatar in the top-right corner to open the menu:

| Item | What it opens |
|---|---|
| **Profile** | Your name, photo, timezone, locale, organizations, professional role, notification preferences and personal MCP servers. |
| **Organization settings** | Members, invitations, **Spec integrations** and Custom Skills. Only owners and admins see this item. |
| **API tokens** | Long-lived tokens for MCP clients that run without a browser. |
| **Connected apps** | Apps such as Claude or ChatGPT you have allowed to use MySpec, and a way to disconnect them. |
| **Usage** | Your AI activity this month and your organization's plan limits. |
| **Organization** | A quick switcher between the organizations you belong to. |
| **Theme** | Switch between light and dark mode. |
| **Language** | The interface language. |
| **Role** | Your professional role in the current organization. |
| **Sign out** | Signs you out of MySpec. |

## Guides

### Projects and sessions

- [Projects](/guides/projects/) — Create, organize, archive and delete projects and chats.
- [Generate sessions](/guides/generate-sessions/) — Run the interview and review each spec file as it is written.
- [Edit sessions](/guides/edit-sessions/) — Change existing spec files with the AI.
- [Work on an existing codebase](/guides/brownfield/) — Let MySpec read your code for Brownfield projects.
- [Attachments and local files](/guides/attachments/) — Give the AI documents and files to read.
- [Finish a session and build](/guides/finishing-a-session/) — Download your specs or hand them to a build tool.

### Spec files

- [Spec files](/spec-files/) — What spec files and bundles are, and what each file type contains.
- [Writing requirements (EARS+)](/spec-files/ears-plus/) — How MySpec writes requirements and acceptance criteria.
- [View and edit spec files](/guides/spec-editor/) — Read, edit and compare revisions of a spec file.

### Collaboration

- [Working together](/guides/collaboration/) — See who else is in a project and work on specs as a team.
- [Comments](/guides/comments/) — Discuss a spec file with your team, line by line.
- [Share links](/guides/share-links/) — Share a read-only snapshot of your specs with anyone.
- [Notifications](/guides/notifications/) — Read notifications and choose which ones reach you by email.

### Customize the AI

- [Custom Skills](/guides/custom-skills/) — Give the AI your team's domain knowledge.
- [Connect your own MCP servers](/guides/your-mcp-servers/) — Let the AI in your sessions use tools from your own MCP servers.

### Account and organization

- [Sign-in and your account](/guides/account/) — Register, sign in, reset your password and manage your profile.
- [Organizations and members](/guides/organizations/) — Invite people, manage members and organization settings.
- [Teams and project access](/guides/teams-and-project-access/) — Decide who can open and change each project, with teams and project roles.
- [Usage and limits](/guides/usage-and-limits/) — Check your AI usage and your organization's plan limits.

Source: https://docs.myspec.dev/guides/index.mdx