# Use Codeclip directly

Three steps take you from a local repository to a narrated explanation. You don’t need Rust, Node, or model provider keys.

## Install

```sh
brew install sidhantchadda/codeclip/codeclip
```

Supports macOS Apple silicon and Linux ARM64. Update with `brew upgrade codeclip`. Intel/AMD and Windows builds are not available yet. macOS builds are not yet notarized.

## Sign in

```sh
codeclip login
```

Complete sign-in in your browser. Use the same Codeclip account as your video library.

## Create a clip

```sh
codeclip generate /path/to/repository \
  --prompt "How does this queue handle retries?" \
  --wait
```

Codeclip investigates the local repository, uploads a technical report, and generates the video in the cloud. The CLI prints a tracking link immediately after reserving the run.

Keep the terminal open until the report uploads. `--wait` follows cloud generation until completion. Without it, the command exits after handoff and the cloud continues working.

## Other installation options

Without Homebrew:

```sh
curl -fsSL https://trycodeclip.com/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"
```

Or download the [macOS Apple silicon archive](/downloads/codeclip-macos-arm64.tar.gz) or [Linux ARM64 archive](/downloads/codeclip-linux-arm64.tar.gz). Verify downloads against [SHA256 checksums](/downloads/SHA256SUMS).

## Using a coding agent?

[Install the agent skill](/docs/agent-setup) so your agent can write briefs and run Codeclip for you.