Docs / Resources
Troubleshooting
The messages the minicut command prints, what each one means, and what to do. Exit codes are on Global options.
Find the message you see in the first column. Text in capitals, such as PATH, stands for a value that changes. Every exit code is explained on Global options.
| What you see | Exit code | Cause | What to do |
|---|---|---|---|
You are not signed in. Ask your agent to run minicut login. | 10 | This computer has no sign-in | Run minicut login. With no browser on the computer, see Sign in without a browser |
This computer was signed out on minicut.ai. | 10 | The sign-in was removed on minicut.ai | Run minicut login |
Sign-in was cancelled on minicut.ai. | 10 | The sign-in was cancelled on minicut.ai | Run minicut login again and confirm on minicut.ai |
This sign-in code expired. Run minicut login again. | 10 | The code lasts 15 minutes, or no code is waiting on this computer | Run minicut login --device for a new code, then minicut login --complete on the same computer |
Waiting for you to confirm on minicut.ai. | 0 | You have not confirmed the code yet | Confirm the code, then run minicut login --complete again |
Could not reach minicut.ai. or minicut.ai did not answer in time. | 7 | No internet connection, a proxy that blocks it, or a slow connection | Connect to the internet, then run the same command again. For a proxy, see Use MiniCut in China mainland |
Could not reach minicut.ai, and this computer's sign-in was last confirmed N days ago. Connect to the internet, then run the same command again. | 7 | The computer has been offline for more than 7 days | Connect to the internet, then run the same command again |
Offline: minicut.ai was last reached N days ago. Minicut keeps working offline for M more days. | Not changed | The computer is offline. The note goes to stderr | Connect to the internet within M days |
This Minicut is too old. Run minicut update, then the same command again. | 12 | The installed version is too old for this command | Run minicut update, then the same command. See Update and uninstall |
Another Minicut update is running on this computer. Run minicut update again when it has finished. | 75 | An update is already running | Wait for it to finish, then run minicut update again |
Too many requests. Try again in N seconds. | 8 | Too many requests in a short time | Wait N seconds, then run the same command again |
Something went wrong on our side. Try again. | 8 | A fault on our side | Run the same command again. If it fails again, wait a few minutes. Quote the Request id: line if you contact us |
This account reached today's limit. It resets at TIME. | 8 | The account reached its limit for today | Run the command again after TIME |
This model is not available right now. Try again later. | 8 | The model is not taking requests | Run the same command later, or pick another model with minicut models |
Nothing was sent. with a line to run after you agree | 3 | The command uses credits. It shows what it will do and asks before it spends | Run the printed line if you agree |
Pick a model. Run minicut models to see them, then pass --model. | 5 | The command needs a model name | Run minicut models, then add --model NAME |
No model named NAME. Nothing was sent. The list: minicut models. | 5 | The model name is not in the list | Use a name from minicut models |
FIELD on this model is RANGE. You asked for VALUE. | 5 | The value is outside what the model takes | Change the value to one inside RANGE |
Minicut is not fully installed: PATH is missing. Run the install line again. | 2 | A file of the install is missing | Run the install line again. See Install in a terminal |
the folder FOLDER already holds files that are not Minicut's (FILES), so Minicut will not install into it. Set MINICUT_HOME to a new folder, or empty this one. | 1 | The install folder has files MiniCut did not make | Set MINICUT_HOME to a new folder, or empty this one |
Port 7311 is used by another program. Set MINICUT_PORT to a free port, then run minicut again. | 2 | Another program uses the port of the MiniCut app | Set MINICUT_PORT to a free port, then run minicut again |
The Minicut app did not start. | 2 | The MiniCut app did not answer after it was started | Run minicut doctor, then run minicut again |
REFUSED: under 5 GB free. Free some space and run again. | 3 | Setup needs 5 GB of free disk | Free disk space, then run minicut setup again |
MISSING: Python 3.12. Download it from SITE and install it ..., then run minicut setup again. or the same line for ffmpeg | 4 | Setup does not bring Python 3.12 or ffmpeg | Install it from SITE, then run minicut setup again |
FAILED TOOL: REASON | 1 | A download for one tool failed | Run minicut setup again. In China mainland, add --china |
A line starting 这一行需要你自己运行： followed by a command | 2 | This program cannot write to that folder, for example an agent's sandbox | Run that command in your own terminal |
No project NAME in PATH. | 2 | The folder has no project with that id | Use the id from minicut new |
Not a project id: NAME. Use the id from minicut new (letters, digits and -). | 2 | The project id has other characters | Use letters, digits and - |
unknown app "NAME". Apps: followed by a list | 2 | --app got a name that is not in the list | Use an id from the list |
PATH already exists. Add --force to copy the pack over it. | 2 | The skill folder is already there | Add --force |
a proxy is http://host:port, got VALUE or Invalid URL | 5 | The proxy address is wrong, or missing after --proxy | Use the form http://HOST:PORT |
代理 HOST 连不上，已直接连接；运行 minicut network --direct 可以不再用它 | Not changed | The saved proxy refused the connection, so the command connected directly | Fix the proxy, or run minicut network --direct to stop using it |
FOLDER has no Minicut install marker (minicut-home.json), so it may hold files that are not Minicut's. Nothing was removed. | 1 | The uninstall found no MiniCut install in that folder | Check that MINICUT_HOME points at your MiniCut home folder |
minicut: ERROR | 1 | The command stopped on an error it did not expect | Run the command again. If it fails again, contact us with the line |