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

# Quickstart

> Get up and running with Tembo in minutes.

<Steps>
  <Step title="Connect a repository">
    Go to [Integrations](https://app.tembo.io/integrations) and connect GitHub, GitLab, or Bitbucket. Select the repositories you want Tembo to access.
  </Step>

  <Step title="Create a session">
    Open the [Tembo Dashboard](https://app.tembo.io) and click **New Session**. Pick one or more repositories, choose your [agent harness](/features/agents#agent-harness), and describe the work. Tembo can also use connected integrations and [MCP servers](/integrations/mcp) for extra context during the session.
  </Step>

  <Step title="Review the PR">
    Tembo works in a [sandbox](/features/sandbox-environment), writes the code, and opens a pull request. Review it, then mention `@tembo` in PR comments to request changes.
  </Step>

  <Step title="Set up agents">
    Go to [Agents](https://app.tembo.io/agents) and pick a template or create your own with custom triggers and schedules. See [Agents](/features/agents).
  </Step>
</Steps>

***

## Where to tag @tembo

**Tag required:** PR comments, GitHub issues, Slack messages.

**No tag needed:** Dashboard sessions, Linear/Jira issues assigned to Tembo.

## Writing good prompts

Include: **what** needs to change, **where** (file paths), **why**, and **how you'll know it's done**.

```text theme={null}
Fix memory leak in workers/job-processor.ts

Heap grows from 512MB to 4GB and crashes after ~6 hours.
Likely in cleanup logic around line 156. See Sentry #12345.

Done when: memory stable over 24+ hours, no queued jobs lost.
```

**Avoid:** "Fix the bug", "Make it faster", "Update the app and add new features". Be specific, scope to one session, and include acceptance criteria.

| Type         | What to include                                                     |
| ------------ | ------------------------------------------------------------------- |
| **Bug**      | Steps to reproduce, expected vs actual, error messages, Sentry link |
| **Feature**  | Requirements, file locations, edge cases, dependencies              |
| **Refactor** | Current problems, desired state, constraints, specific files        |

## Next steps

<CardGroup cols={2}>
  <Card title="Agent harness" icon="bot" href="/features/agents#agent-harness">
    Choose the right harness and model.
  </Card>

  <Card title="Rule Files" icon="file-cog" href="/features/rule-files">
    Define coding standards for agents to follow.
  </Card>
</CardGroup>