> 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.
# Start guide
Go from a new account to your first ticket: sign up, name your workspace, connect GitHub, and assign it.
## Overview
AoTwin is a place to keep your team's tickets, and a teammate you can assign them to. This guide takes you from a new account to a first ticket that is filed and assigned.
You need an email address, or a Google account. You need a GitHub account only if you want AoTwin to change code.
## Sign up
1. Open `app.aotwin.io/start`. If you picked a plan on the [pricing](https://aotwin.io/pricing) page, the link already carries your choice.
2. Choose **Continue with Google**, or choose **Continue with email**, type your address and press the arrow.
3. For email, open the message we send. The link works once and lasts 15 minutes. If it fails, go back to the page and ask for a new one.
4. On the **Welcome to AoTwin** page, type the name your teammates should see and press **Continue**. Your name goes on the work you ask for. If you signed in with Google, AoTwin uses your Google name and skips this question.
5. On **Name your workspace**, check the suggestion and press **Continue**. For a work address AoTwin suggests your company's name. For a personal address it suggests "Your name's workspace". The name can be up to 80 characters.
> If someone invited you to their workspace, open their invitation instead of signing up. See [People](https://aotwin.io/docs/people).
## Look around Home
You land on **All work**, the home of the workspace. The sidebar has **Inbox**, **All work**, **My requests**, **Ask AoTwin**, and three shortcuts under **Views**. Read [Concepts](https://aotwin.io/docs/concepts) for the words used across the app.
A new workspace starts on the Free plan. Free keeps your team's tickets in one place and lets you assign them to teammates. AoTwin itself, and [Ask AoTwin](https://aotwin.io/docs/ask-aotwin), come with a paid plan. If you sign up with a throwaway email address, the workspace starts with no plan and can't file tickets until an admin picks one in **Settings > Plan**. See [pricing](https://aotwin.io/pricing) for what each plan includes.
As an admin you also see a **Get AoTwin ready** window with the steps left. Press **Later** to close it. It opens again from the **Finish setting up AoTwin** card in the sidebar.
## Connect GitHub
Do this if you want AoTwin to change code. Skip it to use AoTwin as a ticket tool for now. Only admins can do it, and the step is not shown on the Free plan.
1. In **Get AoTwin ready**, press **Install** on **Install the GitHub app**. You can also go to **Settings > Connections**, find **GitHub** and press **Install**.
2. On GitHub, choose the account and the repositories AoTwin may reach.
3. Back in AoTwin, each repository becomes a project, named after the repository. AoTwin adds up to ten at a time, and fewer if your plan's project limit is lower. A note on Home says how many were left out and links to **Settings > Code**, where you can choose which ones to keep.
AoTwin can open changes in these repositories but can't merge them. Every change waits for one of your engineers. See [GitHub](https://aotwin.io/docs/github) for the details.
## Choose a plan
If AoTwin should do the work, pick a paid plan in **Settings > Plan**. If you chose a plan on the pricing page, the setup window shows a **Start** button for it that opens checkout. Credits come with the plan; see [Credits](https://aotwin.io/docs/credits).
## File your first ticket
1. Press **New request** in the top right of Home, or press `C`.
2. Write a title and a description. Say what is wrong or wanted, and where. A copy fix, a missing filter or a layout that has been wrong for months are all good first tickets.
3. Pick a **Project** if you have more than one.
4. Choose who it is assigned to in the **Assigned to** menu: **Nobody**, **AoTwin**, or a teammate.
5. Press **Send request**, or `⌘↵`.
You land on the ticket's page, with its key, like `WEB-12`. Read [Tickets](https://aotwin.io/docs/tickets) for every field.
## Assign it
**Assigned to** decides who works on the ticket.
- A teammate: the ticket starts in **Todo** and waits for them.
- **AoTwin**: the ticket is sent and AoTwin starts on it. This spends credits. With a paid plan and code connected, **AoTwin** is already chosen when you open the form.
- **Nobody**: the ticket waits in **Backlog**.
> If GitHub isn't connected yet, an AoTwin ticket is saved and waits. The ticket says "Saved · AoTwin starts once GitHub is connected" and begins as soon as an admin connects it.
You can change the assignee at any time from the ticket page. See [Statuses](https://aotwin.io/docs/statuses) for what happens next.
## Invite your team
Press **Invite** in the setup list, or go to **Settings > People**. Members can see all the work, file tickets and comment. See [People](https://aotwin.io/docs/people).
## Next steps
- [Tickets](https://aotwin.io/docs/tickets): the fields, the similar-ticket check, editing and closing.
- [Statuses](https://aotwin.io/docs/statuses): what each status means and what moves a ticket.
- [Board and list](https://aotwin.io/docs/board-and-list): see all the work at once.
- [Inbox](https://aotwin.io/docs/inbox): where AoTwin's questions and results arrive.
- [Ask AoTwin](https://aotwin.io/docs/ask-aotwin): ask questions about your tickets.
## FAQ
Do I need to connect GitHub?
Not to keep tickets. You need it for AoTwin to change code, because AoTwin works only in repositories you choose. Until then, tickets assigned to AoTwin are saved and wait.
The sign-in email didn't arrive. What now?
Check your spam folder, then go back to the **Check your email** page and choose **Use a different email** if you mistyped. Each link works once and lasts 15 minutes. Asking too many times in an hour is limited, so wait a little before trying again.
Can I set a password?
No. AoTwin signs you in with Google or with an email link each time.