---
title: Link a checkout
description: Wire a checkout you cloned by URL, or moved from another machine, so git pushes through your Wiblo login.
cli_command: wiblo repos link
canonical_url: https://wiblo.app/docs/developers/cli/repos/repos-link
last_updated: 2026-09-16T23:10:24+02:00
md_url: https://wiblo.app/docs/developers/cli/repos/repos-link.md
---

# Link a checkout

`$ wiblo repos link`

## Usage

```bash
cd main-site
wiblo repos link
```

```text
$ wiblo repos link
> Linked /home/ava/main-site to Main site. Plain git now pushes through your Wiblo login.
```

## Flags

<table>
  <thead>
    <tr><th>Flag</th><th>Description</th></tr>
  </thead>
  <tbody>
    <tr><td><code>--workspace</code></td><td>Workspace slug or id. Defaults to <code>WIBLO_WORKSPACE</code>, then the active workspace.</td></tr>
    <tr><td><code>--json</code></td><td>Print the envelope: <code>checkout_linked</code> with <code>root</code>, <code>repo</code>, and <code>workspaceId</code>.</td></tr>
  </tbody>
</table>

## Behaviour

- Run it inside the checkout. The origin remote is matched against the workspace's repos; a remote that is not one of them answers `repo_not_found`.
- It writes the same wiring [`wiblo repos clone`](/docs/developers/cli/repos/repos-clone) writes: the workspace and repo ids, and the credential helper for this remote. Running it twice changes nothing.
- A folder that is not a git checkout answers `validation_failed`.
- If git cannot find the credential helper, nothing is written and the answer is `helper_not_installed`. The helper installs with the CLI, so reinstall the CLI and run the command again.