---
title: Add a repo to a run
description: Clone a registry repo or a GitHub repository into a folder of the current agent run.
cli_command: "wiblo repos add <repo>"
canonical_url: https://wiblo.app/docs/developers/cli/repos/repos-add
last_updated: 2026-07-28T17:12:38+02:00
md_url: https://wiblo.app/docs/developers/cli/repos/repos-add.md
---

# Add a repo to a run

`$ wiblo repos add <repo>`

## Usage

```bash
wiblo repos add rep_01J9...           # a workspace registry repo, by id
wiblo repos add acme/website          # a GitHub repo, owner/name
wiblo repos add https://github.com/acme/website
```

```text
$ wiblo repos add acme/website --folder website
✓ Cloned into website (branch main @ 4f2a9c1) in 2381ms
```

## Arguments & flags

| | Description |
| --- | --- |
| `repo` (argument) | What to clone: a Wiblo repo id, `owner/repo`, or a GitHub URL. Required. |
| `--folder` | Folder name inside the run. Defaults to the repo name. `main` is reserved. |
| `--ref` | Branch or ref to check out. |
| `--run` | Agent run id (default `WIBLO_RUN_ID`). |
| `--json` | Print `{ "repo": { "folder", "branch", "commit" }, "cloneMs" }`. |

## Behaviour

- A folder that already exists answers `409 REPO_FOLDER_EXISTS`.
- GitHub clones use the workspace's connected GitHub credentials; private repos the connection cannot see fail the clone.