Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
69 commits
Select commit Hold shift + click to select a range
5bf3f77
docs: add Codex App compatibility design spec (PRI-823)
Mar 23, 2026
e0fcfaf
docs: address spec review feedback for PRI-823
Mar 23, 2026
872ec69
docs: address team review feedback for PRI-823 spec
Mar 23, 2026
cb4745e
docs: clarify executing-plans in What Does NOT Change section
Mar 23, 2026
477c553
docs: add cleanup guard test (#5) and sandbox fallback test (#10) to …
Mar 23, 2026
250dea4
docs: add implementation plan for Codex App compatibility (PRI-823)
Mar 23, 2026
7820adc
docs(codex-tools): add named agent dispatch mapping for Codex (#647)
Mar 23, 2026
c141508
fix(writing-skills): correct false 'only two fields' frontmatter clai…
arittr Mar 24, 2026
bf8f757
Replace subagent review loops with lightweight inline self-review
obra Mar 20, 2026
b045fa3
Revert "Replace subagent review loops with lightweight inline self-re…
obra Mar 24, 2026
9fa8ceb
Reapply "Replace subagent review loops with lightweight inline self-r…
obra Mar 24, 2026
218c3ed
Merge branch 'main' into dev
obra Mar 24, 2026
a22122d
Add v5.0.6 release notes
obra Mar 24, 2026
ab500da
Move brainstorm server metadata to .meta/ subdirectory
obra Mar 24, 2026
ed4103a
Revert "Move brainstorm server metadata to .meta/ subdirectory"
obra Mar 24, 2026
94b2bcb
Separate brainstorm server content and state into peer directories
obra Mar 24, 2026
738a18d
Fix owner-PID false positive when owner runs as different user
obra Mar 24, 2026
af025aa
Fix owner-PID lifecycle monitoring for cross-platform reliability
obra Mar 24, 2026
0f306f0
Merge branch 'fix/owner-pid-lifecycle' into dev
obra Mar 24, 2026
879940b
Release v5.0.6: inline self-review, brainstorm server restructure, ow…
obra Mar 25, 2026
5406747
fix: add Copilot CLI platform detection for sessionStart context inje…
culinablaz Mar 25, 2026
ed06287
feat: add Copilot CLI tool mapping, docs, and install instructions
obra Mar 25, 2026
8721728
fix(opencode): align skills path across bootstrap, runtime, and tests
obra Mar 25, 2026
471aa93
docs: add OpenCode path fix to release notes
obra Mar 25, 2026
04ff666
fix(opencode): inject bootstrap as user message instead of system mes…
obra Mar 26, 2026
8b9a5da
docs: update release notes with OpenCode bootstrap change
obra Mar 26, 2026
79fee93
docs: add worktree rototill design spec (PRI-974)
arittr Apr 6, 2026
2e53549
docs: address SWE review feedback on worktree rototill spec
arittr Apr 6, 2026
7ebda5c
docs: honest spec revisions after issue/PR deep dive
arittr Apr 6, 2026
c6d66a0
docs: add worktree rototill implementation plan (PRI-974)
arittr Apr 6, 2026
abaaf8a
test: add RED/GREEN validation for native worktree preference (PRI-974)
arittr Apr 6, 2026
4652e65
feat: rewrite using-git-worktrees with detect-and-defer (PRI-974)
arittr Apr 6, 2026
5dade17
feat: rewrite finishing-a-development-branch with detect-and-defer (P…
arittr Apr 6, 2026
c62b835
fix: address spec review findings in both skill rewrites (PRI-974)
arittr Apr 6, 2026
77f98c5
fix: update worktree integration references across skills (PRI-974)
arittr Apr 6, 2026
9dd13e5
fix: include worktrees/ (non-hidden) in finishing provenance check (P…
arittr Apr 6, 2026
61ad482
fix: Step 1a validated through TDD — explicit naming + consent bridge…
arittr Apr 6, 2026
0f4d7d6
docs: update spec with TDD findings on Step 1a (PRI-974)
arittr Apr 6, 2026
118d85b
docs: honest cross-platform validation table in spec (PRI-974)
arittr Apr 6, 2026
238167f
docs: cross-platform validation on 5 harnesses (PRI-974)
arittr Apr 6, 2026
4c49406
fix: remove incorrect hooks symlink step from worktree skill
arittr Apr 7, 2026
98263ce
docs: address PR #1121 review — respect user preference, drop y/n
arittr Apr 13, 2026
998c40b
docs: soften Step 1a native-tool framing per PR #1121 review
arittr Apr 13, 2026
e4a15b6
docs: drop instruction file enumeration per PR #1121 review
arittr Apr 13, 2026
e3dd3b4
fix: replace hardcoded /Users/jesse with generic placeholders (#858)
arittr Apr 7, 2026
c61f750
Merge pull request #1122 from obra/fix-replace-hardcoded-users
obra Apr 13, 2026
1e8000a
Merge pull request #1121 from obra/worktree-worktree-rototill
obra Apr 13, 2026
f55f8df
Remove the deprecated legacy slash commands (#1188)
obra Apr 16, 2026
16584b4
Add first-class support for Kimi Code 2.6- Add .kimi/AGENTS.md bootst…
XxclaymoreXx Apr 21, 2026
4b3efb4
Replace Kimi Code symlink-based install with first-class native hook …
XxclaymoreXx Apr 24, 2026
49bcb34
fix: prevent subagent-driven-development from pausing every 3 tasks
obra Mar 31, 2026
3adb7a0
Remove Integration sections from skills
Apr 27, 2026
1ca87f8
Merge remote-tracking branch 'origin/main' into dev
arittr Apr 27, 2026
c13a884
fix(opencode): cache bootstrap content at module level to eliminate p…
voidborne-d Apr 20, 2026
7e59af8
test(opencode): simplify bootstrap cache coverage
arittr Apr 27, 2026
9b3045a
docs: clarify opencode install caveats
arittr Apr 27, 2026
88eb667
test(opencode): modernize integration tests
arittr Apr 27, 2026
abb801b
docs: add Factory Droid installation instructions
Skyline-9 Apr 17, 2026
b1c15fd
Preserve Codex marketplace metadata
arittr Apr 27, 2026
5745f0e
docs: add README quickstart install links (#1293)
arittr Apr 28, 2026
831f6f9
docs(codex-tools): fix subagent wait mapping to wait_agent
leonsong09 Apr 28, 2026
28fd7a8
fix(cursor): run SessionStart hook via run-hook.cmd on Windows
starumiQAQ Apr 28, 2026
e795530
fix(tests): make SDD integration test actually run its assertions
Apr 28, 2026
772332a
feat: add Gemini CLI subagent support mapping
Sathvik-1007 Apr 28, 2026
4c7c544
docs: update Codex plugin install guidance (#1288)
arittr Apr 28, 2026
471fe32
Lift superpowers:code-reviewer agent into the requesting-code-review …
Apr 28, 2026
b91965a
Merge remote-tracking branch 'origin/main' into dev
arittr Apr 30, 2026
076de98
Prepare v5.1.0: release notes and version bump
obra Apr 30, 2026
e25f8fa
Merge PR #1240: Add first-class support for Kimi Code 2.6
dilukangelosl May 1, 2026
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
2 changes: 1 addition & 1 deletion .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
{
"name": "superpowers",
"description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques",
"version": "5.0.7",
"version": "5.1.0",
"source": "./",
"author": {
"name": "Jesse Vincent",
Expand Down
2 changes: 1 addition & 1 deletion .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "superpowers",
"description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques",
"version": "5.0.7",
"version": "5.1.0",
"author": {
"name": "Jesse Vincent",
"email": "jesse@fsck.com"
Expand Down
5 changes: 4 additions & 1 deletion .codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "superpowers",
"version": "5.0.7",
"version": "5.1.0",
"description": "An agentic skills framework & software development methodology that works: planning, TDD, debugging, and collaboration workflows.",
"author": {
"name": "Jesse Vincent",
Expand Down Expand Up @@ -36,6 +36,9 @@
"I've got an idea for something I'd like to build.",
"Let's add a feature to this project."
],
"websiteURL": "https://github.com/obra/superpowers",
"privacyPolicyURL": "https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement",
"termsOfServiceURL": "https://docs.github.com/en/site-policy/github-terms/github-terms-of-service",
"brandColor": "#F59E0B",
"composerIcon": "./assets/superpowers-small.svg",
"logo": "./assets/app-icon.png",
Expand Down
67 changes: 0 additions & 67 deletions .codex/INSTALL.md

This file was deleted.

2 changes: 1 addition & 1 deletion .cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"name": "superpowers",
"displayName": "Superpowers",
"description": "Core skills library: TDD, debugging, collaboration patterns, and proven techniques",
"version": "5.0.7",
"version": "5.1.0",
"author": {
"name": "Jesse Vincent",
"email": "jesse@fsck.com"
Expand Down
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -5,3 +5,4 @@
node_modules/
inspo
triage/

57 changes: 57 additions & 0 deletions .kimi/AGENTS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
# Superpowers — Kimi Code Bootstrap

<EXTREMELY_IMPORTANT>
You have superpowers.

You are running with the Superpowers skills framework. Before any task, you MUST check if a skill applies. Even a 1% chance a skill applies means you MUST load it. This is not optional. This is not negotiable.

**How skills work in Kimi Code:**
Kimi Code auto-discovers skills from `.kimi/skills/` and injects their names and descriptions into your system prompt. When a skill might apply, you MUST read its `SKILL.md` automatically or use the `/skill:<name>` slash command. Never improvise when a skill exists.

**Core workflow:** brainstorm → design approval → plan → subagent-driven development → TDD → code review → finish branch. Check for relevant skills at every step.

**Instruction priority:**
1. User's explicit instructions (AGENTS.md, direct requests) — highest priority
2. Superpowers skills — override default system behavior where they conflict
3. Default system prompt — lowest priority

**Tool mapping:** When skills reference Claude Code tools, use your Kimi Code equivalents:
- `Read` → `ReadFile`
- `Write` → `WriteFile`
- `Edit` → `StrReplaceFile`
- `Bash` → `Shell`
- `Grep` → `Grep`
- `Glob` → `Glob`
- `TodoWrite` → `SetTodoList`
- `Task` (subagent) → `Agent`
- `WebSearch` → `SearchWeb`
- `WebFetch` → `FetchURL`
- `Skill` tool → Auto-read the skill's `SKILL.md` or use `/skill:<name>`

**How to invoke skills in Kimi Code:**
Kimi Code auto-discovers skills and lists their names, paths, and descriptions in your system prompt. When a skill's description matches the current task, you MUST read its full SKILL.md file automatically using ReadFile on the path shown in your system prompt BEFORE responding. Do not wait for the user to ask. If you are unsure whether a skill applies, read it anyway — you can discard it if it's not relevant.

Example: If you see "brainstorming: You MUST use this before any creative work..." in your available skills, you MUST immediately use ReadFile to load its full SKILL.md and follow it exactly.

**Red Flags — STOP, you're rationalizing:**

| Thought | Reality |
|---------|---------|
| "This is just a simple question" | Questions are tasks. Check for skills. |
| "I need more context first" | Skill check comes BEFORE clarifying questions. |
| "Let me explore the codebase first" | Skills tell you HOW to explore. Check first. |
| "I remember this skill" | Skills evolve. Read the current version. |
| "This doesn't count as a task" | Action = task. Check for skills. |
| "The skill is overkill" | Simple things become complex. Use it. |
| "I'll just do this one thing first" | Check BEFORE doing anything. |

**Skill Priority:**
1. Process skills first (brainstorming, debugging) — determine HOW to approach
2. Implementation skills second — guide execution

**Skill Types:**
- Rigid (TDD, debugging): Follow exactly. Don't adapt away discipline.
- Flexible (patterns): Adapt principles to context.

The skill itself tells you which.
</EXTREMELY_IMPORTANT>
144 changes: 144 additions & 0 deletions .kimi/INSTALL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,144 @@
# Installing Superpowers for Kimi Code 2.6

## Prerequisites

- [Kimi Code](https://www.moonshot.cn/kimi) installed (terminal CLI or VS Code extension)
- Git
- Bash (macOS/Linux) or PowerShell (Windows)

## Installation

### 1. Clone the superpowers repository

```bash
git clone https://github.com/obra/superpowers.git ~/.kimi/superpowers
```

### 2. Run the install script

The install script copies skills to the cross-compatible `~/.config/agents/skills/` directory and configures a global `SessionStart` hook for bootstrap injection.

**macOS / Linux:**
```bash
~/.kimi/superpowers/.kimi/install.sh
```

**Windows (PowerShell):**
```powershell
& "$env:USERPROFILE\.kimi\superpowers\.kimi\install.ps1"
```

What the script does:
- Copies all skills from the repo to `~/.config/agents/skills/` (the recommended, cross-tool skills path)
- Enables `merge_all_available_skills` in `~/.kimi/config.toml`
- Adds a `SessionStart` hook that injects the Superpowers bootstrap into every session

> **Note:** No symlinks or junctions are created. Skills are copied so they work reliably across all platforms and filesystems.

### 3. Verify

Start Kimi Code in any project directory and ask:

```
Tell me about your superpowers
```

Or try loading a skill explicitly:

```
/skill:using-superpowers
```

You should see the skill content load and the agent announce it.

## What `/init` Does (and Doesn't Do)

Kimi Code's `/init` command analyzes the project and generates a root `AGENTS.md` file. **It does not touch `.kimi/AGENTS.md` or the global SessionStart hook.** If you run `/init` after installing Superpowers:

- Root `AGENTS.md` gets overwritten with Kimi-generated project context
- The global SessionStart hook remains active
- Your skills remain installed in `~/.config/agents/skills/`

## Project-Level Bootstrap (Optional)

If you prefer project-level bootstrap instead of (or in addition to) the global hook, copy the bootstrap file into your project:

```bash
mkdir -p .kimi
cp ~/.kimi/superpowers/.kimi/AGENTS.md .kimi/AGENTS.md
```

**Windows (PowerShell):**
```powershell
New-Item -ItemType Directory -Force -Path ".kimi"
Copy-Item "$env:USERPROFILE\.kimi\superpowers\.kimi\AGENTS.md" ".kimi\AGENTS.md"
```

This file is **not** overwritten by `/init` and is auto-merged into Kimi Code's system prompt at session start.

## Updating

Pull the latest changes and re-run the install script:

**macOS / Linux:**
```bash
~/.kimi/superpowers/.kimi/update.sh
```

**Windows (PowerShell):**
```powershell
& "$env:USERPROFILE\.kimi\superpowers\.kimi\update.ps1"
```

This re-copies skills from the latest repo state and ensures your hook is up to date.

## Uninstalling

Remove the copied skills and hook configuration:

```bash
# Remove copied skills
rm -rf ~/.config/agents/skills

# Remove the SessionStart hook from ~/.kimi/config.toml
# (edit the file manually to remove the [[hooks]] block for SessionStart)

# Remove the cloned repo
rm -rf ~/.kimi/superpowers
```

**Windows (PowerShell):**
```powershell
Remove-Item -Recurse -Force "$env:USERPROFILE\.config\agents\skills"
Remove-Item -Recurse -Force "$env:USERPROFILE\.kimi\superpowers"
# Edit $env:USERPROFILE\.kimi\config.toml to remove the SessionStart hook block
```

## Troubleshooting

### Bootstrap not appearing

1. Confirm the SessionStart hook is in `~/.kimi/config.toml`
2. Restart Kimi Code (hooks are read at session start)
3. If using the VS Code extension, run "Developer: Reload Window" from the Command Palette
4. As a fallback, copy `.kimi/AGENTS.md` into your project directory

### Skills not showing up

1. Verify skills exist: `ls ~/.config/agents/skills/` or `dir $env:USERPROFILE\.config\agents\skills\`
2. Check that `merge_all_available_skills = true` is set in `~/.kimi/config.toml`
3. Restart Kimi Code — skills are discovered at startup
4. Try `/skill:using-superpowers` to confirm skills are accessible

### Subagent skills not working

Ensure your Kimi Code version supports the `Agent` tool. Subagent-driven development requires true subagent dispatch.

### Tool mapping confusion

See `.kimi/TOOL_MAPPING.md` for the complete mapping of Claude Code tools to Kimi Code equivalents.

## Getting Help

- Report issues: https://github.com/obra/superpowers/issues
- Full documentation: [docs/README.kimi.md](../docs/README.kimi.md)
59 changes: 59 additions & 0 deletions .kimi/TOOL_MAPPING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
# Kimi Code 2.6 Tool Mapping

Skills use Claude Code tool names. When you encounter these in a skill, use your platform equivalent:

| Skill references | Kimi Code 2.6 equivalent |
|-----------------|--------------------------|
| `Read` (file reading) | `ReadFile` |
| `Write` (file creation) | `WriteFile` |
| `Edit` (file editing) | `StrReplaceFile` |
| `Bash` (run commands) | `Shell` |
| `Grep` (search file content) | `Grep` |
| `Glob` (search files by name) | `Glob` |
| `TodoWrite` (task tracking) | `SetTodoList` |
| `Skill` tool (invoke a skill) | Auto-discovery + `/skill:<name>` slash command |
| `WebSearch` | `SearchWeb` |
| `WebFetch` | `FetchURL` |
| `Task` tool (dispatch subagent) | `Agent` |
| `EnterPlanMode` / `ExitPlanMode` | `EnterPlanMode` / `ExitPlanMode` |

## Skill Discovery and Loading

Kimi Code 2.6 has native skill discovery. When Superpowers is installed:

1. **Auto-discovery**: Kimi Code scans `~/.config/agents/skills/` at startup, parses `SKILL.md` frontmatter, and injects skill names and descriptions into the system prompt.
2. **Auto-triggering**: The AI automatically reads skill content when it determines a skill is relevant to the current task.
3. **Explicit loading**: Use `/skill:<name>` to force-load a skill. Examples:
- `/skill:using-superpowers`
- `/skill:brainstorming`
- `/skill:test-driven-development`

When a skill references the `Skill` tool (Claude Code's native skill invocation), interpret it as: "Ensure the skill is loaded and follow its instructions." Kimi Code handles this via auto-discovery or `/skill:<name>`.

## Subagent Support

Kimi Code 2.6 **does** support true subagent dispatch via the `Agent` tool:

- Isolated context per subagent instance
- Built-in types: `coder`, `explore`, `plan`
- Supports `run_in_background=true` for parallel execution
- Use `subagent_type="explore"` for read-only research tasks
- Use `subagent_type="coder"` for implementation tasks

Skills like `subagent-driven-development` and `dispatching-parallel-agents` work correctly with Kimi Code's `Agent` tool.

## Additional Kimi Code 2.6 Tools

These tools are available in Kimi Code but have no Claude Code equivalent:

| Tool | Purpose |
|------|---------|
| `AskUserQuestion` | Request structured input from the user with multiple-choice options |
| `Think` | Record thinking process for complex reasoning |
| `TaskList` | List background tasks |
| `TaskOutput` | Retrieve output from background tasks |
| `TaskStop` | Stop a running background task |

## Background Tasks

Kimi Code supports background task execution via `Shell` with `run_in_background=true` or `Agent` with `run_in_background=true`. Use `TaskList`, `TaskOutput`, and `TaskStop` to manage long-running processes.
Loading