tai plugins advisories
Show the cached advisory snapshot for the installed plugins.
Example: tai plugins advisories
tai plugins categories
List the marketplace’s controlled category vocabulary.
Example: tai plugins categories
tai plugins info
Show one listing’s detail and its published versions.
Example: tai plugins info tai42/toolbox
tai plugins init
Scaffold a descriptor-only plugin directory (yml, docs, licence, changelog).
--kind connector needs --auth {oauth,none}; --kind mcp-server takes no
--auth. The written tree parses as a plugin spec and its docs validate as-is;
edit the placeholders (acme, example.invalid, the icon) before publishing.
Example: tai plugins init connector-acme --kind connector --auth oauth
tai plugins install
Install a marketplace plugin by ref, optionally pinning a version.
--mount remaps a route-carrying item’s base prefix; --env KEY=VALUE and
--secret KEY supply the install-time env the spec declares (an mcp entry’s
!ENV markers or an oauth connector’s client credentials, the secret
auto-marked); --dry-run previews the resolved routes, delivery, and required
env (exiting non-zero on any collision) without installing; and
--accept-public-routes is required when the plugin declares routes that
answer without authentication.
Before installing, the server’s preview reports which required env is still
missing; an unresolved var not passed via --env fails the command before any
install is posted.
Example: tai plugins install tai42/toolbox
tai plugins installed
List installed marketplace plugins with compat verdicts and update availability.
Example: tai plugins installed
tai plugins kinds
List the marketplace’s controlled item-kind vocabulary.
Example: tai plugins kinds
tai plugins rebuild
Rebuild every plugin environment that does not match the install store or this image.
Prints each environment as “up to date”, “rebuilt” or “removed”. Exits non-zero, with
the reason, when the plugins directory is unset or unwritable, another marketplace
operation holds the lock, the database is unreachable, the config provider is absent,
the manifest does not exist, or a build fails.
Example: tai plugins rebuild
tai plugins schema
Print the JSON Schema of a tai-plugin.yml (the PluginSpec model).
The canonical shape the marketplace validates against, including the provides
index; feed it to an editor or a validator.
Example: tai plugins schema
tai plugins search
Search the marketplace registry, optionally filtered by facets.
Example: tai plugins search uuid --kind tool
tai plugins uninstall
Uninstall a marketplace-installed plugin by ref.
Against the running server by default; with --offline, on the deployment host with no
server (the way out when the server cannot start because of the plugin).
Example: tai plugins uninstall tai42/toolbox
tai plugins update
Update an installed plugin to a newer (or named) version.
--env KEY=VALUE and --secret KEY supply env a new version newly requires
(a fresh !ENV marker or connector credential); --dry-run previews the
target’s delivery and required env. A required var still missing and not passed
via --env fails the command before any update is posted.
Example: tai plugins update tai42/toolbox
tai plugins upgrade
Upgrade every installed plugin to its latest compatible version.
--all is required: the batch is deliberately explicit, and a single
plugin is upgraded with tai plugins update REF instead. The report
names each plugin’s outcome, the one fleet recycle roll the batch ran over
the workers its reload reported as needing a restart, and the workers
still awaiting a respawn after it.
Example: tai plugins upgrade --all