Lisa - intelligent epic workflow plugin for OpenCode. Like Ralph Wiggum, but smarter.
npm install opencode-lisaAn intelligent epic workflow plugin for OpenCode. Like the Ralph Wiggum pattern, but smarter.
Latest version: 0.3.0 - Simplified one-command installation!
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
One command to install Lisa in your project:
``bash`
npx opencode-lisa --opencode
Or with Bun:
`bash`
bunx opencode-lisa --opencode
This creates an opencode.json file with Lisa configured. The plugin will be automatically downloaded by OpenCode when you start it.
Requires OpenCode 1.0+.
To use Lisa in all your projects, add to your global OpenCode config:
`bash`Create or edit ~/.config/opencode/opencode.json
`json`
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["opencode-lisa"]
}
`
/lisa help - Show all commands
/lisa
/lisa
/lisa
/lisa
/lisa list - List all epics
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.
Config lives in .lisa/config.jsonc:
`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.
MIT