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

# First setup

> Connect your code host, then your ticket tool, then choose your repositories.

An owner or admin of your company does the first setup on **Home**. Home shows a checklist, **Get started**, with every step for your tools. Each step turns to **Done** when it is finished.

![Home in CodeObsess: the side menu on the left and the Get started checklist with steps marked Done, a Learn panel on the right](https://mintcdn.com/code-obsess/0ZvNNm_XHMri9byY/images/home/home-light.png?fit=max\&auto=format\&n=0ZvNNm_XHMri9byY\&q=85\&s=aa48efb186bc1212554278fc0f2f84dd)

## 1. Choose where your code is

Home asks **Where is your code?** Choose GitHub or Bitbucket. You choose this once; to change it later, contact CodeObsess.

Then connect it:

* [Connect GitHub](https://docs.codeobsess.com/connect/github.md)
* [Connect Bitbucket](https://docs.codeobsess.com/connect/bitbucket.md)

## 2. Choose your ticket tool

Home asks where your tickets live: **GitHub Issues**, **Linear** or **Jira**. CodeObsess picks up work from that tool and reports back there. GitHub Issues works only with GitHub as the code host.

Then follow its steps:

* [GitHub Issues](https://docs.codeobsess.com/connect/github-issues.md)
* [Linear](https://docs.codeobsess.com/connect/linear.md)
* [Jira](https://docs.codeobsess.com/connect/jira.md)

Owners and admins can change the ticket tool later in **Settings › General**. After a change, nothing new starts from the old tool. Tickets already running there, or waiting for your answer, still finish there.

## 3. Choose your repositories

On the **Choose repositories** step, pick the repositories CodeObsess may work in:

* **Write**: CodeObsess may change it and open pull requests.
* **Read-only**: CodeObsess reads it but never changes it.
* One repository is the **Main repository**: where CodeObsess starts work and opens pull requests. It must be one CodeObsess can write to.

You can change these later in **Settings › Repositories**.

## 4. Invite your team and connect AI

* **Invite your team** from **People**. See [Invitations](https://docs.codeobsess.com/team/invitations.md).
* **Connect your Claude account**, or add a company AI key. See [Which AI runs a ticket](https://docs.codeobsess.com/ai/which-ai.md).

When the checklist is done, try [your first ticket](https://docs.codeobsess.com/getting-started/first-ticket.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.