Documentation

Getting Started

From zero to your first automated pull request in under 10 minutes. Sign up, connect a GitHub project, and type a task — TARS handles the rest.

Step 1 — Create an Account

1

Sign up at tarsai.dev

Visit tarsai.dev and enter your email and company name. You'll receive a confirmation email — click the link inside to activate your account.

2

Land on the chat dashboard

After confirming your email you're taken directly to the TARS chat dashboard. You'll see TARS's greeting — "Hi! I'm TARS. Tell me what to code." — and a set of suggestion chips to help you get started quickly.

Already have an account? Sign in here.

Step 2 — Connect a GitHub Project

1

Click "Add a GitHub project" or paste a URL directly

On a fresh account the chat input bar shows a single field with the placeholder "Paste a GitHub repo URL (e.g. github.com/user/repo)". You can also click the Add a GitHub project suggestion chip — it focuses the input for you.

2

Paste your repository URL and press Enter

Type or paste the full GitHub URL — for example, github.com/acme-corp/backend-api — and press Enter. TARS detects that it's a repository link, connects the project, and confirms it in the chat feed.

Once connected, the input bar switches to the full task interface with a project selector pill on the left.

Adding more projects later: With projects already connected, paste any GitHub URL directly into the chat input — TARS automatically detects it as a repository link and adds it rather than treating it as a task.
Private repositories: TARS needs read/write access to clone your repo and push branches. We recommend creating a dedicated deploy key or service account with Contents: read & write and Pull requests: read & write permissions.

Step 3 — Submit a Task

1

Select a project from the project pill

At the left side of the chat input bar you'll see a pill labelled Select project with a folder icon. Click it to open a dropdown and choose the repository you want TARS to work on.

2

Type your task and press Enter

Click the text area (placeholder: "Ask TARS to code something..."), describe the task, then press Enter to send. Use Shift+Enter to add a new line without sending.

Good task descriptions:

  • "Fix the 500 error when a user resets their password with an expired token"
  • "Add pagination to the /api/products/ endpoint (page size 20)"
  • "Write unit tests for the calculate_discount function in billing/utils.py"
Use the task templates button (card-list icon, right side of the input bar) to pick from pre-built task starters, or the bulk add button (list icon) to queue multiple tasks at once — one per line.

Step 4 — Watch TARS Work in Real Time

1

Your message appears in the feed

The task you typed shows up as a user message bubble. TARS immediately responds with a status card below it.

2

Watch the status badge update

The TARS reply card displays a live status badge that progresses through:

  • Pending — task is queued, waiting for a worker
  • In Progress — a worker has picked it up and is coding
  • Completed — the PR is open on GitHub

The badge updates in real time — no refresh needed.

3

Open the pull request

When the task is complete, a green View PR link appears inside the TARS message card. Click it to open the pull request on GitHub, review the changes, and merge when ready.

What Happens Under the Hood

Once you send a task, TARS:

  1. Queues the task and waits for an available worker
  2. Clones your repository on a fresh worker environment
  3. Analyzes the codebase to understand context, conventions, and dependencies
  4. Implements the requested changes using Claude AI
  5. Runs your existing test suite (pytest, jest, etc.) to verify correctness
  6. Opens a pull request on GitHub with a descriptive title and summary
  7. Shows the PR link in the chat feed
Review before merging. TARS is autonomous but not infallible. Always review the generated PR before merging to ensure it meets your standards and doesn't introduce unintended changes.

Next Steps