Skip to content

Plugin CLI reference


Install, allow, and manage Atoi plugins from the terminal.

Use this page to inspect every public atoi plugin command, its accepted flags, and one runnable example. A plugin is an Agent Plugins package: its skills, the tools its MCP servers serve, and its views. Each one installs off; atoi plugin consent shows what it adds and may touch, and --yes allows exactly that. Its tools run on your Mac under that Mac's Ask, Always or Never setting. To install the plugin in Claude Code, Codex, or Cursor, use MCP and plugins.

atoi pluginInstall, allow, and manage Atoi plugins.

CommandWhat it does
atoi plugin listList installed plugins, or with --available the plugins Atoi offers by name.
atoi plugin viewRead an installed plugin, with what it adds and may touch.
atoi plugin installInstall an Agent Plugins package by git URL, .atoi-plugin.json link, local folder, or a name from --available. It installs off until you allow it.
atoi plugin consentShow what a plugin adds and may touch; with --yes, allow exactly that and turn it on.
atoi plugin enableTurn on an installed plugin; refused until its current permissions are allowed.
atoi plugin disableTurn off an installed plugin and its skills and tools.
atoi plugin removeRemove an installed plugin with its skills, tools, views and secrets.
atoi plugin syncCompare the first-party plugin provenance with the pinned pack.

#plugin list

List installed plugins. With --available, list the plugins Atoi offers to install by name.

atoi plugin list [--available]

FlagTypeDefaultValuesWhat it does
--availablebooleanList the plugins Atoi offers to install by name.
--jsonbooleanfalseEmit the canonical JSON envelope.
--ndjsonbooleanfalseEmit one canonical JSON envelope per line.
--formatstringtexttext, jsonChoose human text or the JSON envelope.
--help -hbooleanShow command help.

#Run plugin list

bash
atoi plugin list --json

#plugin view

Read an installed plugin, with what it adds and may touch.

atoi plugin view <plugin-id>

FlagTypeDefaultValuesWhat it does
--jsonbooleanfalseEmit the canonical JSON envelope.
--ndjsonbooleanfalseEmit one canonical JSON envelope per line.
--formatstringtexttext, jsonChoose human text or the JSON envelope.
--help -hbooleanShow command help.

#Run plugin view

bash
atoi plugin view atoi --json

#plugin install

Install a plugin by git URL, .atoi-plugin.json link, local folder, or a name from atoi plugin list --available. It installs off until you allow it. creative-int/atoi-plugins still installs the pinned first-party pack.

atoi plugin install <git-url|package-url|folder|name> [--version <version>] [--from <path>] [--idempotency-key <key>]

FlagTypeDefaultValuesWhat it does
--versionstringFor the first-party pack, require the loaded pack to match this version.
--fromstringFor the first-party pack, load it from a local path.
--idempotency-keystringReuse a mutation identity when you safely retry the same action.
--jsonbooleanfalseEmit the canonical JSON envelope.
--ndjsonbooleanfalseEmit one canonical JSON envelope per line.
--formatstringtexttext, jsonChoose human text or the JSON envelope.
--help -hbooleanShow command help.

#Run plugin install

bash
atoi plugin install word-tools --json

Show what a plugin adds and may touch. With --yes, allow exactly the version and permissions just shown and turn the plugin on. An update that asks for more turns it off until you allow it again.

atoi plugin consent <plugin-id> --yes [--idempotency-key <key>]

FlagTypeDefaultValuesWhat it does
--yesbooleanAllow the permissions just shown and turn the plugin on.
--idempotency-keystringReuse a mutation identity when you safely retry the same action.
--jsonbooleanfalseEmit the canonical JSON envelope.
--ndjsonbooleanfalseEmit one canonical JSON envelope per line.
--formatstringtexttext, jsonChoose human text or the JSON envelope.
--help -hbooleanShow command help.
bash
atoi plugin consent word-tools --yes --json

#plugin enable

Turn on an installed plugin. It is refused until the plugin's current permissions are allowed.

atoi plugin enable <plugin-id> [--idempotency-key <key>]

FlagTypeDefaultValuesWhat it does
--idempotency-keystringReuse a mutation identity when you safely retry the same action.
--jsonbooleanfalseEmit the canonical JSON envelope.
--ndjsonbooleanfalseEmit one canonical JSON envelope per line.
--formatstringtexttext, jsonChoose human text or the JSON envelope.
--help -hbooleanShow command help.

#Run plugin enable

bash
atoi plugin enable atoi --json

#plugin disable

Turn off an installed plugin, with its skills and tools.

atoi plugin disable <plugin-id> [--idempotency-key <key>]

FlagTypeDefaultValuesWhat it does
--idempotency-keystringReuse a mutation identity when you safely retry the same action.
--jsonbooleanfalseEmit the canonical JSON envelope.
--ndjsonbooleanfalseEmit one canonical JSON envelope per line.
--formatstringtexttext, jsonChoose human text or the JSON envelope.
--help -hbooleanShow command help.

#Run plugin disable

bash
atoi plugin disable atoi --json

#plugin remove

Remove an installed plugin with its skills, tools, views and secrets.

atoi plugin remove <plugin-id> --confirm [--idempotency-key <key>]

FlagTypeDefaultValuesWhat it does
--confirm requiredbooleanConfirm the exact consequential action after you inspect its target.
--idempotency-keystringReuse a mutation identity when you safely retry the same action.
--jsonbooleanfalseEmit the canonical JSON envelope.
--ndjsonbooleanfalseEmit one canonical JSON envelope per line.
--formatstringtexttext, jsonChoose human text or the JSON envelope.
--help -hbooleanShow command help.

#Run plugin remove

bash
atoi plugin remove atoi --confirm --json

#plugin sync

Compare the first-party plugin provenance with the pinned pack.

atoi plugin sync [plugin-id] [--from <path>]

FlagTypeDefaultValuesWhat it does
--fromstringLoad the observed pack from a local path.
--jsonbooleanfalseEmit the canonical JSON envelope.
--ndjsonbooleanfalseEmit one canonical JSON envelope per line.
--formatstringtexttext, jsonChoose human text or the JSON envelope.
--help -hbooleanShow command help.

#Run plugin sync

bash
atoi plugin sync atoi --json

Read Extend Atoi for the rest of this group, or the CLI reference index for every command.

Was this useful?