Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

opencode-setup-kit

One-folder installer that turns a fresh Windows PC into a fully-configured opencode workstation in one command: working rules, tiered memory system, subagents, slash commands, skills, expert playbooks, organized workspace skeleton, and crash-resume tooling.

New to this? Follow the zero-assumptions walkthrough: SETUP-GUIDE.md — every step with exact commands and checks.

Quick start (target PC)

# 1. copy this folder over (USB / network / git clone), then:
cd opencode-setup-kit
powershell -ExecutionPolicy Bypass -File install.ps1          # defaults: workspace = D:\OpenCode Projects
#   options:  -WorkspaceRoot "E:\My Projects"   -Name "Your Name"   -SkipOpencodeInstall

# 2. open a NEW terminal, sign in with YOUR OWN account:
opencode auth login

# 3. work:
oc        # start opencode — rules + memory auto-load every session
ocr       # after any crash / power cut: reopen last session exactly where you left off

What you get

Layer Details
Master rules (AGENTS.md) Auto-loaded every session: research-first workflow, memory discipline, crash resilience, self-improvement loop, surgical-change & simplicity coding rules
Tiered memory (Desktop\opencode\) Hot memory.md (≤15KB hard budget, read fully each session, RESUME checkpoints) + cold memory-archive.md (grep-on-demand history). Survives crashes and sessions forever
6 subagents (agent\) android-dev, apk-cloner, web-dev, website-cloner, github-publisher, vision
7 slash commands (command\) /checkpoint /commit /publish /release /new-project /clone-website /clone-apk
5 domain skills (skill\) web-development, website-cloning, android-development, apk-modding, github-publishing
7 expert playbooks Deep how-to docs loaded into the agent's reference config
Workspace skeleton Categorized project root: Web Development · Mobile Apps · PC Apps · Development · AI-ML · Academic · Research · Presentations · References{Websites,APKs,Designs} · Playbooks · Scripts · Tools · Backups · Downloads · Miscellaneous
Config (opencode.jsonc) SSE timeout auto-retry (survives flaky networks), full-permission mode (zero prompts), auto-compaction, watcher ignores, autoupdate
Crash-resume ocr/oc PowerShell functions, Desktop "OpenCode Resume" shortcut, UTF8-corruption guard in profile
Safety net Existing configs are backed up before install; every step verified at the end

Design decisions

  • Copy, not symlink — Windows symlinks need admin/dev-mode; copies just work. Run update.ps1 on the source PC to refresh the kit from its live config.
  • Static context > skills for critical rules — per Vercel's agent evals, AGENTS.md-loaded rules are followed ~100% vs ~44% for on-demand skills. Critical discipline lives in AGENTS.md; skills stay as optional deep-dives.
  • Placeholders, not identities — all files ship with <YOUR NAME> / %USERPROFILE% tokens so anyone can adopt it. The installer fills machine paths automatically.
  • Full permission mode — the agent never asks for confirmation (bash/edit/webfetch all auto-approved). Powerful and convenient; only use on machines you control.

Maintenance (source PC)

powershell -ExecutionPolicy Bypass -File update.ps1     # re-sync agents/commands/skills/playbooks from live config + auto-sanitize
# AGENTS.md + opencode.jsonc are hand-maintained templates ({{TOKENS}}) — edit directly, don't overwrite
git commit -am "update kit" && git push                 # keep the repo current

Requirements

  • Windows 10/11, PowerShell 5.1+ (built-in)
  • Node.js (for npm install of opencode) or scoop/choco — installer detects what's available
  • An opencode account (opencode auth login) — free

License

MIT — see LICENSE.

About

One-command opencode workstation setup for Windows: rules, tiered memory, agents, commands, skills, playbooks, crash-resume

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages