Universal plugins for coding agents.
Follow @hyericlee on X for updates · Join the OpenPackage Discord for help and questions.
OpenPackage enables simple, modular management of coding agent configs, providing unified installation, management, and packaging of rules, commands, agents, skills, and MCPs for any platform, any codebase.
Modern AI coding tools are powerful and efficient when rules, commands, subagents, and skills are properly setup.
Unfortunately, these files remain difficult to organize and manage.
OpenPackage provides a centralized and universal interface for installing, uninstalling, and packaging coding agent config files for simplified management and distribution.
- Simplified config management - Install & uninstall rules, commands, agents, skills and MCPs with a single command
- Consistent dependencies - Declare and package sets of config files for organization and reuse
- Universal compatability - Built in cross-platform conversions and install target resolutions
- Community driven - Compose packages together to create powerful workflows that continuously evolve
- Install Agents, Skills, and Claude Plugins to any coding platform
- Sync rules, commands, agents, skills, and MCPs across platforms
- Reuse files and configs across multiple codebases
- Simplified, modular management and install/uninstall of configs and specs
At its core, OpenPackage is a lightweight CLI package manager that performs installs and uninstalls of config files, with the ability to keep track of file sources and dependencies, plus packaging capabilities.
It's basically a much more powerful, universal, and open source version of Claude Code Plugins.
npm
npm install -g opkg opkg install <resource>Installs all files from a specified resource into the codebase at cwd, formatted and converted to per platform conventions and into their respective dirs.
# Packages or Marketplaces
opkg install gh@<user>/<repo> --plugins <plugin-name>
# Packages or Claude Code plugins hosted on GitHub
opkg install gh@<user>/<repo> --plugins <plugin-name>
# Agents and Skills hosted on GitHub
opkg install gh@<user>/<repo> --plugins <plugin-name> --agents <agent-name>
opkg install gh@<user>/<repo> --plugins <plugin-name> --skills <agent-name>
opkg install gh@<user>/<repo> --skills <agent-name>
# GitHub URLs
opkg install https://github.com/<user>/<repo>/<path-to-resource>
# Local path to package or Claude Code plugin
opkg install <path-to-dir>
# Examples
opkg install gh@anthropics/claude-code --plugins code-review
opkg install gh@vercel-labs/agent-skills --skills react-best-practices
opkg install https://github.com/anthropics/claude-code/tree/main/plugins/code-review
opkg install https://github.com/vercel-labs/agent-skills/tree/main/skills/react-best-practicesUse the --global (or -g) option to install files to user scope:
# Installs to home dir, ex: ~/.cursor/, ~/.opencode/
opkg install github:anthropics/claude-code -gopkg list # Lists resources installed to workspace at cwd
opkg list <package> # Lists installed files for specified resourceUse the status command to show an overview of packages and files installed.
opkg uninstall <package>Removes all files for a package from the codebase at cwd.
Tip
Learn more by heading over to the official docs.
opkg new <package>Then manually add/update/remove files to and from the package following this structure:
<package>
│
│ # Package files
├── openpackage.yml # The OpenPackage manifest, required
├── README.md # LICENSE.md, CONTRIBUTING.md, etc.
│
│ # Content files
├── rules/ # Rule files
├── commands/ # Command files (slash commands)
├── agents/ # Agent files (subagents)
├── skills/ # Skill files (skills)
├── root/ # Any other root dirs or files (Ex: specs/, docs/, tests/, etc.)
├── AGENTS.md # Platform root file
├── mcp.jsonc # MCP config file
│
│ # Custom files
└── <other> # Customizable via `platforms.jsonc` overrides/extensionsYou can also use the add and remove commands to add/remove files to/from a package.
opkg add <package> .cursor/commands/clean.md # Adds workspace file or dir to package
opkg remove <package> commands/clean.md # Removes file or dir from packageTip
Learn more about packages from the packages doc on our official docs.
OpenPackage performs installation and platform sync of files for supported AI coding platforms outlined by the table below.
| Platform | Directory | Root file | Rules | Commands | Agents | Skills | MCP |
|---|---|---|---|---|---|---|---|
| Antigravity | .agent/ | rules/ | workflows/ | skills/ | |||
| Augment Code | .augment/ | rules/ | commands/ | ||||
| Claude Code | .claude/ | CLAUDE.md | rules/ | commands/ | agents/ | skills/ | .mcp.json (root) |
| Codex | .codex/ | AGENTS.md | prompts/ | skills/ | config.toml | ||
| Cursor | .cursor/ | AGENTS.md | rules/ | commands/ | agents/ | skills/ | mcp.json |
| Factory | .factory/ | AGENTS.md | commands/ | droids/ | skills/ | mcp.json | |
| Kilo Code | .kilocode/ | AGENTS.md | rules/ | workflows/ | skills/ | mcp.json | |
| Kiro | .kiro/ | steering/ | settings/mcp.json | ||||
| OpenCode | .opencode/ | AGENTS.md | command/ | agent/ | skills/ | opencode.json | |
| Pi-Mono | .pi/ | AGENTS.md | agent/prompts/ | agent/skills/ | |||
| Qwen Code | .qwen/ | QWEN.md | agents/ | skills/ | settings.json | ||
| Roo | .roo/ | AGENTS.md | commands/ | skills/ | mcp.json | ||
| Warp | .warp/ | WARP.md | |||||
| Windsurf | .windsurf/ | rules/ | skills/ |
The built-in platforms.jsonc defines supported platforms, but can be overridden by user configs:
- Global:
~/.openpackage/platforms.jsonc(.json) - Workspace:
<cwd>/.openpackage/platforms.jsonc(.json)
Deep-merged (local > global > built-in) for per-project customization.
We would love your help building a more open source and universally compatible agentic coding ecosystem.
Feel free to create PRs and Github issues for:
- Bugs
- Feature requests
- Support for new platforms
- Missing standard behavior
- Documentation
