https://github.com/moyaspace/openspec-superpowers-opencode
CLI scaffold that bridges Superpowers + OpenSpec workflows into OpenCode.
https://github.com/moyaspace/openspec-superpowers-opencode
bridge cli git-worktree isolation opencode openspec scaffold spec-driven-development superpowers template workflow
Last synced: 8 days ago
JSON representation
CLI scaffold that bridges Superpowers + OpenSpec workflows into OpenCode.
- Host: GitHub
- URL: https://github.com/moyaspace/openspec-superpowers-opencode
- Owner: moyaspace
- License: mit
- Created: 2026-05-22T14:45:57.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-25T16:34:48.000Z (2 months ago)
- Last Synced: 2026-05-25T16:36:19.258Z (2 months ago)
- Topics: bridge, cli, git-worktree, isolation, opencode, openspec, scaffold, spec-driven-development, superpowers, template, workflow
- Language: PowerShell
- Homepage: https://www.npmjs.com/package/@moyaspace/openspec-superpowers-opencode
- Size: 229 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# oso (openspec-superpowers-opencode)
> Bridges Superpowers + OpenSpec workflows into OpenCode with enforced worktree isolation.
[](https://github.com/moyaspace/openspec-superpowers-opencode/actions)
[](https://github.com/moyaspace/openspec-superpowers-opencode)
[](https://github.com/moyaspace/openspec-superpowers-opencode)
[](https://www.npmjs.com/package/@moyaspace/openspec-superpowers-opencode)
[](https://www.npmjs.com/package/@moyaspace/openspec-superpowers-opencode)
[](https://www.npmjs.com/package/@moyaspace/openspec-superpowers-opencode)
[](https://github.com/moyaspace/openspec-superpowers-opencode)
> If you find this useful, consider giving it a β on GitHub!
**π Read this in other languages:** [English](README.md) | [δΈζ](docs/README.zh.md)
---
## The Problem
Install **OpenSpec** and **Superpowers** separately, and you get two powerful but disconnected tools.
OpenSpec gives you artifact-driven development β brainstorm β specs β tasks β plan.
Superpowers gives you battle-tested methodologies β brainstorming, writing-plans, TDD.
But out of the box, they don't talk to each other. OpenSpec generates generic artifacts, Superpowers skills sit in a separate cache directory, and there's nothing connecting them into a unified workflow.
You can use both, but you'll spend more time stitching them together than actually building features.
And even if you do wire them up, you're still stuck with a **single working tree** β one change at a time. Want to add login and search simultaneously? Context collision, partial commits, reverting. You either wait, or you break things.
**oso bridges the gap and adds isolation.**
## The oso Solution
oso is a developer CLI toolset that integrates OpenSpec and Superpowers workflows into OpenCode: one-command init, enforced worktree isolation, active change registry tracking, native command interception with passthrough, and system health verification.
```
ββ .worktrees/feature-a/ (feature/feature-a branch)
main ββββββΌβ .worktrees/feature-b/ (feature/feature-b branch)
ββ .worktrees/feature-c/ (feature/feature-c branch)
```
```bash
# Create two changes simultaneously
/opsx-ff feature-a
/opsx-ff feature-b
# Work on feature-a
/opsx-apply feature-a # AI auto-cds into .worktrees/feature-a/
# ... write code ...
# Switch to feature-b (no need to finish feature-a first)
/opsx-apply feature-b # AI auto-cds into .worktrees/feature-b/
# ... write code ...
# Finish independently
/opsx-finish feature-a # test β merge β cleanup
/opsx-finish feature-b
```
## Quick Start
```bash
# 1. Install
npm install -g @moyaspace/openspec-superpowers-opencode
# 2. Init a project
mkdir my-project && cd my-project
openspec-superpowers-opencode init
# 3. Open in OpenCode, then use the workflow
/opsx-ff add-user-auth # create change + generate artifacts
/opsx-apply # AI implements in isolated worktree
/opsx-finish # test β merge β cleanup
```
## Features
| # | Feature | One-liner |
|---|---------|-----------|
| 1 | **12 OPSX commands** | `/opsx-ff` β `/opsx-apply` β `/opsx-finish` β full change lifecycle |
| 2 | **Git worktree isolation** | Each change in its own `.worktrees//` dir + `feature/` branch |
| 3 | **One-command init** | `oso init` β deploy templates + config + `git init` + first commit |
| 4 | **Bridged OpenSpec + Superpowers** | Pre-configured schema + skill mapping + lock verification, one-command deploy |
| 5 | **Greenfield/brownfield** | Auto-deploy on new projects; safe merge on existing ones |
| 6 | **Cross-platform + i18n** | Windows `setup.ps1` / Linux `setup.sh`, `--lang zh-CN \| zh-TW \| en` |
| 7 | **SHA-256 lock** | Skill file integrity verified on deploy |
| 8 | **Layered architecture** | Superpowers (HOW) β OpenSpec (WHAT) β Worktree (WHERE) β Commands (WHEN) |
| 9 | **Full worktree + openspec change support** | Auto-register on change creation, smart `openspec list` interception, `verify` one-click health check |
| 10 | **High-performance Worktree code search** | CodeGraph integrated in worktree, auto-indexed for high-performance code search |
> Detailed features β [docs/FEATURES.md](docs/FEATURES.md)
## Documentation
| Doc | Description |
|-----|-------------|
| [Quick start](docs/QUICKSTART.md) | 10-minute first change |
| [How it works](docs/HOW-IT-WORKS.md) | Command execution chain explained |
| [Worktree creation](docs/WORKTREE-CREATION.md) | Three-layer code-level guarantees |
| [Design decisions](docs/DESIGN.md) | ADRs: architecture tradeoffs |
| [Testing](docs/TESTING.md) | 17-phase test suite |
| [Why oso](docs/WHY-OSO.md) | Deep dive: 6 gaps between OpenSpec and Superpowers |
## Prerequisites
- Node.js >= 16 (recommended)
- `openspec` CLI v1.3+
- `opencode` CLI
- `git`
- Superpowers plugin
Setup script checks these automatically.
## Local Development
```bash
node bin/cli.js init test-project # test locally
npm publish # publish to npm
```
---
**GitHub**: https://github.com/moyaspace/openspec-superpowers-opencode
**npm**: https://www.npmjs.com/package/@moyaspace/openspec-superpowers-opencode
**Author**: rl robincn@gmail.com
**License**: MIT