Find the version in use and where it lives.
| Command | Use it to | What it reports |
|---|---|---|
aidc list [TOOL] | See installed releases | Each installed release, with [active] on the one your shell runs. --hub and --vendor list what a source offers instead |
aidc current [TOOL] | Read the project's choice | The selection in the nearest .aidc.yaml. It ignores a temporary aidc use |
aidc which TOOL | Find the executable | The full path of the tool's command |
aidc where TOOL | Find the install directory | The directory of the active release |
aidc describe TOOL | Get one tool's picture | Installed versions, install path and the commands it provides |
aidc latest TOOL | Check what is newest | The newest stable release from the sources |
One report for the shell, the data, the sources and the credentials.
aidc doctor checks shell integration, the data directory, installed tools, project configuration, package sources, credentials, updates and connectivity. --detailed shows every check.
Exit status is 0 when every check passes or only warns, and 1 when an error-level check fails. Read the findings, not only the status. Ignore the aidc env --init wording in the shell-integration hint above; run aidc env setup bash instead, which is the command that writes the integration.
Keep the installed set tidy, with a preview first.
| Command | What it does | Keep in mind |
|---|---|---|
aidc upgrade [TOOL] | Installs a newer release, moves global packages across, activates it and removes the old one | Needs the cli:upgrade feature, even with --dry-run. --keep keeps the old release |
aidc prune | Removes older releases that neither the nearest .aidc.yaml nor this shell selects | Needs the cli:prune feature, even with --dry-run. Another project outside the directories it checks may still need a release |
Without the feature, both stop with a message that names the missing credential and exit 1; sign in with aidc login.
Update the program, then clean up.
aidc update checks the MAIT update service with your credentials and stages a newer aidc. The next aidc command you run, including aidc version, switches to the downloaded release before it runs, so aidc version then reports the newer release; if aidc cannot switch, see the update entry in Troubleshooting. In a project container the usual path is a newer MAIT image instead (see Getting Started).
aidc uninstall TOOL VERSION removes one release and, if it was the active one, activates the highest remaining; aidc uninstall --all removes every installed tool version. It does not edit any project .aidc.yaml or change your shell's current selections, so they can still name tools that are gone; review them and edit or delete them yourself. AIDC has no command that removes its shell integration: delete the marked block from .profile, .bashrc or the file for your shell by hand. The block starts with # --- AIDC Integration begin ---; see Getting Started. Packages added with aidc install apt stay until you remove them with the system package manager.