Skip to content

docs: refresh for OpenCode v1.17.13, add Go coverage, and rebrand#5

Merged
wesammustafa merged 1 commit into
mainfrom
docs/opencode-v1.17-rebrand
Jul 5, 2026
Merged

docs: refresh for OpenCode v1.17.13, add Go coverage, and rebrand#5
wesammustafa merged 1 commit into
mainfrom
docs/opencode-v1.17-rebrand

Conversation

@wesammustafa

Copy link
Copy Markdown
Owner

Summary

Full end-to-end refresh of the guide from the v1.16.2 baseline to OpenCode v1.17.13 (2026-07-01), plus a research-backed rebrand. Every version number, price, and stat below was verified against primary sources (GitHub releases API, npm registry, opencode.ai docs/changelog) on 2026-07-05.

Version refresh (v1.16.2 → v1.17.13, 14 releases)

  • New v1.17.x changelog section: session snapshots/revert (v1.17.11), TUI yolo mode + adaptive thinking for Claude Sonnet 5 (v1.17.12), --mini CLI mode + MCP resources + V2 plugin API (v1.17.10), MCP cwd option (v1.17.4), referencereferences deprecation (v1.17.1), WSL desktop + fff file search (v1.17.0)
  • Zen tables re-synced: Claude Fable 5 ($10/$50) and Claude Sonnet 5 ($2/$10) added; Opus 4.1 / Sonnet 4 / Haiku 3.5 dropped; new free-tier model north-mini-code-free; new deprecation sunset-dates table
  • Model pins bumped claude-sonnet-4-5claude-sonnet-5 across all examples, configs, and agent prompts

New coverage (top community questions)

  • OpenCode Go vs Zen — flat-rate $10/mo subscription vs per-token gateway (README, docs/zen.md, FAQ)
  • Claude Pro/Max subscription login removal (March 2026, anthropic legal requests anomalyco/opencode#18186) — what it means and the API-key/Zen alternatives (README, FAQ, migration guide)
  • MCP resources, --auto flag (replacing --dangerously-skip-permissions), yolo mode

Correctness fixes

  • .opencode/commands/*.md used bare !cmd — shell injection never executed; now the documented !cmd form (also fixed in docs/commands.md examples)
  • protect-secrets.js regex didn't block cat .env; both plugins double-registered hooks via dual exports
  • quickstart PATH fix pointed at ~/.local/bin instead of ~/.opencode/bin
  • Playwright MCP walkthrough used nonexistent BROWSER_TYPE/BROWSER_HEADED vars; headless/persistence claims were inverted
  • agents/commands "required field" claims, subtask semantics, ctrl+d keybind conflict, AGENTS.md repo-tree drift
  • SECURITY.md/CoC pointed at nonexistent "confidential issues" — now GitHub private vulnerability reporting
  • Link rot: cursor.com, windsurf.com (ex-Codeium), platform.claude.com / code.claude.com migrations, opencode.ai/discord, Vercel Grep announcement

Rebrand

  • New banner (Images/banner.svg) + 1280×640 social-preview asset (Images/social-preview.png, ready for Settings → Social preview)
  • Hero redesign: banner, stars badge, star CTA, verified ecosystem stats (most-starred coding agent, 182K+ stars)
  • Landscape updates: Gemini CLI retirement, Codex CLI, Windsurf; Aider slowdown noted
  • Repo description + 18 topics already applied via gh repo edit
  • CONTRIBUTING/AGENTS.md now document the actual CI checks; MD060 lint opt-out future-proofs the markdownlint action

Test plan

  • npx markdownlint-cli2 "**/*.md" — 0 errors
  • codespell with repo ignore list — clean
  • node --check on both plugins; regex verified to block cat .env and pass cat env-config.md
  • All internal relative links + anchors validated
  • opencode.json / tui.json parse against their schemas

🤖 Generated with Claude Code

- Bump every version pin, pricing table, and model ID to the verified
  2026-07-05 state (v1.17.13): Claude Fable 5 / Sonnet 5 on Zen, new
  free tier, deprecation sunset table, v1.17.x changelog section
- Cover gaps: OpenCode Go vs Zen billing, Anthropic subscription-login
  removal (PR #18186), MCP resources, --mini mode, --auto flag, yolo mode
- Fix correctness bugs: command-template !`cmd` syntax in docs and
  .opencode/commands, protect-secrets regex missing 'cat .env', dual
  plugin exports, quickstart PATH fix, Playwright MCP flags, ctrl+d
  keybind conflict, agent/command required-field claims
- Fix links: cursor.com, windsurf.com, platform.claude.com,
  code.claude.com, opencode.ai/discord, Vercel Grep announcement
- Rebrand: banner (Images/banner.svg), 1280x640 social preview asset,
  hero redesign with star CTA, ecosystem stats, private vulnerability
  reporting channel, CI-matching local checks, MD060 lint opt-out
@wesammustafa wesammustafa merged commit 064ee20 into main Jul 5, 2026
5 of 6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant