Skip to main content
A plugin is a versioned bundle of skills, commands, agents, hooks and MCP servers in Claude Code’s or Codex’s plugin format, pinned to one commit. Every command acts on your personal organization’s plugins. With the global --org it acts on that team’s. Commands that take a <plugin> name it by its name or its id. Every member lists marketplaces and plugins. Browsing a marketplace, installing, updating, setting defaults and uninstalling take an admin of the organization; a member who tries is refused with the rule named. Alias: plugins

Usage

Subcommands

Marketplaces

Lists Anthropic’s Claude Code marketplace and OpenAI’s Codex marketplace, by name. Any other public marketplace is browsed by its repository URL.

Browse

Lists a marketplace’s plugins, named by an official marketplace’s name or by its public https git repository, read at its default branch. A plugin Aether cannot run says why. A marketplace’s text is printed with its control characters escaped.

List

Lists the organization’s plugins: the commit each is pinned to, whether the organization has it on by default, whose connection its servers use unless a project sets its own (the default credential policy: creator or org), how many MCP servers it has, and where it comes from. --json prints the API’s list, servers and skills included.

Install

Installs a plugin, pinned to the commit its source resolves to now. With --marketplace, <plugin> is the name a marketplace lists, the marketplace named by an official marketplace’s name or its https git repository. Otherwise <plugin> is a public git repository: owner/repo, an https git URL, or a link to a directory of a GitHub repository at a branch or tag. A directory without a plugin manifest installs as a plugin of its skills.
The plugin’s MCP servers that take a connection are printed with the aether mcp connect command that makes each: yours or, under the org policy, the organization’s.

Update

Without --revision, resolves the plugin’s source again and shows what updating would change, writing nothing: the commit it moves to, the MCP servers it would add or remove, and each field of a changed server that differs (a remote server’s URL, auth and headers; a local server’s command, arguments and environment). A server whose URL or auth changes loses its connections. With --revision, it moves the plugin to that revision, which must be the one the preview showed: a source that moved since is refused.

Defaults

Sets one organization-wide default at a time, since each rewrites every project’s enablement.

Uninstall

Deletes the plugin, its MCP servers and their connections, and every project’s enablement of it.