opencode-dx

A collection of agents, templates, and workflows for agentic assistance in development work

Quick Start • Agents • Sync

Version-control and easily sync your custom OpenCode configurations, agents, and templates across multiple WSL and Linux devices — without exposing your private API keys.

---

Quick Start

Clone and run on any new WSL environment:

git clone https://github.com/Jzbonner/opencode-dx.git ~/repos/opencode-dx
cd ~/repos/opencode-dx
./setup.sh
source ~/.bashrc

Then add your actual API keys to ~/.keys/tavily and ~/.keys/jina.**

After setup, restart opencode to load the new agent definitions.

---

What the Setup Script Does

The setup.sh script automates the entire configuration lifecycle:

Step	Action
1	Creates ~/.keys/ with empty template files if missing
2	Appends a secure key-loader snippet to ~/.bashrc
3	Backs up any existing ~/.config/opencode/ files to .bak
4	Creates symlinks from ~/.config/opencode/ → your repo files
5	Runs npm install to restore plugins and dependencies

Any edits made to agents/ or opencode.jsonc in this repo are immediately active in OpenCode.

---

Agents

All custom agents live in agents/. Current registry:

• StackScaffolder — scaffolds Web (Vite+React+TS), Mobile (Expo SDK 52+), Python (FastAPI/scripts), and Pixi (cross-language) projects with Supabase, Tailwind/NativeWind, and minimal directory structures
• CodeSentinel — automated quality gate: auto-fixes lint/format, runs security scans, executes tests on-demand, outputs pass/fail verdict for git hook integration
• DataBridge — Supabase and PostgreSQL management: TypeScript type generation, SQL migration drafting, client query generation, and schema/RLS reporting
• ContentArchitect — content creation with two modes: Research (deep-dive with web search via Tavily/Jina.ai, saved to Obsidian vault) and Quick Read (concise posts in 7 writing styles)
• ContentBridge — transforms long-form articles into platform-optimized posts for X, LinkedIn, Dev.to, and Personal Blog with 7 configurable writing styles

See AGENTS.md for details and instructions on adding new agents.

---

Keeping Configs in Sync

On your active device:

git add .
git commit -m "feat: add new agent or template"
git push

On other devices:

cd ~/repos/opencode-dx
git pull
./setup.sh