Docs / Get started

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

Open a new chat in your agent app.
Copy the prompt for your computer from Prompts below. If you are in China mainland, copy it from China mainland instead.
Paste it into the chat and send it.
When your agent shows an address and a code, open the address, sign in to minicut.ai, and confirm the code.
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.

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.

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.

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.

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.

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.

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

Line 1 downloads MiniCut and adds the MiniCut skill to every agent app it finds.
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.
Line 3 runs minicut agent-rules in Claude Code or Codex. It writes that app's allow and ask-first rules for MiniCut commands.
Line 4 signs this computer in with a code you confirm on minicut.ai.
Line 5 runs minicut doctor, which lists every tool, its version and where it is.
Line 6 loads the MiniCut skill into the chat you are in, so you do not restart the app.
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.

Quickstart Install in a terminal Overview