# Open in Prized

> A link and README badge that opens a public GitHub repository on a Prized box, cloned into ~/code, with Claude Code or Codex started in it.

URL: https://prized.dev/docs/open-in-prized
Updated: 2026-10-30

## 1. Add the badge to your README [#1-add-the-badge-to-your-readme]

Replace `OWNER/NAME` with your repository:

```markdown
[![Open in Prized](https://prized.dev/open-in-prized.svg)](https://prized.dev/open/github.com/OWNER/NAME)
```

It shows as [![Open in Prized](https://prized.dev/open-in-prized.svg)](https://prized.dev/docs/open-in-prized)

## 2. What a click does [#2-what-a-click-does]

1. The visitor signs in, or signs up. A new workspace gets [$30 of free credit](https://prized.dev/docs/billing#free-credit), and the tour starts a box on it.
2. A new workspace opens the repository from the tour's **Open NAME in your browser**. Anyone else picks one of their boxes, with Claude Code or Codex.
3. The box's [browser terminal](https://prized.dev/docs/dashboard) clones the repository into `~/code/NAME` and starts the agent there. The agent asks for its own sign-in the first time.

## Link forms [#link-forms]

| Link | Opens |
| --- | --- |
| `https://prized.dev/open/github.com/OWNER/NAME` | The repository |
| `https://prized.dev/open/https://github.com/OWNER/NAME/tree/main` | The same repository: a path inside it is ignored, and the default branch is cloned |
| `https://prized.dev/#https://github.com/OWNER/NAME` | Gitpod's form, so an Open in Gitpod link works with `gitpod.io` replaced by `prized.dev`. Replace its image with `https://prized.dev/open-in-prized.svg` too |

## Good to know [#good-to-know]

* Only public GitHub repositories clone this way. A private one fails with a line saying so, and the terminal opens a shell instead of the agent. On a box where you have run `gh auth login` and `gh auth setup-git`, your private repositories clone too.
* If `~/code/NAME` already holds a clone of the repository, it opens as it is, without a pull. If it holds something else, the clone goes to `~/code/OWNER-NAME`.
* Opening the same link again returns to the terminal it opened, with the agent still running.
* Prized does not run `.gitpod.yml` or build a `devcontainer.json` by itself: see [Moving from Ona (Gitpod)](https://prized.dev/docs/moving-from-ona).