Your first AIDC Launch workspace

You need a project you are allowed to work on and a computer running Linux, macOS on Apple silicon, or Windows with WSL2. Linux is Beta; macOS and Windows are Alpha. To attach VS Code you also need VS Code with its Dev Containers extension.

On macOS, the workspace can share your clipboard. Before you start, replace anything confidential on your clipboard with harmless text.

On Linux or macOS:

On Windows, in PowerShell:

Open a new terminal if the command is not found yet, then check:

A version line means AIDC Launch runs; the next step prepares your computer.

The installer checks the launcher download's signature against a key built into it. If the signature is missing or wrong, installation stops and reports what to fix. A mirror must serve files signed with the same key.

See what is missing, and what AIDC Launch would install, before changing anything:

On a new computer a missing runtime and a missing sign-in are expected. When you are ready:

Run AIDC Launch as yourself and let it ask for administrator rights step by step; do not put sudo in front of it. If doctor still reports something missing, follow what it says before you continue.

Open the address it prints and enter the code shown for your computer; never reuse a code from an example. Starting a workspace needs this sign-in; your agent's model account has its own sign-in.

In the project directory, reuse the project's workspace definition if it has one. Otherwise let AIDC Launch create it:

Review what it wrote, especially access to your computer and sign-in sharing, which is on by default and lets the workspace use your Git, Docker, Kubernetes and AI tool sign-ins. Turn off what you do not need, for example with aidcx scaffold --sso off.

The first start asks you to trust this project, once. Give that trust only to a project you reviewed:

Inside the shell, check that you are where you meant to be:

You should see your project files.

Start the coding agent you use inside this shell. If it is not there yet, install a supported one with the dev-tool manager. Complete the agent's own sign-in and review its permission choices.

For a first request, ask the agent to summarize one document you know, without changing files, and compare its answer with the document. Type exit to leave the shell; the workspace keeps running. Run aidcx stop from the project directory on your computer when you are done.