Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 9 additions & 9 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
@@ -1,19 +1,19 @@
{
"name": "superpowers-dev",
"description": "Development marketplace for Superpowers core skills library",
"name": "autodev-dev",
"description": "Development marketplace for Autonomous Dev Kit",
"owner": {
"name": "Jesse Vincent",
"email": "jesse@fsck.com"
"name": "Jon Langevin",
"email": "jon@gocodealone.com"
},
"plugins": [
{
"name": "superpowers",
"description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques",
"version": "5.7.2",
"name": "autodev",
"description": "Autonomous development workflow skills for coding agents",
"version": "6.0.0",
"source": "./",
"author": {
"name": "Jesse Vincent",
"email": "jesse@fsck.com"
"name": "Jon Langevin",
"email": "jon@gocodealone.com"
}
}
]
Expand Down
16 changes: 8 additions & 8 deletions .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
{
"name": "superpowers",
"description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques",
"version": "5.7.2",
"name": "autodev",
"description": "Autonomous development workflow skills for coding agents: design, review, planning, execution, monitoring, and retrospectives",
"version": "6.0.0",
"author": {
"name": "Jesse Vincent",
"email": "jesse@fsck.com"
"name": "Jon Langevin",
"email": "jon@gocodealone.com"
},
"homepage": "https://github.com/GoCodeAlone/claude-superpowers",
"repository": "https://github.com/GoCodeAlone/claude-superpowers",
"homepage": "https://github.com/GoCodeAlone/autonomous-dev-kit",
"repository": "https://github.com/GoCodeAlone/autonomous-dev-kit",
"license": "MIT",
"keywords": ["skills", "tdd", "debugging", "collaboration", "best-practices", "workflows"]
"keywords": ["skills", "tdd", "debugging", "collaboration", "best-practices", "workflows", "agents", "autonomous-development"]
}
52 changes: 36 additions & 16 deletions .codex/INSTALL.md
Original file line number Diff line number Diff line change
@@ -1,79 +1,99 @@
# Installing Superpowers for Codex
# Installing Autonomous Dev Kit for Codex

Enable superpowers skills in Codex via native skill discovery. Just clone and symlink.
Enable autodev skills in Codex via native skill discovery. Prefer the
`skills` CLI when Node is available; clone and symlink manually as a fallback.

## Prerequisites

- Git
- Node.js 18+ for `npx skills add` install

## Installation

1. **Clone the superpowers repository:**
### Recommended: Skills CLI

From your project root:

```bash
npx skills add GoCodeAlone/autonomous-dev-kit -a codex --skill '*' -y
```

For user/global install:

```bash
npx skills add GoCodeAlone/autonomous-dev-kit -a codex --skill '*' -g -y
```

Restart Codex after install.

### Manual fallback

1. **Clone the autodev repository:**
```bash
git clone https://github.com/GoCodeAlone/claude-superpowers.git ~/.codex/superpowers
git clone https://github.com/GoCodeAlone/autonomous-dev-kit.git ~/.codex/autodev
```

2. **Create the skills symlink:**
```bash
mkdir -p ~/.agents/skills
ln -s ~/.codex/superpowers/skills ~/.agents/skills/superpowers
ln -s ~/.codex/autodev/skills ~/.agents/skills/autodev
```

**Windows (PowerShell):**
```powershell
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills"
cmd /c mklink /J "$env:USERPROFILE\.agents\skills\superpowers" "$env:USERPROFILE\.codex\superpowers\skills"
cmd /c mklink /J "$env:USERPROFILE\.agents\skills\autodev" "$env:USERPROFILE\.codex\autodev\skills"
```

3. **Restart Codex** (quit and relaunch the CLI) to discover the skills.

## Migrating from old bootstrap

If you installed superpowers before native skill discovery, you need to:
If you installed autodev before native skill discovery, you need to:

1. **Update the repo:**
```bash
cd ~/.codex/superpowers && git pull
cd ~/.codex/autodev && git pull
```

2. **Create the skills symlink** (step 2 above) — this is the new discovery mechanism.

3. **Remove the old bootstrap block** from `~/.codex/AGENTS.md` — any block referencing `superpowers-codex bootstrap` is no longer needed.
3. **Remove the old bootstrap block** from `~/.codex/AGENTS.md` — any block referencing `autodev-codex bootstrap` is no longer needed.

4. **Restart Codex.**

## Verify

```bash
ls -la ~/.agents/skills/superpowers
ls -la ~/.agents/skills/autodev
```

You should see a symlink (or junction on Windows) pointing to your superpowers skills directory.
You should see a symlink (or junction on Windows) pointing to your autodev skills directory.

## Updating

```bash
cd ~/.codex/superpowers && git pull
cd ~/.codex/autodev && git pull
```

Skills update instantly through the symlink.

## Uninstalling

```bash
rm ~/.agents/skills/superpowers
rm ~/.agents/skills/autodev
```

Optionally delete the clone: `rm -rf ~/.codex/superpowers`.
Optionally delete the clone: `rm -rf ~/.codex/autodev`.

## Cross-LLM Behavior

Superpowers skills use `<host: claude-code>` blocks to gate Claude Code-only content. Codex skips those blocks automatically; no configuration needed.
Autonomous Dev Kit skills use `<host: claude-code>` blocks to gate Claude Code-only content. Codex skips those blocks automatically; no configuration needed.

To enable host-conditional logic inside skills (so skills can adapt behavior per host), declare your host in `~/.codex/AGENTS.md`:

```markdown
# Superpowers host declaration
# Autonomous Dev Kit host declaration
Host: codex
```

Expand Down
18 changes: 9 additions & 9 deletions .cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
{
"name": "superpowers",
"displayName": "Superpowers",
"description": "Core skills library: TDD, debugging, collaboration patterns, and proven techniques",
"version": "5.7.2",
"name": "autodev",
"displayName": "Autonomous Dev Kit",
"description": "Autonomous development workflow skills for coding agents",
"version": "6.0.0",
"author": {
"name": "Jesse Vincent",
"email": "jesse@fsck.com"
"name": "Jon Langevin",
"email": "jon@gocodealone.com"
},
"homepage": "https://github.com/GoCodeAlone/claude-superpowers",
"repository": "https://github.com/GoCodeAlone/claude-superpowers",
"homepage": "https://github.com/GoCodeAlone/autonomous-dev-kit",
"repository": "https://github.com/GoCodeAlone/autonomous-dev-kit",
"license": "MIT",
"keywords": ["skills", "tdd", "debugging", "collaboration", "best-practices", "workflows"],
"keywords": ["skills", "tdd", "debugging", "collaboration", "best-practices", "workflows", "agents", "autonomous-development"],
"skills": "./skills/",
"agents": "./agents/",
"commands": "./commands/",
Expand Down
2 changes: 1 addition & 1 deletion .github/FUNDING.yml
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
# These are supported funding model platforms

github: [obra]
github: [intel352]
2 changes: 1 addition & 1 deletion .github/workflows/bump-version.yml
Original file line number Diff line number Diff line change
Expand Up @@ -120,7 +120,7 @@ jobs:
echo "PR already open for $BRANCH (#$existing); skipping creation."
exit 0
fi
body=$(printf 'Automated version bump to `%s`.\n\nWhen this PR merges, the `Release Tag` workflow will create tag `v%s` and dispatch the `superpowers-version-bump` event to `GoCodeAlone/superpowers-marketplace`.\n' "$TARGET_VERSION" "$TARGET_VERSION")
body=$(printf 'Automated version bump to `%s`.\n\nWhen this PR merges, the `Release Tag` workflow will create tag `v%s` and dispatch the `autodev-version-bump` event to `GoCodeAlone/claude-marketplace`.\n' "$TARGET_VERSION" "$TARGET_VERSION")
gh pr create \
--base main \
--head "$BRANCH" \
Expand Down
8 changes: 4 additions & 4 deletions .github/workflows/release-tag.yml
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ jobs:
git push origin "v${TARGET_VERSION}"
echo "created=true" >> "$GITHUB_OUTPUT"

- name: Notify superpowers-marketplace
- name: Notify claude-marketplace
if: steps.tag.outputs.created == 'true'
env:
REPO_DISPATCH_TOKEN: ${{ secrets.REPO_DISPATCH_TOKEN }}
Expand All @@ -71,12 +71,12 @@ jobs:
response=$(curl -sL -w "\n%{http_code}" -X POST \
-H "Authorization: token ${REPO_DISPATCH_TOKEN}" \
-H "Accept: application/vnd.github.v3+json" \
https://api.github.com/repos/GoCodeAlone/superpowers-marketplace/dispatches \
-d "{\"event_type\": \"superpowers-version-bump\", \"client_payload\": {\"version\": \"${TARGET_VERSION}\"}}")
https://api.github.com/repos/GoCodeAlone/claude-marketplace/dispatches \
-d "{\"event_type\": \"autodev-version-bump\", \"client_payload\": {\"version\": \"${TARGET_VERSION}\"}}")
http_code=$(echo "$response" | tail -1)
body=$(echo "$response" | head -n -1)
if [[ "$http_code" -lt 200 || "$http_code" -ge 300 ]]; then
echo "ERROR: marketplace dispatch failed (HTTP ${http_code}): ${body}" >&2
exit 1
fi
echo "Dispatched superpowers-version-bump event to GoCodeAlone/superpowers-marketplace (HTTP ${http_code})"
echo "Dispatched autodev-version-bump event to GoCodeAlone/claude-marketplace (HTTP ${http_code})"
42 changes: 21 additions & 21 deletions .opencode/INSTALL.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Installing Superpowers for OpenCode
# Installing Autonomous Dev Kit for OpenCode

## Prerequisites

Expand All @@ -7,10 +7,10 @@

## Installation Steps

### 1. Clone Superpowers
### 1. Clone Autonomous Dev Kit

```bash
git clone https://github.com/GoCodeAlone/claude-superpowers.git ~/.config/opencode/superpowers
git clone https://github.com/GoCodeAlone/autonomous-dev-kit.git ~/.config/opencode/autodev
```

### 2. Register the Plugin
Expand All @@ -19,25 +19,25 @@ Create a symlink so OpenCode discovers the plugin:

```bash
mkdir -p ~/.config/opencode/plugins
rm -f ~/.config/opencode/plugins/superpowers.js
ln -s ~/.config/opencode/superpowers/.opencode/plugins/superpowers.js ~/.config/opencode/plugins/superpowers.js
rm -f ~/.config/opencode/plugins/autodev.js
ln -s ~/.config/opencode/autodev/.opencode/plugins/autodev.js ~/.config/opencode/plugins/autodev.js
```

### 3. Symlink Skills

Create a symlink so OpenCode's native skill tool discovers superpowers skills:
Create a symlink so OpenCode's native skill tool discovers autodev skills:

```bash
mkdir -p ~/.config/opencode/skills
rm -rf ~/.config/opencode/skills/superpowers
ln -s ~/.config/opencode/superpowers/skills ~/.config/opencode/skills/superpowers
rm -rf ~/.config/opencode/skills/autodev
ln -s ~/.config/opencode/autodev/skills ~/.config/opencode/skills/autodev
```

### 4. Restart OpenCode

Restart OpenCode. The plugin will automatically inject superpowers context.
Restart OpenCode. The plugin will automatically inject autodev context.

Verify by asking: "do you have superpowers?"
Verify by asking: "do you have autodev?"

## Usage

Expand All @@ -54,7 +54,7 @@ use skill tool to list skills
Use OpenCode's native `skill` tool to load a specific skill:

```
use skill tool to load superpowers/brainstorming
use skill tool to load autodev/brainstorming
```

### Personal Skills
Expand Down Expand Up @@ -82,27 +82,27 @@ description: Use when [condition] - [what it does]

Create project-specific skills in `.opencode/skills/` within your project.

**Skill Priority:** Project skills > Personal skills > Superpowers skills
**Skill Priority:** Project skills > Personal skills > Autonomous Dev Kit skills

## Updating

```bash
cd ~/.config/opencode/superpowers
cd ~/.config/opencode/autodev
git pull
```

## Troubleshooting

### Plugin not loading

1. Check plugin symlink: `ls -l ~/.config/opencode/plugins/superpowers.js`
2. Check source exists: `ls ~/.config/opencode/superpowers/.opencode/plugins/superpowers.js`
1. Check plugin symlink: `ls -l ~/.config/opencode/plugins/autodev.js`
2. Check source exists: `ls ~/.config/opencode/autodev/.opencode/plugins/autodev.js`
3. Check OpenCode logs for errors

### Skills not found

1. Check skills symlink: `ls -l ~/.config/opencode/skills/superpowers`
2. Verify it points to: `~/.config/opencode/superpowers/skills`
1. Check skills symlink: `ls -l ~/.config/opencode/skills/autodev`
2. Verify it points to: `~/.config/opencode/autodev/skills`
3. Use `skill` tool to list what's discovered

### Tool mapping
Expand All @@ -115,18 +115,18 @@ When skills reference Claude Code tools:

## Cross-LLM Behavior

Superpowers skills use `<host: claude-code>` blocks to gate Claude Code-only content. OpenCode skips those blocks automatically; no configuration needed.
Autonomous Dev Kit skills use `<host: claude-code>` blocks to gate Claude Code-only content. OpenCode skips those blocks automatically; no configuration needed.

To enable host-conditional logic inside skills (so skills can adapt behavior per host), declare your host in `~/.config/opencode/AGENTS.md`:

```markdown
# Superpowers host declaration
# Autonomous Dev Kit host declaration
Host: opencode
```

Add this block once. Skills that inspect the host context will use it to pick the right execution path.

## Getting Help

- Report issues: https://github.com/GoCodeAlone/claude-superpowers/issues
- Full documentation: https://github.com/GoCodeAlone/claude-superpowers/blob/main/docs/README.opencode.md
- Report issues: https://github.com/GoCodeAlone/autonomous-dev-kit/issues
- Full documentation: https://github.com/GoCodeAlone/autonomous-dev-kit/blob/main/docs/README.opencode.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
/**
* Superpowers plugin for OpenCode.ai
* Autonomous Dev Kit plugin for OpenCode.ai
*
* Injects superpowers bootstrap context via system prompt transform.
* Injects autodev bootstrap context via system prompt transform.
* Skills are discovered via OpenCode's native skill tool from symlinked directory.
*/

Expand Down Expand Up @@ -46,16 +46,16 @@ const normalizePath = (p, homeDir) => {
return path.resolve(normalized);
};

export const SuperpowersPlugin = async ({ client, directory }) => {
export const AutodevPlugin = async ({ client, directory }) => {
const homeDir = os.homedir();
const superpowersSkillsDir = path.resolve(__dirname, '../../skills');
const autodevSkillsDir = path.resolve(__dirname, '../../skills');
const envConfigDir = normalizePath(process.env.OPENCODE_CONFIG_DIR, homeDir);
const configDir = envConfigDir || path.join(homeDir, '.config/opencode');

// Helper to generate bootstrap content
const getBootstrapContent = () => {
// Try to load using-superpowers skill
const skillPath = path.join(superpowersSkillsDir, 'using-superpowers', 'SKILL.md');
// Try to load using-autodev skill
const skillPath = path.join(autodevSkillsDir, 'using-autodev', 'SKILL.md');
if (!fs.existsSync(skillPath)) return null;

const fullContent = fs.readFileSync(skillPath, 'utf8');
Expand All @@ -69,13 +69,13 @@ When skills reference tools you don't have, substitute OpenCode equivalents:
- \`Read\`, \`Write\`, \`Edit\`, \`Bash\` → Your native tools

**Skills location:**
Superpowers skills are in \`${configDir}/skills/superpowers/\`
Autonomous Dev Kit skills are in \`${configDir}/skills/autodev/\`
Use OpenCode's native \`skill\` tool to list and load skills.`;

return `<EXTREMELY_IMPORTANT>
You have superpowers.
You have autodev.

**IMPORTANT: The using-superpowers skill content is included below. It is ALREADY LOADED - you are currently following it. Do NOT use the skill tool to load "using-superpowers" again - that would be redundant.**
**IMPORTANT: The using-autodev skill content is included below. It is ALREADY LOADED - you are currently following it. Do NOT use the skill tool to load "using-autodev" again - that would be redundant.**

${content}

Expand Down
Loading
Loading