Coding OS
Sign in
Browse docs▾

Installation

Coding OS is a Python CLI that sits on top of your existing agent. Installing it never replaces your agent — it scaffolds the rules, hooks, skills, and MCP server that give it memory and structure.

Requirements

  • Python 3.11 or newer
  • uv (the Python package manager) — or pipx
  • An AI coding agent: Claude Code or Codex (CLI)
  • Git — the board and graph live alongside your repo
  1. 1

    Install the CLI

    Install cos globally with uv. This is the only global install — everything else lives inside your project.
    $uv tool install coding-os

    Prefer pipx? pipx install coding-os works too. Verify with cos --version.

  2. 2

    Initialize your project

    Run cos init inside the repo you want to supercharge. It asks which agent and stack you use, then scaffolds rules, hooks, skills, and the docs system, and builds the first knowledge graph.
    $cos init

    Two adapters ship today: claude (Claude Code — full hook coverage) and codex (Codex CLI — Bash-event hooks). See Adapters & support for exactly what each runtime enforces.

    cos init also installs the git-level commit hooks, so the commit contract and validations fire even for direct commits by humans or agents without a hook runtime — no extra step.

  3. 3

    Restart your agent and verify

    Your agent picks up the MCP server and hooks on its next session. The status banner confirms the cognitive loop is live. Check health any time:
    $cos doctor

Next steps

  • Quickstart — the five-minute end-to-end tour.
  • How it works — the three brains and the loop your agent now follows.