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.
| Command | What it does |
|---|---|
atoi plugin list | List installed plugins, or with --available the plugins Atoi offers by name. |
atoi plugin view | Read an installed plugin, with what it adds and may touch. |
atoi plugin install | Install 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 consent | Show what a plugin adds and may touch; with --yes, allow exactly that and turn it on. |
atoi plugin enable | Turn on an installed plugin; refused until its current permissions are allowed. |
atoi plugin disable | Turn off an installed plugin and its skills and tools. |
atoi plugin remove | Remove an installed plugin with its skills, tools, views and secrets. |
atoi plugin sync | Compare 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]
| Flag | Type | Default | Values | What it does |
|---|---|---|---|---|
--available | boolean | List the plugins Atoi offers to install by name. | ||
--json | boolean | false | Emit the canonical JSON envelope. | |
--ndjson | boolean | false | Emit one canonical JSON envelope per line. | |
--format | string | text | text, json | Choose human text or the JSON envelope. |
--help -h | boolean | Show command help. |
#Run plugin list
atoi plugin list --json{
"tool": "atoi_plugins",
"arguments": {
"action": "list"
}
}#plugin view
Read an installed plugin, with what it adds and may touch.
atoi plugin view <plugin-id>
| Flag | Type | Default | Values | What it does |
|---|---|---|---|---|
--json | boolean | false | Emit the canonical JSON envelope. | |
--ndjson | boolean | false | Emit one canonical JSON envelope per line. | |
--format | string | text | text, json | Choose human text or the JSON envelope. |
--help -h | boolean | Show command help. |
#Run plugin view
atoi plugin view atoi --json{
"tool": "atoi_plugins",
"arguments": {
"action": "get",
"plugin_id": "atoi"
}
}#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>]
| Flag | Type | Default | Values | What it does |
|---|---|---|---|---|
--version | string | For the first-party pack, require the loaded pack to match this version. | ||
--from | string | For the first-party pack, load it from a local path. | ||
--idempotency-key | string | Reuse a mutation identity when you safely retry the same action. | ||
--json | boolean | false | Emit the canonical JSON envelope. | |
--ndjson | boolean | false | Emit one canonical JSON envelope per line. | |
--format | string | text | text, json | Choose human text or the JSON envelope. |
--help -h | boolean | Show command help. |
#Run plugin install
atoi plugin install word-tools --json{
"tool": "atoi_plugins",
"arguments": {
"action": "install",
"plugin_id": "atoi",
"idempotency_key": "plugin_install_1"
}
}#plugin consent
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>]
| Flag | Type | Default | Values | What it does |
|---|---|---|---|---|
--yes | boolean | Allow the permissions just shown and turn the plugin on. | ||
--idempotency-key | string | Reuse a mutation identity when you safely retry the same action. | ||
--json | boolean | false | Emit the canonical JSON envelope. | |
--ndjson | boolean | false | Emit one canonical JSON envelope per line. | |
--format | string | text | text, json | Choose human text or the JSON envelope. |
--help -h | boolean | Show command help. |
#Run plugin consent
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>]
| Flag | Type | Default | Values | What it does |
|---|---|---|---|---|
--idempotency-key | string | Reuse a mutation identity when you safely retry the same action. | ||
--json | boolean | false | Emit the canonical JSON envelope. | |
--ndjson | boolean | false | Emit one canonical JSON envelope per line. | |
--format | string | text | text, json | Choose human text or the JSON envelope. |
--help -h | boolean | Show command help. |
#Run plugin enable
atoi plugin enable atoi --json{
"tool": "atoi_plugins",
"arguments": {
"action": "enable",
"plugin_id": "atoi",
"idempotency_key": "plugin_enable_1"
}
}#plugin disable
Turn off an installed plugin, with its skills and tools.
atoi plugin disable <plugin-id> [--idempotency-key <key>]
| Flag | Type | Default | Values | What it does |
|---|---|---|---|---|
--idempotency-key | string | Reuse a mutation identity when you safely retry the same action. | ||
--json | boolean | false | Emit the canonical JSON envelope. | |
--ndjson | boolean | false | Emit one canonical JSON envelope per line. | |
--format | string | text | text, json | Choose human text or the JSON envelope. |
--help -h | boolean | Show command help. |
#Run plugin disable
atoi plugin disable atoi --json{
"tool": "atoi_plugins",
"arguments": {
"action": "disable",
"plugin_id": "atoi",
"idempotency_key": "plugin_disable_1"
}
}#plugin remove
Remove an installed plugin with its skills, tools, views and secrets.
atoi plugin remove <plugin-id> --confirm [--idempotency-key <key>]
| Flag | Type | Default | Values | What it does |
|---|---|---|---|---|
--confirm required | boolean | Confirm the exact consequential action after you inspect its target. | ||
--idempotency-key | string | Reuse a mutation identity when you safely retry the same action. | ||
--json | boolean | false | Emit the canonical JSON envelope. | |
--ndjson | boolean | false | Emit one canonical JSON envelope per line. | |
--format | string | text | text, json | Choose human text or the JSON envelope. |
--help -h | boolean | Show command help. |
#Run plugin remove
atoi plugin remove atoi --confirm --json{
"tool": "atoi_plugins",
"arguments": {
"action": "remove",
"plugin_id": "atoi",
"confirmation": true,
"idempotency_key": "plugin_remove_1"
}
}#plugin sync
Compare the first-party plugin provenance with the pinned pack.
atoi plugin sync [plugin-id] [--from <path>]
| Flag | Type | Default | Values | What it does |
|---|---|---|---|---|
--from | string | Load the observed pack from a local path. | ||
--json | boolean | false | Emit the canonical JSON envelope. | |
--ndjson | boolean | false | Emit one canonical JSON envelope per line. | |
--format | string | text | text, json | Choose human text or the JSON envelope. |
--help -h | boolean | Show command help. |
#Run plugin sync
atoi plugin sync atoi --jsonRead Extend Atoi for the rest of this group, or the CLI reference index for every command.
Was this useful?