1bdd1030f5
* feat: Add sync command for Claude Code personal config Add `compound-plugin sync` command to sync ~/.claude/ personal config (skills and MCP servers) to OpenCode or Codex. Features: - Parses ~/.claude/skills/ for personal skills (supports symlinks) - Parses ~/.claude/settings.json for MCP servers - Syncs skills as symlinks (single source of truth) - Converts MCP to JSON (OpenCode) or TOML (Codex) - Dedicated sync functions bypass existing converter architecture Usage: compound-plugin sync --target opencode compound-plugin sync --target codex 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * fix: address security and quality review issues Security fixes: - Add path traversal validation with isValidSkillName() - Warn when MCP servers contain potential secrets (API keys, tokens) - Set restrictive file permissions (600) on config files - Safe forceSymlink refuses to delete real directories - Proper TOML escaping for quotes/backslashes/control chars Code quality fixes: - Extract shared symlink utils to src/utils/symlink.ts - Replace process.exit(1) with thrown error - Distinguish ENOENT from other errors in catch blocks - Remove unused `root` field from ClaudeHomeConfig - Make Codex sync idempotent (remove+rewrite managed section) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * fix: revert version bump (leave to maintainers) * feat: bump root version to 0.2.0 for sync command --------- Co-authored-by: Claude <noreply@anthropic.com>
87 lines
3.4 KiB
Markdown
87 lines
3.4 KiB
Markdown
# Compound Marketplace
|
|
|
|
[](https://github.com/EveryInc/compound-engineering-plugin/actions/workflows/ci.yml)
|
|
[](https://www.npmjs.com/package/@every-env/compound-plugin)
|
|
|
|
A Claude Code plugin marketplace featuring the **Compound Engineering Plugin** — tools that make each unit of engineering work easier than the last.
|
|
|
|
## Claude Code Install
|
|
|
|
```bash
|
|
/plugin marketplace add https://github.com/EveryInc/compound-engineering-plugin
|
|
/plugin install compound-engineering
|
|
```
|
|
|
|
## OpenCode + Codex (experimental) Install
|
|
|
|
This repo includes a Bun/TypeScript CLI that converts Claude Code plugins to OpenCode and Codex.
|
|
|
|
```bash
|
|
# convert the compound-engineering plugin into OpenCode format
|
|
bunx @every-env/compound-plugin install compound-engineering --to opencode
|
|
|
|
# convert to Codex format
|
|
bunx @every-env/compound-plugin install compound-engineering --to codex
|
|
```
|
|
|
|
Local dev:
|
|
|
|
```bash
|
|
bun run src/index.ts install ./plugins/compound-engineering --to opencode
|
|
```
|
|
|
|
OpenCode output is written to `~/.config/opencode` by default, with `opencode.json` at the root and `agents/`, `skills/`, and `plugins/` alongside it.
|
|
Both provider targets are experimental and may change as the formats evolve.
|
|
Codex output is written to `~/.codex/prompts` and `~/.codex/skills`, with each Claude command converted into both a prompt and a skill (the prompt instructs Codex to load the corresponding skill). Generated Codex skill descriptions are truncated to 1024 characters (Codex limit).
|
|
|
|
## Sync Personal Config
|
|
|
|
Sync your personal Claude Code config (`~/.claude/`) to OpenCode or Codex:
|
|
|
|
```bash
|
|
# Sync skills and MCP servers to OpenCode
|
|
bunx @every-env/compound-plugin sync --target opencode
|
|
|
|
# Sync to Codex
|
|
bunx @every-env/compound-plugin sync --target codex
|
|
```
|
|
|
|
This syncs:
|
|
- Personal skills from `~/.claude/skills/` (as symlinks)
|
|
- MCP servers from `~/.claude/settings.json`
|
|
|
|
Skills are symlinked (not copied) so changes in Claude Code are reflected immediately.
|
|
|
|
## Workflow
|
|
|
|
```
|
|
Plan → Work → Review → Compound → Repeat
|
|
```
|
|
|
|
| Command | Purpose |
|
|
|---------|---------|
|
|
| `/workflows:plan` | Turn feature ideas into detailed implementation plans |
|
|
| `/workflows:work` | Execute plans with worktrees and task tracking |
|
|
| `/workflows:review` | Multi-agent code review before merging |
|
|
| `/workflows:compound` | Document learnings to make future work easier |
|
|
|
|
Each cycle compounds: plans inform future plans, reviews catch more issues, patterns get documented.
|
|
|
|
## Philosophy
|
|
|
|
**Each unit of engineering work should make subsequent units easier—not harder.**
|
|
|
|
Traditional development accumulates technical debt. Every feature adds complexity. The codebase becomes harder to work with over time.
|
|
|
|
Compound engineering inverts this. 80% is in planning and review, 20% is in execution:
|
|
- Plan thoroughly before writing code
|
|
- Review to catch issues and capture learnings
|
|
- Codify knowledge so it's reusable
|
|
- Keep quality high so future changes are easy
|
|
|
|
## Learn More
|
|
|
|
- [Full component reference](plugins/compound-engineering/README.md) - all agents, commands, skills
|
|
- [Compound engineering: how Every codes with agents](https://every.to/chain-of-thought/compound-engineering-how-every-codes-with-agents)
|
|
- [The story behind compounding engineering](https://every.to/source-code/my-ai-had-already-fixed-the-code-before-i-saw-it)
|