ai-agent

Superpowers

Name: Superpowers
Author: obra

An agentic skills framework & software development methodology that works.

264,191 stars23,585 forksShellUpdated 7/28/2026100% free · open source

What it does

Superpowers is an AI-agent framework and software development methodology that enables founders to build autonomous systems that can learn, reason, and act on their behalf.

Install / run

git clone https://github.com/obra/superpowers.git && cd superpowers

When to use it

•When building autonomous systems that require decision-making and problem-solving capabilities
•When integrating multiple AI models and services into a single workflow
•When developing applications that need to adapt to changing environments and user needs

Quick start

1Run `./superpowers init` to create a new project scaffold
2Edit the `config.yaml` file to define the agent's goals and behaviors
3Use `./superpowers run` to start the agent and observe its behavior
4Modify the `agents` directory to add custom agent implementations
5Use `./superpowers visualize` to visualize the agent's decision-making process

Ready-to-paste prompt

./superpowers run --goal 'maximize_user_engagement' --env 'production'

Heads up: Make sure to set the `SUPERPOWERS_LICENSE_KEY` environment variable before running the agent, as it requires a valid license key to operate

Saves to your device

Topics

brainstorming

coding

obra

sdlc

skills

subagent-driven-development

superpowers

How Superpowers works

Codeflow

Free to inspect

Superpowers is a medium Shell project (~10k lines across 62 code files). You install it into your AI tool with one command; there is nothing to run yourself. Last commit this month, MIT license, has a test suite.

Size

Medium codebase

~10k lines · 62 code files · ~1 h to skim

Setup

Install as a skill / plugin

Add it to Claude Code (or your AI tool) with one command — 14 skills inside. Nothing to run yourself.

Runs on

Inside your AI tool

Helper scripts use Node.js

Shell 54%JavaScript 36%Python 5%TypeScript 2%HTML 2%

Where to start reading

1
README.md
Start here — what it does and how to install it
2
AGENTS.md
The instructions the AI actually follows
3
package.json
Dependencies and the commands it exposes
4
skills/brainstorming/SKILL.md
Inside skills/ — an example of what the AI is told to do

What's in each folder

tests/Tests — proof it works59 files

skills/Prompts, skills & agent definitions51 files

docs/Documentation43 files

.github/CI / automation (GitHub Actions)6 files

hooks/Hooks — scripts that auto-run on events4 files

scripts/Helper scripts4 files

.claude-plugin/Plugin manifest — what gets installed2 files

.hermes-plugin/Plugin manifest — what gets installed2 files

READMEHas testsDocumentedMIT licenseUpdated this month

Quick Actions

Details