# Talyn documentation

Talyn gives every task its own coding agent in its own cloud sandbox, and helps you get the pull requests merged. These pages show you how to set it up and use it.

## Getting started

- [Quickstart](/content/docs/quickstart/index.html) Sign in with GitHub, install the GitHub App, connect your Claude or ChatGPT subscription, and start your first session.
- [Install Talyn](/content/docs/install/index.html) Download the desktop app for macOS, Windows or Linux, or use Talyn in your browser at app.talyn.dev.
- [Connect an agent](/content/docs/connect-agents/index.html) Run Claude Code on your Claude Pro or Max plan, or Codex on your ChatGPT plan. How to sign in, add more accounts and pick a default.

## Sessions

- [Sessions and threads](/content/docs/sessions/index.html) A session is one task on one branch, with its own agent, chat, diff, terminal and sandbox. A thread works across repositories by starting sessions for you.
- [Sandboxes](/content/docs/sandboxes/index.html) Each session runs in its own cloud sandbox. Box sizes, sleep and wake, saved work, internet access, and what to do when a sandbox has a problem.
- [Repository setup](/content/docs/repository-setup/index.html) Install dependencies, start your dev server and give the agent standing instructions, with .talyn/settings.toml, setup steps, dotfiles and repository instructions.
- [Skills](/content/docs/skills/index.html) Run your own SKILL.md playbooks on any pull request with a cloud agent, from your repository, from Talyn, or from your computer.

## Pull requests

- [The pull request dashboard](/content/docs/pull-requests/index.html) Every pull request you have open, across every repository you connect, with the ones that need you pulled to the front. Filters, review requests, and how to add repositories.
- [Fix pull requests with an agent](/content/docs/fix-pull-requests/index.html) Send an agent to fix failing checks, merge conflicts and review comments on a pull request, or have Talyn keep a pull request mergeable until it merges.
- [Merge queue](/content/docs/merge-queue/index.html) Queue a pull request and Talyn merges it when it is ready, updating the branch and fixing conflicts and failing checks on the way.
- [Code review](/content/docs/code-review/index.html) Have several agent reviewers read a pull request, check their findings, and show you the short list in Talyn. Nothing is posted to GitHub unless you choose Post to PR.

## Integrations

- [Integrations](/content/docs/integrations/index.html) Connect services, write automations, and review runs in one place.
- [Slack integration](/content/docs/integrations-slack/index.html) Connect Slack, link your account, and set personal triggers or channel automations.
- [Webhook integration](/content/docs/integrations-webhook/index.html) Give an automation its own URL. A request to the URL starts a session or a task.
- [Linear integration](/content/docs/integrations-linear/index.html) Connect Linear and start a session or a task when an issue changes. Talyn writes back to the issue.
- [GitHub Issues integration](/content/docs/integrations-github-issues/index.html) Start a session or a task when a GitHub issue changes. Talyn writes back to the issue.
- [PostHog Inbox integration](/content/docs/integrations-posthog-inbox/index.html) Start a session that opens a pull request when a PostHog self-driving report is ready for work.
- [GitHub automations](/content/docs/workflows/index.html) Run actions when pull request events match your conditions.
- [Schedule](/content/docs/loops/index.html) Run a prompt on a schedule. Each run starts an agent on your repository, and it opens a pull request when the work needs one.
- [Slack](/content/docs/slack/index.html) Start a session with an emoji reaction, mention, or direct message in Slack.
- [MCP servers](/content/docs/mcp-servers/index.html) Connect Linear, Sentry, Stripe or your own MCP server. Allow all repositories or only selected ones. The keys stay with Talyn and never enter the sandbox.

## Account

- [Plans, usage and billing](/content/docs/billing/index.html) How box-hours, plans, credits and annual billing work, what happens when you run out, and how to upgrade, change or cancel.
- [Insights](/content/docs/insights/index.html) See where your box-hours and agent tokens go, what your agents shipped, and how fast sessions start, for each workspace.

## API

- [API overview](/content/docs/api/index.html) Start sessions, send messages and read the results from your own scripts with the Talyn REST API and a personal access token.
- [API endpoint reference](/content/docs/api-reference/index.html) Every endpoint of the Talyn REST API, with its scope, parameters and response.
- [Webhooks](/content/docs/webhooks/index.html) Get a signed HTTP request on your server when a session is ready, a turn ends, a pull request merges or a code review finishes.
- [Talyn MCP server](/content/docs/mcp/index.html) Connect Claude Code, Codex, Claude Desktop, Cursor or another MCP client to your Talyn account, and manage pull requests, sessions and reviews from your editor.

## Reference

- [Security and data](/content/docs/security/index.html) How Talyn handles your agent sign-ins, MCP keys and GitHub access, what a sandbox can reach, and what Talyn stores.
- [Troubleshooting and FAQ](/content/docs/troubleshooting/index.html) What to do when an agent needs reconnecting, a subscription runs out, a sandbox will not wake, or GitHub is having an outage.
