mait.sh1.132.1

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

aidcx workflows

Five things you do with AIDC Launch, from the first container to recovery after a reboot, each with the commands and what to check.

Beta
OverviewInstallWorkflowsOperateCustomizeInsideAll components
AIDC Launch (aidcx)

Run project commands and aidcx doctor in a Linux terminal. On macOS or Windows, prepare the runtime with native aidcx install, then open aidcx terminal and use a project cloned in that Linux environment. Native installation, update and uninstall remain host commands; macOS aidcx bridge also runs on the Mac.

First container

Launch your first container

You have a project you trust and a prepared host, and you want a shell in the project environment. A successful install message does not yet prove that.

You runaidcx scaffold if the project has no MAIT configuration, then aidcx start --trusted and aidcx shell.

Illustrative
Start and check
$ aidcx start --trusted
$ aidcx shell
$ pwd
$ ls
$ printf 'aidcx-shell-ready\n'
aidcx-shell-ready
Sign-ins

Share your sign-ins safely

Git, Docker or Kubernetes inside the container need the sign-ins you already have on your computer. You want to choose which ones the project can use.

You runaidcx scaffold --sso dev to save the choice for the project, or aidcx start --sso git,docker for one start. off turns sharing off.

Illustrative
Check sharing
$ aidcx health
$ aidcx exec -- git ls-remote origin

If plain git fails with could not read Username, check aidcx health and verify that the same account can read the origin outside the container. Follow the reported sharing remedy before retrying.

Worktrees

Give each task its own worktree

Two tasks, or two agents, need independent changes to the same repository.

You runaidcx start --branch feature-review, then aidcx list and aidcx exec --branch worktree/feature-review -- git branch --show-current.

Illustrative
Two worktrees
$ aidcx list
NAME ID BRANCH STATUS WT PATH GIT RUNTIME
... ... worktree/feature-review running yes .git/aidcx-worktrees/... clean ↑0 secure
Native display

Open a graphical application on your Mac

On an Apple Silicon Mac you want a graphical application from the container to open as a window on the Mac.

You runaidcx start --x11 on --gpu on, then aidcx shell and xterm.

Recovery

Recover after a reboot or a desktop change

A project that worked will not resume after a reboot, or graphical applications fail after you sign in to a different desktop.

You runaidcx version, aidcx list, aidcx doctor and aidcx relay status to capture the state, then aidcx start to resume.

Next

Where to go next.

  • Operate for the commands that show state and clean up
  • Customize for runtime options