mait.sh1.132.1

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

aidc workflows

Five everyday jobs with AIDC, from fixing a project's tool versions to briefing an agent, each with the steps and what to check.

Beta
Pin a tool

Pin a tool for the project

Your team builds on Node.js 22 and a new colleague, or a new container, must get exactly that release without asking anyone.

You runaidc install nodejs@22 from the project root, then aidc current nodejs.

Capturedaidc 3.16.7 · Ubuntu 26.04
Pin and read back
$ aidc install nodejs@22
[ok] Successfully installed nodejs 22.23.3
Source: vendor
[ok] Set nodejs 22.23.3 in /home/user/projects/example-app/.aidc.yaml
[ok] Activated nodejs 22.23.3
$ cat .aidc.yaml
install:
nodejs:
- 22.23.3
use:
nodejs: 22.23.3
Try a version

Try another version in one shell

You want to see whether the build still passes on Node.js 20, and you do not want to touch the file your team shares.

You runAIDC_AUTO_SET_USE=false aidc install nodejs@20 once, then aidc use nodejs 20 in the shell you are testing in.

Capturedaidc 3.16.7 · Ubuntu 26.04
A session-scoped choice
$ aidc list
nodejs
22.23.3 [active]
20.20.2
$ aidc use nodejs 20
Resolved pattern '20' to version 20.20.2
[ok] Using nodejs 20.20.2 (session-scoped)
This is temporary. Use 'aidc set nodejs 20.20.2' to persist.
Unattended setup

Prepare a project without anyone typing

A devcontainer, an image build or a CI job must end up with the project's tools and nobody to answer prompts.

You runaidc setup in the directory that holds .aidc.yaml, usually from postCreateCommand.

Capturedaidc 3.16.7 · Ubuntu 26.04
Setup from the manifest
$ cat .aidc.yaml
install:
nodejs:
- "22"
use:
nodejs: "22"
$ aidc setup
Installing 1 tools from .aidc.yaml...
[ok] Resolved nodejs 22 → 22.23.3
[skip] nodejs 22.23.3 is already installed
[ok] Activated nodejs 22.23.3
[ok] 1 tool installed successfully
Agent CLI

Add your agent CLI

The project allows Claude Code, and you want it in the container without a separate download page.

You runaidc install claude@latest, then claude.

Capturedaidc 3.16.7 · Ubuntu 26.04
Install an agent CLI
$ aidc install claude@latest
[ok] Resolved claude latest → 2.1.295
[ok] Successfully installed claude 2.1.295
Source: vendor
 
Available commands
claude
 
Environment
DISABLE_AUTOUPDATER: 1
[ok] Set claude 2.1.295 in /home/user/projects/example-app/.aidc.yaml
[ok] Activated claude 2.1.295
Brief an agent

Brief an agent on the toolchain

An agent in the project container keeps assuming a different Node.js than the one the project uses.

You runaidc prompt and give the agent its output, or let it run the command.

Capturedaidc 3.16.7 · Ubuntu 26.04
The start of the briefing
$ aidc prompt
# aidc toolchain briefing
 
## Active toolchain
- **resolved from**: /home/user/projects/example-app/.aidc.yaml
- **nodejs**: 20.20.2
 
## Tool detail
### nodejs
- **active version**: 20.20.2
- **installed versions**: 22.23.3, 20.20.2
- **exposed commands**: corepack, node, npm, npx
Next

Where to go next.