# Install with your agent

Paste one prompt into your coding agent. It installs MiniCut, signs you in, checks every tool and loads the MiniCut skill.

## Requirements

| Requirement | Value |
|---|---|
| Computer | macOS, Linux or Windows, on ARM64 or x64 |
| Free disk | 5 GB |
| Network | An internet connection for the install and for sign-in |
| Agent app | One of the 11 coding agent apps MiniCut supports, such as Claude Code, Codex, Cursor, OpenCode, TRAE, Kimi Code or Qoder |

## Run the prompt

1. Open a new chat in your agent app.
2. Copy the prompt for your computer from Prompts below. If you are in China mainland, copy it from China mainland instead.
3. Paste it into the chat and send it.
4. When your agent shows an address and a code, open the address, sign in to minicut.ai, and confirm the code.
5. Wait for your agent's last message. It names what is installed, what is missing and why, and the address of the MiniCut app.

The install downloads a few GB and can take 30 minutes. Your agent asks for your computer password only if the computer needs it.

## Prompts

The prompt is the same in every agent app. On Windows, `minicut` in the prompt means the full path the install prints at the end of line 1.

```text macOS, Linux
Install Minicut on this computer (macOS or Linux), region Global. Run each line in the background and wait for it to finish.
1. curl -fsSL https://minicut.ai/install.sh | bash -s -- --region global   (a few GB, can take 30 minutes)
2. ~/.minicut/bin/minicut setup. It downloads the tools Minicut brings. If it says Python 3.12 or ffmpeg is missing, download it from its site (Python 3.12: https://www.python.org/downloads/, ffmpeg: https://ffmpeg.org/download.html), install it, then run ~/.minicut/bin/minicut setup again. Ask me for my password only if the computer needs it.
3. If you are Claude Code or Codex: ~/.minicut/bin/minicut agent-rules
4. ~/.minicut/bin/minicut login --device --lang en. Show me the address and code. Then run ~/.minicut/bin/minicut login --complete every 10 seconds until it says signed in, up to 15 minutes. Do not wait for me to say done.
5. ~/.minicut/bin/minicut doctor
6. Read SKILL.md in the miniharness-short-drama skill folder step 1 made, and use it in this chat. Do not ask me to restart.
7. ~/.minicut/bin/minicut. Tell me what is installed, what is missing and why, and the app address.
If a line fails, run it once more; if it fails again, tell me the error and stop. Download Python and ffmpeg only from the sites in step 2.
```

```text Windows PowerShell
Install Minicut on this computer (Windows PowerShell), region Global. Run each line in the background and wait for it to finish. From step 2 on, minicut means the full path of minicut the install printed at the end of step 1.
1. & ([scriptblock]::Create((irm https://minicut.ai/install.ps1))) -Region global   (a few GB, can take 30 minutes)
2. minicut setup. It downloads the tools Minicut brings. If it says Python 3.12 or ffmpeg is missing, download it from its site (Python 3.12: https://www.python.org/downloads/, ffmpeg: https://ffmpeg.org/download.html), install it, then run minicut setup again. Ask me for my password only if the computer needs it.
3. If you are Claude Code or Codex: minicut agent-rules
4. minicut login --device --lang en. Show me the address and code. Then run minicut login --complete every 10 seconds until it says signed in, up to 15 minutes. Do not wait for me to say done.
5. minicut doctor
6. Read SKILL.md in the miniharness-short-drama skill folder step 1 made, and use it in this chat. Do not ask me to restart.
7. minicut. Tell me what is installed, what is missing and why, and the app address.
If a line fails, run it once more; if it fails again, tell me the error and stop. Download Python and ffmpeg only from the sites in step 2.
```

```text Windows CMD
Install Minicut on this computer (Windows CMD), region Global. Run each line in the background and wait for it to finish. From step 2 on, minicut means the full path of minicut the install printed at the end of step 1.
1. curl -fsSL https://minicut.ai/install.cmd -o install.cmd && install.cmd -Region global && del install.cmd   (a few GB, can take 30 minutes)
2. minicut setup. It downloads the tools Minicut brings. If it says Python 3.12 or ffmpeg is missing, download it from its site (Python 3.12: https://www.python.org/downloads/, ffmpeg: https://ffmpeg.org/download.html), install it, then run minicut setup again. Ask me for my password only if the computer needs it.
3. If you are Claude Code or Codex: minicut agent-rules
4. minicut login --device --lang en. Show me the address and code. Then run minicut login --complete every 10 seconds until it says signed in, up to 15 minutes. Do not wait for me to say done.
5. minicut doctor
6. Read SKILL.md in the miniharness-short-drama skill folder step 1 made, and use it in this chat. Do not ask me to restart.
7. minicut. Tell me what is installed, what is missing and why, and the app address.
If a line fails, run it once more; if it fails again, tell me the error and stop. Download Python and ffmpeg only from the sites in step 2.
```

## China mainland

These prompts install from the China mainland region and name download sites that load there.

