Skip to content

Agents, plugins and images

Install and manage local agents, plugins, marketplaces and images.

These commands manage what the harness runs locally. They work signed out and print text, not the JSON contract. Where a command takes a confirmation or a choice, pass its flags to avoid a prompt.

Generated from dexto 2.0.0-beta.0.

dexto create-image

Alias for `dexto image create`

dexto create-image [name]

A local command: it does not follow the JSON and exit-code contract.

dexto image create

Create a Dexto image project (scaffold)

dexto image create [name]

A local command: it does not follow the JSON and exit-code contract.

dexto image install

Install an image into the local Dexto image store

dexto image install <image>

Examples

dexto image install @dexto/image-local
dexto image install @myorg/my-image@1.2.3
dexto image install ./my-image-1.0.0.tgz
Option What it does
--force Force reinstall if already installed
--no-activate Do not set as the active version

A local command: it does not follow the JSON and exit-code contract.

dexto image list

List installed images

dexto image list

A local command: it does not follow the JSON and exit-code contract.

dexto image use

Set the active version for an installed image (image@version)

dexto image use <image>

A local command: it does not follow the JSON and exit-code contract.

dexto image remove

Remove an image from the store (image or image@version)

dexto image remove <image>

A local command: it does not follow the JSON and exit-code contract.

dexto image doctor

Print image store diagnostics

dexto image doctor

A local command: it does not follow the JSON and exit-code contract.

dexto agents install

Install agents from registry or custom YAML files/directories

dexto agents install [agents...]

Examples

dexto agents install coding-agent
dexto agents install agent1 agent2
dexto agents install --all
dexto agents install ./my-agent.yml
dexto agents install ./my-agent-dir/
Option What it does
--all Install all available agents from registry
--force Force reinstall even if agent is already installed

A local command: it does not follow the JSON and exit-code contract.

dexto agents uninstall

Uninstall agents from the local installation

dexto agents uninstall [agents...]
Option What it does
--all Uninstall all installed agents
--force Force uninstall even if agent is protected (e.g., coding-agent)

A local command: it does not follow the JSON and exit-code contract.

dexto agents list

List available and installed agents

dexto agents list
Option What it does
--verbose Show detailed agent information
--installed Show only installed agents
--available Show only available agents

A local command: it does not follow the JSON and exit-code contract.

dexto agents sync

Sync installed agents with bundled versions

dexto agents sync
Option What it does
--list List agent status without updating
--force Update all agents without prompting

A local command: it does not follow the JSON and exit-code contract.

dexto which

Show the path to an agent

dexto which <agent>

A local command: it does not follow the JSON and exit-code contract.

dexto plugin list

List installed plugins

dexto plugin list
Option What it does
--verbose Show detailed plugin information

A local command: it does not follow the JSON and exit-code contract.

dexto plugin install

Install a plugin from a local directory

dexto plugin install
Option What it does
--path <path> Path to the plugin directory
--scope <scope> Installation scope: user, project, or local (default: "user")
--force Force overwrite if already installed

A local command: it does not follow the JSON and exit-code contract.

dexto plugin uninstall

Uninstall a plugin by name

dexto plugin uninstall <name>

A local command: it does not follow the JSON and exit-code contract.

dexto plugin validate

Validate a plugin directory structure

dexto plugin validate [path]

A local command: it does not follow the JSON and exit-code contract.

dexto plugin marketplace add

Add a marketplace (GitHub: owner/repo, git URL, or local path)

dexto plugin marketplace add <source>
Option What it does
--name <name> Custom name for the marketplace

A local command: it does not follow the JSON and exit-code contract.

dexto plugin marketplace list

List registered marketplaces

dexto plugin marketplace list
Option What it does
--verbose Show detailed marketplace information

A local command: it does not follow the JSON and exit-code contract.

dexto plugin marketplace remove

Remove a registered marketplace

dexto plugin marketplace remove|rm <name>

A local command: it does not follow the JSON and exit-code contract.

dexto plugin marketplace update

Update marketplace(s) from remote (git pull)

dexto plugin marketplace update [name]

A local command: it does not follow the JSON and exit-code contract.

dexto plugin marketplace plugins

List plugins available in marketplaces

dexto plugin marketplace plugins [marketplace]
Option What it does
--verbose Show plugin descriptions

A local command: it does not follow the JSON and exit-code contract.

dexto plugin marketplace install

Install a plugin from marketplace (plugin or plugin@marketplace)

dexto plugin marketplace install <plugin>
Option What it does
--scope <scope> Installation scope: user, project, or local (default: "user")
--force Force reinstall if already exists

A local command: it does not follow the JSON and exit-code contract.