Run project operations in a Linux terminal. On native Linux, use your normal terminal. On macOS or Windows, complete host installation and login, then run bare aidcx to open the MAIT Linux terminal. Open your project folder there before using start, shell, list, stop or delete. Commands for the project's tools and tests run inside the project shell.
Open my project and start my agent
You have a project and want your coding agent to work on it inside a prepared environment.
You runaidcx start --trusted, then aidcx shell, then your agent's command.
Run my tests without installing anything
The project's tests need Node.js 22, and you do not want it on your own computer.
You runaidc install nodejs@22, then your project's usual test command.
Keep two tasks apart
You are fixing a bug while an agent builds a feature in the same repository.
You runaidcx start --branch feature-review, then aidcx list.
Try a risky change and throw it away
You want to let an agent try a big change and might not keep it.
You runWork in the workspace, then aidcx delete --keep-volumes when you are done.
Give a teammate the same environment
A teammate joins on Monday and needs your exact setup.
You runCommit the project's MAIT configuration, which names the image release. Your teammate clones the project and runs aidcx start --trusted.
See which tools are inside
You want to know what the workspace already contains.
You runcat /etc/mait/image/bundle-manifest.json
Update to a newer release
A newer image is out and you want your project on it.
You runIn the project's configuration, change the image release and the matching tools release together, then recreate the workspace.
Fix "my agent cannot reach my files"
The agent says a project file is missing or cannot be written.
You runid in the workspace and on your computer, and compare the numbers.