```text macOS, Linux
Install Minicut on this computer (macOS or Linux), region China mainland. Run each line in the background and wait for it to finish.
1. curl -fsSL https://minicut.ai/install.sh | bash -s -- --region cn   (a few GB, can take 30 minutes)
2. ~/.minicut/bin/minicut setup. It downloads the tools Minicut brings. If it says Python 3.12 or ffmpeg is missing, download it from its site (Python 3.12: https://registry.npmmirror.com/binary.html?path=python/3.12.10/, ffmpeg: https://registry.npmmirror.com/binary.html?path=ffmpeg-static/b6.1.1/), install it, then run ~/.minicut/bin/minicut setup again. Ask me for my password only if the computer needs it.
3. If you are Claude Code or Codex: ~/.minicut/bin/minicut agent-rules
4. ~/.minicut/bin/minicut login --device --lang en. Show me the address and code. Then run ~/.minicut/bin/minicut login --complete every 10 seconds until it says signed in, up to 15 minutes. Do not wait for me to say done.
5. ~/.minicut/bin/minicut doctor
6. Read SKILL.md in the miniharness-short-drama skill folder step 1 made, and use it in this chat. Do not ask me to restart.
7. ~/.minicut/bin/minicut. Tell me what is installed, what is missing and why, and the app address.
If a line fails, run it once more; if it fails again, tell me the error and stop. Download Python and ffmpeg only from the sites in step 2.
```

```text Windows PowerShell
Install Minicut on this computer (Windows PowerShell), region China mainland. Run each line in the background and wait for it to finish. From step 2 on, minicut means the full path of minicut the install printed at the end of step 1.
1. & ([scriptblock]::Create((irm https://minicut.ai/install.ps1))) -Region cn   (a few GB, can take 30 minutes)
2. minicut setup. It downloads the tools Minicut brings. If it says Python 3.12 or ffmpeg is missing, download it from its site (Python 3.12: https://registry.npmmirror.com/binary.html?path=python/3.12.10/, ffmpeg: https://registry.npmmirror.com/binary.html?path=ffmpeg-static/b6.1.1/), install it, then run minicut setup again. Ask me for my password only if the computer needs it.
3. If you are Claude Code or Codex: minicut agent-rules
4. minicut login --device --lang en. Show me the address and code. Then run minicut login --complete every 10 seconds until it says signed in, up to 15 minutes. Do not wait for me to say done.
5. minicut doctor
6. Read SKILL.md in the miniharness-short-drama skill folder step 1 made, and use it in this chat. Do not ask me to restart.
7. minicut. Tell me what is installed, what is missing and why, and the app address.
If a line fails, run it once more; if it fails again, tell me the error and stop. Download Python and ffmpeg only from the sites in step 2.
```

```text Windows CMD
Install Minicut on this computer (Windows CMD), region China mainland. Run each line in the background and wait for it to finish. From step 2 on, minicut means the full path of minicut the install printed at the end of step 1.
1. curl -fsSL https://minicut.ai/install.cmd -o install.cmd && install.cmd -Region cn && del install.cmd   (a few GB, can take 30 minutes)
2. minicut setup. It downloads the tools Minicut brings. If it says Python 3.12 or ffmpeg is missing, download it from its site (Python 3.12: https://registry.npmmirror.com/binary.html?path=python/3.12.10/, ffmpeg: https://registry.npmmirror.com/binary.html?path=ffmpeg-static/b6.1.1/), install it, then run minicut setup again. Ask me for my password only if the computer needs it.
3. If you are Claude Code or Codex: minicut agent-rules
4. minicut login --device --lang en. Show me the address and code. Then run minicut login --complete every 10 seconds until it says signed in, up to 15 minutes. Do not wait for me to say done.
5. minicut doctor
6. Read SKILL.md in the miniharness-short-drama skill folder step 1 made, and use it in this chat. Do not ask me to restart.
7. minicut. Tell me what is installed, what is missing and why, and the app address.
If a line fails, run it once more; if it fails again, tell me the error and stop. Download Python and ffmpeg only from the sites in step 2.
```

## Each line of the prompt

1. Line 1 downloads MiniCut and adds the MiniCut skill to every agent app it finds.
2. Line 2 runs `minicut setup`, which downloads the tools MiniCut brings. Your agent downloads Python 3.12 or ffmpeg from the sites in the prompt only if setup says they are missing.
3. Line 3 runs `minicut agent-rules` in Claude Code or Codex. It writes that app's allow and ask-first rules for MiniCut commands.
4. Line 4 signs this computer in with a code you confirm on minicut.ai.
5. Line 5 runs `minicut doctor`, which lists every tool, its version and where it is.
6. Line 6 loads the MiniCut skill into the chat you are in, so you do not restart the app.
7. Line 7 runs `minicut`, which opens the MiniCut app in your browser.

## Errors

| Message or state | What to do |
|---|---|
| Your agent says a line failed twice and stops | Read the error it shows. Fix what it names, then send the prompt again. |
| `minicut setup` says Python 3.12 or ffmpeg is missing | Your agent downloads it from the site in line 2 and runs setup again. If it cannot, install it from that site yourself. |
| The code expired before you confirmed it | Ask your agent to run line 4 again. A code lasts 15 minutes. |
| `You are not signed in. Ask your agent to run minicut login.` | Sign-in did not finish. Ask your agent to run line 4 again. |

## Check it worked

Ask your agent to run `minicut status`. A signed-in computer shows the account it is signed in as, where its key is kept and the CLI version.

## Next

[Quickstart](/docs/cli/quickstart) [Install in a terminal](/docs/cli/install-in-a-terminal) [Overview](/docs/cli/overview)