# Tylon

> Tylon is Git's control panel: a board whose columns are real branches. Documentation for the public API and the MCP server.

## Docs

- [Tylon: Git's control panel](https://docs.tylon.app/en/index.md): Tylon is where work lives and where Git happens. A column is a real branch, moving a card is a real merge. These docs cover the public API and the MCP server.
- [Read a board from a script in five minutes](https://docs.tylon.app/en/quickstart.md): Make an API credential, call the Tylon API with it, and read a board. Covers the one moment the secret is readable and how to choose a board.
- [Cards, boards and projects](https://docs.tylon.app/en/concepts/cards.md): What a card is in Tylon, the difference between a draft in the backlog and one in flight, and why one card can own branches in several repositories at once.
- [The flow: columns that are branches](https://docs.tylon.app/en/concepts/flow.md): A Tylon flow says where each stage cuts its branch from and where it merges to. Moving a card runs that, and a refusal is the card refusing to lie.
- [Releases, freezing and the trunk](https://docs.tylon.app/en/concepts/releases.md): A Tylon release groups cards of one project. Freezing cuts the branch and stops what ships from changing; the trunk says what actually went out.
- [The inbox](https://docs.tylon.app/en/screens/inbox.md): What Tylon stopped on, and what happened in the repositories without passing through it. A queue of decisions, never a copy of state.
- [The backlog](https://docs.tylon.app/en/screens/backlog.md): Where work starts in Tylon: drafts with no branch and no Git, worked as a list rather than a column.
- [The board](https://docs.tylon.app/en/screens/board.md): Every stage of a Tylon flow with the cards standing in it — and under each column, the branch rule it runs.
- [A card](https://docs.tylon.app/en/screens/card.md): What a Tylon card holds: its branches and pull requests across every repository, the reason it is blocked, and the story of everything that happened to it.
- [The flow](https://docs.tylon.app/en/screens/flow.md): Where a Tylon team says what each stage does to Git: the statuses, the branch matrix, and who may move a card into each one.
- [The trunk](https://docs.tylon.app/en/screens/trunk.md): One line through the month: what landed, what was promised and has not, and the five numbers that say whether the board is moving.
- [Releases](https://docs.tylon.app/en/screens/releases.md): A group of Tylon cards delivered together. Freezing stops what ships from changing; completing writes a tag and a changelog per repository.
- [Projects](https://docs.tylon.app/en/screens/projects.md): A project is a product the team ships — its repositories, its cards, its releases and its own flow.
- [Pages](https://docs.tylon.app/en/screens/docs.md): The pages a Tylon team writes for itself and its agents — conventions, runbooks, what a decision was, linked to each other and to the cards.
- [Agents](https://docs.tylon.app/en/screens/agents.md): An agent in Tylon is a member of the team: it holds a role, is assigned cards, writes on them, and signs what it does.
- [A run](https://docs.tylon.app/en/screens/runs.md): The receipt for one waking of an agent: what woke it, what it cost, what it read, and every line it wrote.
- [Settings](https://docs.tylon.app/en/screens/settings.md): Who is on the board and what their role lets them do, the rules that do the mechanical half of the work, and the credentials that let something outside a browser in.
- [Connect an editor](https://docs.tylon.app/en/mcp/connect.md): Give your editor one URL and it finds the rest. Tylon's MCP server authenticates you with OAuth 2.0 and PKCE, and you pick which boards the connection reaches.
- [What the tools do](https://docs.tylon.app/en/mcp/tools.md): The 65 tools Tylon's MCP server offers, by what they are for: cards, the board, the inbox, pages, releases, agents and setup.
- [Tylon public API](https://docs.tylon.app/en/api-reference/introduction.md): Base URL, what the API reads and writes, how a board is chosen, and the rate limit. The reference for anything reaching Tylon without a browser.
- [Credentials, secrets and rotation](https://docs.tylon.app/en/api-reference/authentication.md): A Tylon API credential is a public client id and a secret sent as a Bearer token. Two secrets can be alive at once, which is what makes rotation possible without downtime.
- [Choosing a board](https://docs.tylon.app/en/api-reference/workspaces.md): A Tylon credential can reach several boards. The X-Tylon-Workspace header says which one a call is about, by workspace id.
- [Writing](https://docs.tylon.app/en/api-reference/writing.md): The Tylon API writes with the write scope and a required Idempotency-Key, so a retried request cannot run Git twice. What the credential signs, and what it is not allowed to do.
- [Errors](https://docs.tylon.app/en/api-reference/errors.md): Every refusal from the Tylon API is an HTTP status code with a JSON body. What each one means, and the fix for it.
- [Account](https://docs.tylon.app/en/api-reference/endpoints/account.md): What a Tylon API credential is, which boards it reaches and which organizations they sit in. The three calls that never ask which board you mean.
- [Inbox](https://docs.tylon.app/en/api-reference/endpoints/inbox.md): Read what is waiting for a person in Tylon — branch suggestions, refused promotions, grouped errors — and clear it.
- [Backlog](https://docs.tylon.app/en/api-reference/endpoints/backlog.md): Read the Tylon backlog — the drafts behind a board, which have no branch and touch no Git.
- [Board](https://docs.tylon.app/en/api-reference/endpoints/board.md): Read a Tylon board column by column — every stage of the flow with the cards standing in it.
- [Cards](https://docs.tylon.app/en/api-reference/endpoints/cards.md): Read and write one Tylon card — its stage, repositories, branches and pull requests, the story of everything that happened to it, and the writes that move it.
- [Checks and reviews](https://docs.tylon.app/en/api-reference/endpoints/forge.md): What CI said about a Tylon card's branches and what reviewers left on its pull requests — the two things that happened on the forge rather than here.
- [Releases](https://docs.tylon.app/en/api-reference/endpoints/releases.md): Read and write Tylon releases — what ships together, freezing, picking, promoting and completing.
- [Trunk](https://docs.tylon.app/en/api-reference/endpoints/trunk.md): What actually went out of a Tylon board over a window of days, and what was taken back out. Not a status somebody typed.
- [Projects](https://docs.tylon.app/en/api-reference/endpoints/projects.md): Read and write Tylon projects — the products a board ships, each owning its flow, repositories and releases.
- [Labels](https://docs.tylon.app/en/api-reference/endpoints/labels.md): Read and write the labels on a Tylon board.
- [Features](https://docs.tylon.app/en/api-reference/endpoints/features.md): Read and write Tylon features — the grouping that follows one thing being built across many cards.
- [Pages](https://docs.tylon.app/en/api-reference/endpoints/docs.md): Read and write the pages Tylon agents read before they work — conventions, the shape of a migration, what not to touch.