| 1 | # Prompt links |
| 2 | |
| 3 | A prompt link opens T3 Code with a prompt ready to send. Use one to share a prompt on social |
| 4 | media, or to put a one-click fix in a pull request comment. |
| 5 | |
| 6 | A link never runs anything. It opens a draft. You read the prompt, then press Send. A link cannot |
| 7 | change your permission mode, branch, or worktree. Your own defaults apply. |
| 8 | |
| 9 | ## Make a link |
| 10 | |
| 11 | Open the command palette and choose **Copy prompt link**. It copies the draft in the composer. |
| 12 | When the project is on GitHub, **Copy prompt link with repo and model** also adds the repository |
| 13 | and the model you picked. Sent messages have a **Copy prompt link** button too. |
| 14 | |
| 15 | You can also write a link by hand: |
| 16 | |
| 17 | ``` |
| 18 | https://app.t3.codes/new?prompt=Rate%20my%20swearing |
| 19 | https://app.t3.codes/new?prompt=Fix%20the%20build&repo=owner/name&provider=codex&model=gpt-5.5 |
| 20 | https://app.t3.codes/new?pr=owner/name/123&prompt=Fix%20the%20failing%20check |
| 21 | ``` |
| 22 | |
| 23 | | Parameter | Meaning | |
| 24 | | ---------- | ----------------------------------------------------------------------------- | |
| 25 | | `prompt` | The prompt. Required, except on pull request links. At most 8,000 characters. | |
| 26 | | `repo` | A GitHub repository, as `owner/name` or its URL. | |
| 27 | | `provider` | A provider such as `codex` or `claude`. | |
| 28 | | `model` | A model of that provider, by its id or name. | |
| 29 | | `pr` | A GitHub pull request, as `owner/name/123` or its URL. | |
| 30 | |
| 31 | Encode the prompt for a URL. In JavaScript, use `encodeURIComponent`. |
| 32 | |
| 33 | ## Open a link |
| 34 | |
| 35 | On app.t3.codes, the link first asks where to open it: the desktop or mobile app, this browser |
| 36 | when it is connected to a machine, or the download page. Select **Remember my choice** to skip |
| 37 | this step next time. |
| 38 | |
| 39 | - **No `repo`**: the draft opens without a project, on the machine you used last. |
| 40 | - **`repo`**: the draft opens in your most recently used project for that repository. A fork |
| 41 | counts only for its own owner. When you do not have the repository, choose **Clone** or **Use |
| 42 | without project**. |
| 43 | - **`provider` and `model`**: used when you have that provider set up. Otherwise your default |
| 44 | model is used, and T3 Code tells you. |
| 45 | - **`pr`**: opens the thread linked to that pull request on any connected machine, with the prompt |
| 46 | in its composer. When no thread is linked, the draft goes on the pull request branch in a new |
| 47 | worktree. T3 Code checks the code out only after you confirm, because the checkout runs your |
| 48 | setup script on it. |
| 49 | |
| 50 | A thread link with a prompt, such as `https://app.t3.codes/<environment>/<thread>?prompt=…`, |
| 51 | puts the prompt in that thread's composer. If you already typed a draft there, T3 Code asks |
| 52 | before it replaces it. |
| 53 | |
| 54 | T3 Code removes characters you cannot see, such as zero-width and hidden tag characters, because |
| 55 | they can hide instructions for the agent. When a prompt had them, T3 Code warns you that it may be |
| 56 | malicious. |