Plugin marketplace

Marketplace sources let teams browse, install, update, and remove AFK plugins from curated git repositories or direct marketplace JSON files.

Marketplace sources

Add sources from Preferences → Plugins or the plugin install modal. AFK accepts GitHub shorthand, git URLs, and direct JSON URLs.

owner/repo
https://github.com/owner/repo
git@github.com:owner/repo.git
https://example.com/marketplace.json

Git-backed marketplaces can be refreshed with Pull latest. A refresh automatically updates installed plugins supplied by that marketplace and resolves their declared dependencies. Configured marketplaces are also synced when the daemon reconnects, updating plugins from each marketplace that synced successfully. Removing a source deletes the daemon-side checkout and removes it from preferences.

Marketplace file

A marketplace JSON file lists available plugins and optional marketplace metadata. Teams can use marketplaces to curate approved plugins and make installation repeatable.

{
  "name": "Engineering Tools",
  "metadata": {
    "description": "Team-approved coding-agent workflows",
    "version": "2026.05"
  },
  "plugins": [
    {
      "name": "release-helper",
      "description": "Release checklist skills and hooks",
      "version": "1.2.0",
      "source": {
        "source": "github",
        "repo": "example/release-helper",
        "ref": "main"
      }
    }
  ]
}

Plugin source formats

Format	Use when	Example
`{ "source": "github" }`	The plugin lives in a GitHub repository.	`{ "source": "github", "repo": "org/plugin" }`
`{ "source": "url" }`	The plugin is downloaded from a direct URL.	`{ "source": "url", "url": "https://example.com/plugin.zip" }`
`{ "source": "git-subdir" }`	Multiple plugins live in one git repository.	`{ "source": "git-subdir", "url": "https://github.com/org/tools", "path": "plugins/reviewer" }`
Relative path	The plugin lives inside the same marketplace repo.	`plugins/release-helper`

Dependencies

Marketplace plugins can declare dependencies so related workflow packages are installed together. Keep dependency graphs simple and prefer curated marketplace sources your team controls.

Install and update behavior

Install, update, and remove operations are performed by the daemon.
Git-backed marketplaces can be refreshed when you want the latest catalog.
After changing plugins, run /reload or the reload tool in a session to refresh capabilities.