mait.sh1.69.2

Private beta: features and content may change. No warranty; use at your own risk.

Docs / Launcher and command-line tools

AIDC Launch, the workspace launcher

AIDC Launch prepares your computer, then starts, enters, checks and stops a workspace for your project.

Preparing your computer and starting a project are separate steps, and each has its own check.

It runs on Linux, on macOS with Apple silicon and on Windows with WSL2.

Basics
Your first workspace

What AIDC Launch does

AIDC Launch is the command you run on your own computer. It reads your project's workspace definition, starts a container for it, and gives you a shell inside. You then run the coding agent you chose in that shell.

You start your agent in that shell and sign in to its model account there. What AIDC Launch gives you is a repeatable way to open the project, with the access it asks for written in the project definition you review.

How a workspace comes together

Three things meet when a workspace starts:

  • A reviewed project definition. Reuse the project's devcontainer configuration, or let AIDC Launch create one and review it.
  • A prepared computer. AIDC Launch installs the container runtime it needs once, and tells you when something is missing.
  • Your MAIT sign-in. aidcx login activates MAIT access for starting workspaces.

Your first result is simple and easy to check: a shell in the intended project, where a small command works.

What runs where

PlaceWhat you useWhat to check
Your computerAIDC Launch and the container runtime it preparedaidcx doctor reports no errors
The workspaceYour project files, dev tools and your agentThe shell shows the intended files
Your agent's modelThe model account you set up for that agentThe agent answers, separately from MAIT
Agent toolsA repository, a browser, a container engine or another targetThe agent can reach the intended target, with the access you meant to give
Place
Your computer
What you use
AIDC Launch and the container runtime it prepared
What to check
aidcx doctor reports no errors
Place
The workspace
What you use
Your project files, dev tools and your agent
What to check
The shell shows the intended files
Place
Your agent's model
What you use
The model account you set up for that agent
What to check
The agent answers, separately from MAIT
Place
Agent tools
What you use
A repository, a browser, a container engine or another target
What to check
The agent can reach the intended target, with the access you meant to give

What you can do with it

  • Start, stop, enter and delete a workspace for a project.
  • Work on several branches at once, each with its own checkout and its own workspace.
  • Ask for more of your computer, such as the display, the GPU, sound, USB devices or Docker. Each is a setting you choose, resolved for your computer.
  • Use the secure runtime, which isolates the workspace more strongly and is on by default.
  • Check what happened: doctor for your computer, inspect for a workspace's settings, health for its resources, logs for its start.

What you getOne command that opens your project from the same definition each time (pin the full version to match machines), on Linux, macOS with Apple silicon, or Windows with WSL2.

In this section

BasicsWhat it is and your first result

Your first workspace
Install AIDC Launch, prepare your computer, sign in, and open a shell in your project workspace.

Everyday useCommon tasks, step by step

Everyday tasks
Daily start and stop, parallel branches, checking what a workspace got, cleaning up, and sharing a customized environment.

AdvancedSettings and full reference

Workspace settings
Choose what the workspace can use from your computer, how sign-in sharing works, and where your own defaults live.
Command reference
Every AIDC Launch command, grouped by what you use it for, with its main options.

HelpWhen something goes wrong

Problems and fixes
Start from what you see, run the least invasive check, and fix the step that failed.