Compare commits

..
Author SHA1 Message Date
Drew RitterandClaude Fable 5 2783fb9145 docs: drop Hermes post-compaction caveat from README install block
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-07 16:50:31 -07:00
Drew RitterandClaude Fable 5 d3f0f13a87 docs: add Hermes Agent to TOC and fix section order
Hermes Agent was in the Quickstart list and had an install section, but
was missing from the Table of Contents and its section sat after Pi,
out of the alphabetical order the other harnesses follow. Section text
moved verbatim.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-07 16:37:51 -07:00
Drew RitterandClaude Fable 5 96c005307e docs: add Qwen Code install instructions to README
Qwen Code installs Claude Code marketplace plugins natively
(qwen extensions install obra/superpowers) and loads the extension's
GEMINI.md context and skills, so no integration work is needed —
only install docs.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-07 16:02:02 -07:00
2 changed files with 30 additions and 20 deletions
+30 -10
View File
@@ -4,9 +4,10 @@ Superpowers is a complete software development methodology for your coding agent
## Table of Contents ## Table of Contents
- [Quickstart](#quickstart)
- [How it works](#how-it-works) - [How it works](#how-it-works)
- [Commercial Services](#commercial-services) - [Commercial Services](#commercial-services)
- [Getting Started](#installation) - [Installation](#installation)
- [Claude Code](#claude-code) - [Claude Code](#claude-code)
- [Antigravity](#antigravity) - [Antigravity](#antigravity)
- [Codex App](#codex-app) - [Codex App](#codex-app)
@@ -17,10 +18,11 @@ Superpowers is a complete software development methodology for your coding agent
- [Gemini CLI](#gemini-cli) - [Gemini CLI](#gemini-cli)
- [GitHub Copilot CLI](#github-copilot-cli) - [GitHub Copilot CLI](#github-copilot-cli)
- [Grok Build CLI](#grok-build-cli) - [Grok Build CLI](#grok-build-cli)
- [Hermes Agent](#hermes-agent)
- [Kimi Code](#kimi-code) - [Kimi Code](#kimi-code)
- [OpenCode](#opencode) - [OpenCode](#opencode)
- [Pi](#pi) - [Pi](#pi)
- [Hermes Agent](#hermes-agent) - [Qwen Code](#qwen-code)
- [The Basic Workflow](#the-basic-workflow) - [The Basic Workflow](#the-basic-workflow)
- [Community](#community) - [Community](#community)
- [What's Inside](#whats-inside) - [What's Inside](#whats-inside)
@@ -30,6 +32,10 @@ Superpowers is a complete software development methodology for your coding agent
- [License](#license) - [License](#license)
- [Visual companion telemetry](#visual-companion-telemetry) - [Visual companion telemetry](#visual-companion-telemetry)
## Quickstart
Give your agent Superpowers: [Claude Code](#claude-code), [Antigravity](#antigravity), [Codex App](#codex-app), [Codex CLI](#codex-cli), [Cursor](#cursor), [Devin CLI](#devin-cli), [Factory Droid](#factory-droid), [Gemini CLI](#gemini-cli), [GitHub Copilot CLI](#github-copilot-cli), [Grok Build CLI](#grok-build-cli), [Hermes Agent](#hermes-agent), [Kimi Code](#kimi-code), [OpenCode](#opencode), [Pi](#pi), [Qwen Code](#qwen-code).
## How it works ## How it works
It starts from the moment you fire up your coding agent. As soon as it sees that you're building something, it *doesn't* just jump into trying to write code. Instead, it steps back and asks you what you're really trying to do. It starts from the moment you fire up your coding agent. As soon as it sees that you're building something, it *doesn't* just jump into trying to write code. Instead, it steps back and asks you what you're really trying to do.
@@ -197,6 +203,16 @@ Superpowers is available via the [official Grok plugin marketplace](https://gith
/marketplace /marketplace
``` ```
### Hermes Agent
Install Superpowers as a Hermes plugin from this repository:
```bash
hermes plugins install obra/superpowers --enable
```
Restart any active Hermes sessions after installing.
### Kimi Code ### Kimi Code
Superpowers is available in Kimi Code's plugin marketplace. Superpowers is available in Kimi Code's plugin marketplace.
@@ -246,17 +262,21 @@ pi -e /path/to/superpowers
The Pi package loads the Superpowers skills and a small extension that injects the `using-superpowers` bootstrap at session startup and again after compaction. Pi has native skills, so no compatibility `Skill` tool is required. Subagent and task-list tools remain optional Pi companion packages. The Pi package loads the Superpowers skills and a small extension that injects the `using-superpowers` bootstrap at session startup and again after compaction. Pi has native skills, so no compatibility `Skill` tool is required. Subagent and task-list tools remain optional Pi companion packages.
### Hermes Agent ### Qwen Code
Install Superpowers as a Hermes plugin from this repository: Qwen Code installs plugins from Claude Code marketplaces directly.
```bash - Install the plugin from this repository, and pick `superpowers` when prompted:
hermes plugins install obra/superpowers --enable
```
Restart any active Hermes sessions after installing. Note: Hermes has no ```bash
post-compaction hook, so a very long session that compacts over its first qwen extensions install obra/superpowers
turn loses the bootstrap — start a fresh session if skills stop triggering. ```
- Update later:
```bash
qwen extensions update superpowers
```
## The Basic Workflow ## The Basic Workflow
-10
View File
@@ -182,16 +182,6 @@ Confirm:
**Other tests fail?** Fix now. **Other tests fail?** Fix now.
**"Other tests" means the project's suite, not just your file.** A
green run of the test you wrote is not a green suite. Before you call
the change done, run the project's test command (bare `pytest`,
`npm test`, `cargo test` — whatever the repo uses) even when your task
named only one test file. A scope statement in your task bounds the
deliverable, not your verification. Any failure that run shows —
including one you didn't cause — goes in your report by name; a red
test you watched scroll past and didn't mention is a report falsified
by omission.
### REFACTOR - Clean Up ### REFACTOR - Clean Up
After green only: After green only: