> For agents: connect to the AoTwin MCP server at https://app.aotwin.io/mcp to read and change tickets and projects. Setup guide: https://aotwin.io/docs/mcp.md. Index of all docs: https://aotwin.io/llms.txt.

# AoTwin Docs

## Getting started
- [Start guide](/docs/start-guide.md): Go from a new account to your first ticket: sign up, name your workspace, connect GitHub, and assign it.
- [Concepts](/docs/concepts.md): The words AoTwin uses across the app: workspace, project, ticket, key, status, assignee, credits and more.

## Tickets and projects
- [Tickets](/docs/tickets.md): File a ticket, understand its fields, and edit, close or reopen it later.
- [Statuses](/docs/statuses.md): What each status means, what moves a ticket from one to the next, and who can cancel.
- [Board and list](/docs/board-and-list.md): See all your tickets grouped by status, and drag them between columns on the board.
- [Inbox](/docs/inbox.md): See what AoTwin has for you: questions, hand-backs and finished changes on tickets you asked for.
- [Projects](/docs/projects.md): Group tickets by product or repository, add and remove projects, and work before code is connected.
- [Comments](/docs/comments.md): Comment on a ticket, attach screenshots, react, and answer a question from AoTwin.
- [Ask AoTwin](/docs/ask-aotwin.md): Ask questions about your team's tickets in plain words, and have AoTwin draft new tickets for you to confirm.

## The AoTwin agent
- [Assign a ticket to AoTwin](/docs/assign-to-aotwin.md): Hand a ticket to AoTwin, see what it needs first, how to stop it, and what it will not do.
- [What to hand over](/docs/what-to-hand-over.md): Which tickets suit AoTwin, how to write them, and what happens when a ticket is unclear.
- [Review the work](/docs/review-the-work.md): Answer AoTwin's questions, read what it changed, and see how a ticket reaches Done or comes back.
- [Rules](/docs/rules.md): Set the files and folders AoTwin must never change, and see the guardrails that are always on.
- [Credits](/docs/credits.md): How credits pay for AoTwin's work, what uses them, what happens when they run out, and hand-backs.

## Integrations
- [GitHub](/docs/github.md): Connect GitHub, choose the repositories AoTwin can change, and match each one to a project.
- [Linear](/docs/linear.md): Connect Linear so you can assign issues to AoTwin there, and see what syncs in each direction.
- [MCP server](/docs/mcp.md): Connect your AI assistant to AoTwin to file, find and update tickets from the chat.
- [Slack](/docs/slack.md): Connect Slack so customer reports posted in a channel become tickets, and see how AoTwin handles each one.

## Administration
- [People](/docs/people.md): Invite teammates, set their role as admin or member, and remove people from the workspace.
- [Account](/docs/account.md): Change your name, switch between light and dark, connect AI tools, and understand how you sign in.
- [Plans and billing](/docs/plans-and-billing.md): What each plan adds, how to change plans, pay monthly or yearly, and what happens when you cancel.
- [Security and access](/docs/security-and-access.md): Who can see and change what in a workspace, how people sign in, and how connected AI tools are limited.