opencode-lisa

An intelligent epic workflow plugin for OpenCode. Like the Ralph Wiggum pattern, but smarter.

Latest version: 0.2.0 - Now fully self-contained for npm installation!

Why Lisa?

The Ralph Wiggum pattern is a simple bash loop that keeps feeding prompts to an AI agent until completion. It works, but:

• Ralph is dumb - he just loops forever with the same prompt
• No planning - dives straight into coding
• No context management - context window fills with garbage
• No task dependencies - can't parallelize or sequence work properly

Lisa plans before she acts:

• Structured phases - spec, research, plan, then execute
• Dependency-aware tasks - knows what can run in parallel
• Fresh context per task - each task runs in a sub-agent with clean context
• State persistence - survives session restarts, tracks progress
• Yolo mode - fully autonomous execution when you want it

Install

npm install -D opencode-lisa
npx opencode-lisa init

This will:

• Install command and skill files to .opencode/
• Add the plugin to your opencode.json
• Set up Lisa for use in your project

Requires OpenCode 1.0+.

Global Installation

To install Lisa globally for all projects:

npm install -g opencode-lisa
npx opencode-lisa init --global

Add to your global ~/.config/opencode/opencode.json:

{
  "plugin": ["opencode-lisa"]
}

Usage

/lisa help                 - Show all commands
/lisa <name>               - Start or continue an epic
/lisa <name> spec          - Create the spec only
/lisa <name> yolo          - Full auto mode (no confirmations)
/lisa <name> status        - Show progress
/lisa list                 - List all epics

How It Works

Lisa breaks large features into phases:

1. Spec - Define what you're building (interactive)
2. Research - Explore the codebase to understand context
3. Plan - Break into discrete tasks with dependencies
4. Execute - Run tasks via sub-agents with fresh context

All state is persisted to .lisa/epics/ so you can stop and resume anytime.

Configuration

Config lives in .lisa/config.jsonc:

{
  "git": {
    "completionMode": "none", // "none" | "commit" | "pr"
  },
  "yolo": {
    "defaultMaxIterations": 100,
  },
}

In default mode, Lisa does NOT make commits or PRs. If you want to make commits you'll need git set up, and if you want to make PRs you'll need the github cli set up.

License

MIT