# Writ > Writ is an open-source control plane for OpenTofu that you host yourself. It plans the commits you or your CI job send it, waits for your team to approve, and applies that exact plan. Every page of the documentation is also served as plain Markdown at the URLs below. ## Docs - [Overview](/raw/index.md): What Writ is, and where to find each page of the docs. (page: /docs) - [Quick start](/raw/quick-start.md): Try Writ on your own with writ serve --dev and no cloud account, then set it up for a team, where a second person approves the plan. (page: /docs/quick-start) - [Install](/raw/install.md): Get writ with the install script, as a container image, with Nix, or from source. (page: /docs/install) - [Writ compared with OpenTofu in plain GitLab CI](/raw/compare-gitlab-ci.md): What Writ adds to a pipeline whose jobs run tofu themselves, what it costs, and when plain CI is the better choice. (page: /docs/compare-gitlab-ci) - [Writ compared with other control planes](/raw/compare.md): Writ against Atlantis, OTF, Terrakube, Spacelift, HCP Terraform, env zero, and Scalr, from each tool’s own pages, with sources and dates, and what they have that Writ doesn’t. (page: /docs/compare) - [Status and limits](/raw/status.md): What works in version 0, how it is tested, and what is missing. (page: /docs/status) - [How the control plane works](/raw/serve.md): How writ serve plans a commit, runs OpenTofu apart from its keys, keeps state, checks drift, and decides who can do what. (page: /docs/serve) - [Repositories](/raw/repos.md): How the control plane reads your code by commit, finds stacks, and plans a commit. (page: /docs/repos) - [Approvals](/raw/approvals.md): How a plan is approved: its lifecycle, approval rules, who can approve, stale plans, and what each run records. (page: /docs/approvals) - [Secrets and the mask](/raw/secrets.md): How writ serve keeps secrets out of everything it stores and shows, how that is tested, and what the mask can’t catch. (page: /docs/secrets) - [Policy](/raw/policy.md): Rego policies that check each OpenTofu plan when it is created and again before its apply. (page: /docs/policy) - [Run a control plane](/raw/run.md): Start writ serve --dev for yourself, or a team’s writ serve with Postgres or on NixOS, and back it up. (page: /docs/run) - [Sign in](/raw/sign-in.md): How the CLI finds a control plane, writ login, and the control UI. (page: /docs/sign-in) - [Add a repository](/raw/add-repository.md): Add a local repository or a GitLab project, and the rules for names and prefixes. (page: /docs/add-repository) - [Set up GitLab CI](/raw/set-up-gitlab-ci.md): Plan, approve, and apply from GitLab CI jobs with no checkout and no cloud credential. (page: /docs/set-up-gitlab-ci) - [Approve and apply a plan](/raw/apply.md): Apply a plan by its id or after a merge, recover when an answer is lost, and override the approval rules. (page: /docs/apply) - [Adopt a state](/raw/adopt-state.md): Seal a secret set with a state Writ didn’t write, so its plans can be approved again. (page: /docs/adopt-state) - [Write and test a policy](/raw/write-a-policy.md): Write a Rego policy, test it with conftest, and start from the examples. (page: /docs/write-a-policy) - [Import many objects](/raw/import-bulk.md): Take over many existing objects into an OpenTofu stack in one run, and accept the plan that imports them. (page: /docs/import-bulk) - [Use Writ with an agent](/raw/agents.md): Set up a repository for a coding agent: the skill writ agent init installs, writ mcp, and what has been measured. (page: /docs/agents) - [Commands](/raw/commands.md): Every command and flag, exit codes, and environment variables. (page: /docs/commands) - [Server config](/raw/config.md): Every setting and block of the writ serve config, and what writ serve --check refuses. (page: /docs/config) - [API](/raw/api.md): Every route of writ serve, token checks, rate and time limits, and what the API refuses. (page: /docs/api) - [Control database](/raw/database.md): What the control database keeps, table by table, and what each audit row records. (page: /docs/database) - [Policy input and built-ins](/raw/policy-reference.md): The input a policy reads, the Rego built-ins it can call, and its bounds. (page: /docs/policy-reference) - [JSON output](/raw/json-output.md): The contract for every --json document: formats, fields, and what may change. (page: /docs/json-output) - [Errors](/raw/errors.md): Each error class: what it means, its exit code and HTTP status, its common messages, and what to do. (page: /docs/errors) - [Reference for agents](/raw/agent-reference.md): What an agent reads and calls: the tools of writ mcp, the documents they return, the policy, and how to recover from each refusal. (page: /docs/agent-reference) - [Glossary](/raw/glossary.md): The terms the docs use, each with one meaning and its Terraform equivalent. (page: /docs/glossary) - [Development](/raw/development.md): Build and test commands, how Writ is built, and the test plans that need a real host or GitLab. (page: /docs/development) - [Architecture](/raw/architecture.md): The package map of version 0, the decisions behind it, and how an interrupted apply recovers. (page: /docs/architecture)