# Install from local directory
opencode-marketplace install /path/to/my-plugin

# Install from GitHub
opencode-marketplace install https://github.com/user/repo

# Install from subfolder
opencode-marketplace install https://github.com/user/repo/tree/main/plugins/foo

# Update a remote plugin
opencode-marketplace update my-plugin

# List installed plugins
opencode-marketplace list

# Scan before installing (dry-run)
opencode-marketplace scan https://github.com/user/repo

# Uninstall
opencode-marketplace uninstall my-plugin

Plugin Structure

A plugin is a directory with components in well-known locations:

my-plugin/
├── command/         # or .opencode/command/, .claude/commands/
│   └── reflect.md
├── agent/          # or .opencode/agent/, .claude/agents/
│   └── reviewer.md
└── skill/          # or .opencode/skill/, .claude/skills/
    └── code-review/
        ├── SKILL.md
        └── reference.md

Discovery Priority: .opencode/* → .claude/* → ./command/ → ./commands/

How It Works

Discovery - Scans for components using convention-based paths
Namespacing - Copies files with prefixes: my-plugin--reflect.md
Registry - Tracks installations in ~/.config/opencode/plugins/installed.json
Change Detection - Content hashing detects actual changes

Scopes

Scope	Target	Registry
`user` (default)	`~/.config/opencode/`	`~/.config/opencode/plugins/installed.json`
`project`	`.opencode/`	`.opencode/plugins/installed.json`

Use --scope project for project-local installations.

Example Output

$ opencode-marketplace install https://github.com/user/awesome-plugins/tree/main/misc

Installing misc [a1b2c3d4]...
  → command/misc--reflect.md
  → skill/misc--review/

Installed misc (1 command, 1 skill) to user scope.

$ opencode-marketplace list

User scope:
  misc [a1b2c3d4] (1 command, 1 skill)
    Source: https://github.com/user/awesome-plugins/tree/main/misc

Development

bun install          # Install dependencies
bun run dev          # Run locally
bun test             # Run tests
bun run lint         # Lint code

License

MIT