https://github.com/markerikson/opencode-config-example
A cleaned-up version of my own OpenCode config for use as a reference
https://github.com/markerikson/opencode-config-example
Last synced: about 1 month ago
JSON representation
A cleaned-up version of my own OpenCode config for use as a reference
- Host: GitHub
- URL: https://github.com/markerikson/opencode-config-example
- Owner: markerikson
- License: mit
- Created: 2026-05-06T21:59:21.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-07T12:35:13.000Z (3 months ago)
- Last Synced: 2026-06-19T18:37:31.223Z (about 1 month ago)
- Language: TypeScript
- Size: 144 KB
- Stars: 41
- Watchers: 0
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# OpenCode AI Development Workflow Config
Reference configuration for [OpenCode](https://opencode.ai), published alongside my blog posts on how I learned to use AI and my actual AI development workflow:
- [My Thoughts on AI, Part 1: Fears, Opinions, and Mental Journey](https://blog.isquaredsoftware.com/2026/04/ai-thoughts-part-1-fears-opinions-journey/)
- [My Thoughts on AI, Part 2: Agent Setup, Workflow, and Tools](https://blog.isquaredsoftware.com/2026/04/ai-thoughts-part-2-agent-workflow-tools/)
This is a sanitized snapshot of my actual daily-use config. API keys and personal paths have been replaced with placeholders.
## Structure
### `config/`
Drop-in contents for `~/.config/opencode/`. Key pieces:
- **`AGENTS.md`** — Global behavioral rules: response style, thinking protocols, git policy, coding standards, documentation workflow
- **`opencode.json`** — Model preferences, MCP servers, permissions, plugin config
- **`agent/`** — Subagent definitions (docs writer, orchestrator, code reviewer, test engineer)
- **`command/`** — Slash commands (`/context`, `/progress`, `/architecture`, etc.)
- **`skill/`** — 23 domain-specific knowledge modules loaded on demand
- **`plugin/`** — Custom tool extensions (permission checker, context-aware caching, session search, token usage analysis)
- **`scripts/`** — Helper utilities for dev-plans management, session extraction, cost tracking
### `dev-plans/`
Example structure for a separate work-tracking repo. See [`dev-plans/README.md`](dev-plans/README.md).
## Getting Started
1. Copy `config/` contents to `~/.config/opencode/`
2. Edit `opencode.json` — add your API keys, adjust model preferences
3. Edit `AGENTS.md` — customize the "About the User" section and path references
4. Edit `scripts/config.json` — set your dev-plans path and project mappings
5. Search for `YOUR_` placeholders across all files and replace with your values
## License
MIT