> ## Documentation Index
> Fetch the complete documentation index at: https://docs.studiograph.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI overview

> Install the studiograph command-line tool and get a workspace running in three commands.

The `studiograph` command-line tool creates and serves workspaces, syncs a local checkout with a server, and handles administration and integrations.

## Install

```bash theme={null}
npm install -g @studiograph/server
```

The npm package is `@studiograph/server`; the command it installs is `studiograph`. It requires Node.js 22.19 or later and Git.

## Quickstart

```bash theme={null}
studiograph init "My Studio"
cd my-studio
studiograph serve
```

`init` creates a workspace — a single Git repository with a `.studiograph/` config directory. `serve` starts the server on port 8000 and opens the web UI; the first visit shows a setup page where you create the owner account.

## Command groups

| Group            | Commands                                                                                                                                 |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Workspace basics | `init`, `clone`, `serve`                                                                                                                 |
| Sync             | `pull`, `push`, `commit`                                                                                                                 |
| Admin            | `admin token`, `admin user`, `admin folder`, `admin secrets`, `admin settings`, `admin audit`, `admin backup`, `admin restore`, and more |
| Integrations     | `mcp`, `connector`, `r2`                                                                                                                 |
| Maintenance      | `index`, `lint`, `orphans`, `repair-folders`, `reset`                                                                                    |

<Note>
  The `user`, `folder`, `secrets`, `settings`, and `audit` commands moved under `admin` (for example, `studiograph admin user add`). The old top-level forms still run but print a deprecation warning and will be removed in a future release.
</Note>

## Where next

<Columns cols={2}>
  <Card title="Commands" href="/cli/commands">
    Reference for every command and its flags.
  </Card>

  <Card title="Sync & local checkouts" href="/cli/sync">
    Clone a hosted workspace and move content with pull and push.
  </Card>

  <Card title="Connect AI tools (MCP)" href="/cli/mcp">
    Point Claude Code, Claude Desktop, or Cursor at your workspace.
  </Card>

  <Card title="Self-hosting" href="/self-hosting/overview">
    Run Studiograph on your own server, Docker, or Railway.
  </Card>
</Columns>