# RepoOS > The repo is the operating system. Current release: v0.5.77 (Nov 6, 2026) — https://github.com/repo-os/repoos/releases Your AI dev team, living in your repo, for CTOs and builders. Every page below is also published as raw Markdown at the same path with `.md` appended — for example https://docs.repoos.org/getting-started.md — while the HTML page stays at https://docs.repoos.org/getting-started. A smaller essentials bundle (install, concepts, and agent setup): https://docs.repoos.org/llms-essentials.txt. The whole manual in one file: https://docs.repoos.org/llms-full.txt - [RepoOS Agent Skill (raw SKILL.md)](https://raw.githubusercontent.com/repo-os/repoos/main/agent/skill/SKILL.md): Portable Agent Skill an outside coding agent can fetch as Markdown. ## Documentation ### Getting started - [Getting started](https://docs.repoos.org/getting-started.md): RepoOS runs inside a repo you already have. - [Using RepoOS with an AI coding agent](https://docs.repoos.org/ai-agents.md): Hand the RepoOS website to Claude Code, Codex, OpenCode, Cursor, or another compatible agent, and let it inspect the repository, install RepoOS, and initialize it safely. - [Concepts](https://docs.repoos.org/concepts.md): A task is a markdown file in your configured task directory (repoos/work/ on a fresh install). - [Adding RepoOS to an existing repo](https://docs.repoos.org/existing-repo.md): RepoOS is designed to drop into a repo you already have. ### Using RepoOS - [Agents](https://docs.repoos.org/agents.md): An agent is a coding-agent CLI that RepoOS runs headless, plus a model, a set of instructions, and optionally a few skills. - [Built-in agents](https://docs.repoos.org/built-in-agents.md): Agents covers the lifecycle roles a task moves through — engineer, reviewer, pm, and the rest. - [Coding harness compatibility](https://docs.repoos.org/coding-harness-compatibility.md): Detection on PATH means only that RepoOS found a binary. - [Review and close-out](https://docs.repoos.org/review-and-close-out.md): A task with a feature branch reaches done through review. - [Running a project with AI agents](https://docs.repoos.org/running-with-agents.md): A practical loop for driving a RepoOS board with coding agents — yours, or a team of cheap ones. - [Notices and notifications](https://docs.repoos.org/notifications.md): The bell in the top bar collects things that happened without you watching: release runs, and the outcome of every Move to done (close-out). - [Checks before merge](https://docs.repoos.org/check.md): One command is the whole definition of done. - [Remote engineer sessions](https://docs.repoos.org/remote-engineers.md): ::: warning Planned — not yet available Running a whole engineer session on a remote runner is designed but not built yet. - [Tunnels](https://docs.repoos.org/tunnels.md): repoos tunnel publishes a local RepoOS instance to the internet through a Cloudflare Tunnel, guarded by Cloudflare Access. - [Dev targets](https://docs.repoos.org/dev-targets.md): A dev target is something you run yourself while developing: a local HMR web server, a debug build, a native app process you want running, a preview bundle. ### Reference - [CLI reference](https://docs.repoos.org/cli.md): Run repoos with no arguments to see this list in your terminal. - [repoos.toml reference](https://docs.repoos.org/configuration.md): This page is the definitive reference for RepoOS project configuration. - [Environment and secrets](https://docs.repoos.org/environment-and-secrets.md): RepoOS separates configuration into three buckets so a project stays safe and predictable: - [Authentication](https://docs.repoos.org/authentication.md): Auth is off by default. - [Native authentication](https://docs.repoos.org/native-auth.md): RepoOS native authentication controls which email addresses can sign in to a repository and which role each address has. - [Telegram](https://docs.repoos.org/telegram.md): Telegram connects a bot to an existing RepoOS repository. - [Deployments and releases](https://docs.repoos.org/deployments-and-releases.md): Both of these surfaces are opt-in and off by default. - [Changelog](https://docs.repoos.org/changelog.md): Every RepoOS release, with the notes that ship with it. ### Apps - [RepoOS Hub for Mac](https://docs.repoos.org/macos-hub.md): RepoOS Hub is a native macOS app for managing multiple RepoOS servers from one place — local projects on your machine and remote servers you can reach over HTTPS (for example, a… ### Help - [Troubleshooting](https://docs.repoos.org/troubleshooting.md): When a setup behaves unexpectedly — the server won't start, an agent never launches, repoos check has nothing to run — run repoos doctor first. ### Other - [Dev tooling](https://docs.repoos.org/dev-tooling.md): RepoOS ships a few features meant only for people hacking on RepoOS itself (or running it from a linked source checkout), not for production installs of the npm package. - [Engineering and review reports](https://docs.repoos.org/engineering-reports.md): RepoOS stores the history of one engineer → review loop side by side under work/reports/