Installation

matic runs as a CLI and background daemon on your local machine, coordinating agent runtimes through a git-native filesystem. This section covers the full installation flow: checking system prerequisites, installing the CLI, configuring at least one supported agent runtime, and verifying that the local daemon can talk to it. Most users can go from zero to a working setup in under five minutes.

Prerequisites

System-level requirements for Bun, Git, and OS compatibility before installing the CLI. See Prerequisites.

Install the CLI

Install the matic binary using a package manager or the standalone install script. See Install the CLI.

Agent Runtime Prerequisites

matic delegates inference to external runtimes such as Claude Code, Codex, or Gemini CLI, so you need at least one runtime installed and authenticated. See Agent Runtime Prerequisites.

Verify Installation

Run diagnostic commands to confirm the CLI, daemon, and agent runtime connectivity are working correctly. See Verify Installation.

Upgrade and Uninstall

Update matic to newer versions, handle upgrade-related changes, and remove it cleanly if needed. See Upgrade and Uninstall.