---
title: garage
description: Agent-native git hosting with a CLI, SDK, and typed API.
---

garage is **agent-native git hosting** with a command line, a JavaScript SDK,
and a typed HTTP API.

The product surface is familiar: organizations, repositories, branches,
commits, tree reads, blob reads, and scoped tokens. The machine interface is
the primary surface: commands return structured output with `--json`, the SDK
commits files without cloning, and the API contract is shared across the
server and clients.

## Why garage

  - Agent-native API: Typed RPC procedures cover repos, orgs, members, keys, tokens, and git reads or writes.
  - CLI-first workflow: Sign in, create repos, clone, inspect git data, and mint scoped tokens from one command.
  - SDK commits: Use @thegarage/sdk to stage files in memory and commit them through the API, including anonymous ephemeral repos.

## Quick start

```bash
# 1. Install the CLI
npm i -g @thegarage/cli

# 2. Authenticate
garage init

# 3. Create your first repo
garage repos create hello-world

# 4. Clone it
garage git clone hello-world
```

## Next up

  - [Getting started](/docs/getting-started): Install the CLI, sign in, and create your first repo.
  - [For agents](/docs/agents): Install the canonical SKILL.md and wire garage into your coding agent.
  - [Extensions](/docs/extensions): Run per-repo TypeScript in the forge — capability-gated, with scoped storage, records, and triggers.
  - [CLI reference](/docs/cli): Command groups, flags, and environment variables.
  - [Git SDK](/docs/sdk): Commit from any JavaScript runtime — no clone required.