NOTE:
On current implementation, Opencode is not usable. Some of the codes are missing from the github. According to the author, the code need to be pushed into the main repo so the template can be working.
Second, Opencode refused to auto-submit to GIT making the journey broken. I was forced to commit a whole bunch of changes in the end of a run. Let’s just wait.
TL;DR:
- Install prerequisites: Opencode CLI, Astral UV, Git.
- Initialize a new Spec Kit project.
- Verify Opencode configuration.
- Use Spec Kit commands in Opencode CLI for spec-driven development.
Step-by-Step Integration Guide
Step 1: Initialize Spec Project
Create a new project directory with GitHub Spec Kit configured for Opencode CLI.
Option A: New Project Directory
uvx --from git+https://github.com/aemr3/spec-kit.git specify init --ai opencode <PROJECT_NAME>
cd <PROJECT_NAME>
Replace <PROJECT_NAME> with your desired project name.
Option B: Current Directory
Initialize Spec Kit in your current directory.
uvx --from git+https://github.com/aemr3/spec-kit.git specify init --ai opencode --here
Step 2: Verify Configuration
After initialization, verify the setup.
ls -la
opencode config list
ls -la AGENTS.md
Step 3: Test Integration
Launch Opencode CLI and test Spec Kit commands.
opencode
/specify Create a simple web application with user authentication
/plan Use React for frontend, Node.js for backend, PostgreSQL for database
/tasks
Usage Examples
Basic Spec Creation
Create a simple spec and generate a plan.
/specify Build a REST API for user management with authentication
/plan Use FastAPI for backend, PostgreSQL for data, JWT for auth
/tasks
Advanced Research Integration
Research technologies first, then plan a complex system.
/specify Create a microservices architecture for an e-commerce platform
/plan Research Kubernetes deployment, service mesh, API gateway
Constitution Compliance
Check if your spec follows simplicity rules.
/specify Build a monolithic application with 6 services
The system warns about complexity and suggests fewer services.
