{"id":49301085,"url":"https://github.com/ab1nv/opencode-max","last_synced_at":"2026-04-26T07:01:33.986Z","repository":{"id":353880538,"uuid":"1221272977","full_name":"ab1nv/opencode-max","owner":"ab1nv","description":"Turn vanilla OpenCode into a better AI coding assistant.","archived":false,"fork":false,"pushed_at":"2026-04-26T02:22:30.000Z","size":58,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-04-26T03:31:52.440Z","etag":null,"topics":["claude-code","codex","llm","ollama","opencode"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ab1nv.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"buy_me_a_coffee":"ab1nv"}},"created_at":"2026-04-26T01:23:09.000Z","updated_at":"2026-04-26T02:22:33.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ab1nv/opencode-max","commit_stats":null,"previous_names":["ab1nv/opencode-max"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/ab1nv/opencode-max","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ab1nv%2Fopencode-max","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ab1nv%2Fopencode-max/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ab1nv%2Fopencode-max/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ab1nv%2Fopencode-max/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ab1nv","download_url":"https://codeload.github.com/ab1nv/opencode-max/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ab1nv%2Fopencode-max/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32288653,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T06:26:00.361Z","status":"ssl_error","status_checked_at":"2026-04-26T06:25:58.791Z","response_time":129,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","codex","llm","ollama","opencode"],"created_at":"2026-04-26T07:01:33.169Z","updated_at":"2026-04-26T07:01:33.971Z","avatar_url":"https://github.com/ab1nv.png","language":"Shell","funding_links":["https://buymeacoffee.com/ab1nv"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/OpenCode-MAX-fe8019?style=for-the-badge\u0026logoColor=white\" alt=\"OpenCode MAX\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/v/tag/ab1nv/opencode-max?style=for-the-badge\u0026color=fabd2f\u0026label=version\" alt=\"Version\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Theme-Gruvbox-fbf1c7?style=for-the-badge\u0026logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj48Y2lyY2xlIGN4PSIxMiIgY3k9IjEyIiByPSIxMCIgZmlsbD0iI2ZlODAxOSIvPjwvc3ZnPg==\u0026logoColor=282828\" alt=\"Gruvbox Theme\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Agents-12-b8bb26?style=for-the-badge\" alt=\"12 Agents\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Skills-6-83a598?style=for-the-badge\" alt=\"6 Skills\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Commands-14-b8bb26?style=for-the-badge\" alt=\"14 Commands\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Tools-2-d3869b?style=for-the-badge\" alt=\"2 Tools\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003e\n  \u003cimg src=\"https://i.ibb.co/fYqjLsjz/opencode-max-logo.png\" alt=\"OpenCode MAX\" /\u003e\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eTurn vanilla OpenCode into a god-tier AI coding assistant.\u003c/strong\u003e\u003cbr/\u003e\n  A drop-in configuration that gives you specialized agents, battle-tested skills, powerful custom commands, and a gorgeous Gruvbox theme — all designed to outperform Claude Code, Cursor, and every other AI coding tool.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eTired of constantly discovering new AI coding tricks, prompt patterns, and agent enhancements?\u003c/strong\u003e\u003cbr/\u003e\n  Every week there's a new \"best way\" to use Claude Code, a new skill pattern, a new agent workflow.\n  OpenCode MAX does the research so you don't have to — we track every meaningful advancement in AI-assisted development\n  and bake it into this configuration, so you can stay focused on \u003cem\u003ewriting great code\u003c/em\u003e\n  instead of endlessly tuning your tools.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#quick-install\"\u003eInstallation\u003c/a\u003e •\n  \u003ca href=\"#whats-included\"\u003eWhat's Included\u003c/a\u003e •\n  \u003ca href=\"#agents\"\u003eAgents\u003c/a\u003e •\n  \u003ca href=\"#commands\"\u003eCommands\u003c/a\u003e •\n  \u003ca href=\"#skills\"\u003eSkills\u003c/a\u003e •\n  \u003ca href=\"#customization\"\u003eCustomize\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## Why OpenCode MAX?\n\nMost people use OpenCode with default settings. That's like driving a Ferrari in first gear.\n\nOpenCode MAX gives you:\n\n| Feature | Vanilla OpenCode | OpenCode MAX |\n|---------|-----------------|--------------|\n| Agents | 2 (Build + Plan) | **12 specialized agents** |\n| Commands | 5 built-in | **14+ custom commands** |\n| Skills | None | **6 reusable workflows** |\n| Theme | Default | **Custom Gruvbox** with full syntax highlighting |\n| Permissions | Wide open | **Granular security** with safe defaults |\n| Prompts | Generic | **Expert-crafted** system prompts per agent |\n| Debugging | Manual | **Hypothesis-driven** debug loop |\n| Code Review | Manual | **One-command** `/review` with severity ratings |\n| Git | Manual | **Auto-generated** conventional commits |\n| Security | None | **Built-in** security audit command |\n\n---\n\n## Quick Install\n\n### Option 1: One-Line Install (Recommended)\n\n```bash\ncurl -sSL https://raw.githubusercontent.com/ab1nv/opencode-max/master/install.sh | bash\n```\n\n### Option 2: Clone \u0026 Install\n\n```bash\ngit clone https://github.com/ab1nv/opencode-max.git\ncd opencode-max\n./install.sh\n```\n\nThe installer will ask you:\n1. **Current project** — Copies configs to your working directory\n2. **Global** — Installs to `~/.config/opencode/` (applies everywhere)\n3. **Both** — Global + current project\n4. **Update** — Safe update mode (does not overwrite modified files)\n\n### Option 2: Manual Install\n\n```bash\n# Clone the repo\ngit clone https://github.com/ab1nv/opencode-max.git\n\n# Copy to your project\ncp opencode-max/opencode.json ./\ncp opencode-max/tui.json ./\ncp opencode-max/AGENTS.md ./\ncp -r opencode-max/.opencode/ ./.opencode/\ncp -r opencode-max/prompts/ ./prompts/\n\n# Or copy globally\ncp opencode-max/opencode.json ~/.config/opencode/\ncp opencode-max/tui.json ~/.config/opencode/\ncp opencode-max/AGENTS.md ~/.config/opencode/\ncp -r opencode-max/.opencode/themes/ ~/.config/opencode/themes/\ncp -r opencode-max/.opencode/agents/ ~/.config/opencode/agents/\ncp -r opencode-max/.opencode/commands/ ~/.config/opencode/commands/\ncp -r opencode-max/.opencode/skills/ ~/.config/opencode/skills/\n```\n\n### Option 3: Cherry-Pick What You Need\n\nOnly want the theme? Copy `.opencode/themes/gruvbox-max.json`.\nOnly want agents? Copy `.opencode/agents/` and `opencode.json`.\nMix and match whatever works for you.\n\n---\n\n## What's Included\n\n```\nopencode-max/\n├── opencode.json               # Main config — agents, permissions, commands, MCP\n├── tui.json                    # TUI theme \u0026 keybindings\n├── AGENTS.md                   # Global rules \u0026 coding standards\n├── install.sh                  # Interactive installer\n│\n├── prompts/                    # Agent system prompts\n│   ├── build.md                # Build agent prompt\n│   ├── plan.md                 # Plan agent prompt\n│   ├── architect.md            # Architect agent prompt\n│   └── debugger.md             # Debugger agent prompt\n│\n└── .opencode/\n    ├── themes/\n    │   └── gruvbox-max.json    # Custom Gruvbox theme\n    │\n    ├── agents/                 # Markdown-based subagents\n    │   ├── grill-me.md         # Design decision challenger\n    │   ├── perf-profiler.md    # Performance analyzer\n    │   └── changelog.md        # Changelog generator\n    │\n    ├── commands/               # Custom slash commands\n    │   ├── pre-commit.md       # Pre-commit review\n    │   ├── overview.md         # Project overview\n    │   ├── diff-summary.md     # Change summary\n    │   └── explain.md          # Code explainer\n    │\n    ├── tools/                  # Custom callable tools\n    │   ├── handoff.ts          # Save/load session handoff notes\n    │   └── run-checks.ts       # Run ordered verification commands\n    │\n    └── skills/                 # Reusable workflow skills\n        ├── plan-first/         # Plan-before-code workflow\n        ├── tdd/                # Test-driven development\n        ├── code-review/        # Review checklist\n        ├── git-commit/         # Conventional commits\n        ├── debug-loop/         # Hypothesis-driven debugging\n        └── to-prd/             # Idea → PRD converter\n```\n\n---\n\n## Agents\n\nOpenCode MAX ships with **12 specialized agents**: 3 primary agents you can switch between with `Tab`, and 9 subagents invokable with `@`.\n\n### Primary Agents (switch with `Tab`)\n\n| Agent | Color | Purpose |\n|-------|-------|---------|\n| **Build** | Orange | Full-power implementation: all tools enabled |\n| **Plan** | Blue | Read-only analysis and planning: never modifies files |\n| **Architect** | Purple | System design and architecture decisions |\n\n### Subagents (invoke with `@agent-name`)\n\n| Agent | Invoke | Purpose |\n|-------|--------|---------|\n| **Code Reviewer** | `@code-reviewer` | Deep review with security, correctness, and performance checks |\n| **Debugger** | `@debugger` | Systematic hypothesis-driven bug investigation |\n| **Docs Writer** | `@docs-writer` | Technical documentation and README generation |\n| **Security Auditor** | `@security-auditor` | OWASP-based security vulnerability scanning |\n| **Refactor** | `@refactor` | Code quality improvement without behavior change |\n| **Explorer** | `@explorer` | Fast read-only codebase navigation (10 step limit) |\n| **Grill Me** | `@grill-me` | Socratic challenger: pressure-tests your design decisions |\n| **Perf Profiler** | `@perf-profiler` | Finds bottlenecks, N+1 queries, and complexity issues |\n| **Changelog** | `@changelog` | Generates changelogs from git history |\n\n### How Agents Work\n\n```\n┌─────────────────────────────────────────────┐\n│              Primary Agents                 │\n│  ┌─────────┐  ┌──────┐  ┌───────────┐       │\n│  │  Build  │──│ Plan │──│ Architect │  Tab  │\n│  └────┬────┘  └──────┘  └───────────┘       │\n│       │                                     │\n│       ▼ Delegates to subagents              │\n│  ┌──────────────────────────────────┐       │\n│  │ @code-reviewer  @debugger        │       │\n│  │ @docs-writer    @security        │       │\n│  │ @refactor       @explorer        │       │\n│  │ @grill-me       @perf-profiler   │       │\n│  │ @changelog                       │       │\n│  └──────────────────────────────────┘       │\n└─────────────────────────────────────────────┘\n```\n\n---\n\n## Commands\n\nType `/` in OpenCode to see all commands. OpenCode MAX adds **14 custom commands**:\n\n### Development\n\n| Command | Description |\n|---------|-------------|\n| `/test` | Run tests, analyze failures, suggest fixes |\n| `/tdd \u003cfeature\u003e` | Test-driven development workflow |\n| `/debug \u003cissue\u003e` | Systematic hypothesis-driven debugging |\n| `/refactor \u003ctarget\u003e` | Refactor code while preserving behavior |\n\n### Review \u0026 Quality\n\n| Command | Description |\n|---------|-------------|\n| `/review` | Full code review on staged changes |\n| `/pre-commit` | Pre-commit quality check with go/no-go verdict |\n| `/security` | OWASP-based security audit |\n| `/perf \u003ctarget\u003e` | Performance analysis and optimization suggestions |\n\n### Planning \u0026 Documentation\n\n| Command | Description |\n|---------|-------------|\n| `/plan \u003ctask\u003e` | Create a detailed implementation plan |\n| `/doc \u003ctarget\u003e` | Generate documentation for a file or module |\n| `/explain \u003ctarget\u003e` | Plain-English code explanation |\n| `/overview` | Quick project overview and tech stack scan |\n\n### Git\n\n| Command | Description |\n|---------|-------------|\n| `/commit` | Generate conventional commit message from staged changes |\n| `/diff-summary` | Summarize all uncommitted changes |\n\n### Examples\n\n```bash\n# Review your staged changes before committing\n/review\n\n# Plan a new feature\n/plan Add user authentication with JWT\n\n# Debug a specific issue\n/debug Users can't login after password reset\n\n# Generate a commit message\n/commit\n\n# Explain unfamiliar code\n/explain src/auth/middleware.ts\n\n# Run TDD for a new feature\n/tdd Add email validation to signup form\n```\n\n---\n\n## Skills\n\nSkills are reusable workflow instructions that agents load on-demand. They teach the AI HOW to approach specific types of tasks.\n\n| Skill | Trigger | What It Does |\n|-------|---------|--------------|\n| **plan-first** | Complex tasks (3+ files) | Enforces requirements → discovery → plan → approval → execution |\n| **tdd** | `/tdd` or test-related tasks | Red → Green → Refactor cycles |\n| **code-review** | `/review` or review tasks | Structured checklist: security, correctness, perf, design |\n| **git-commit** | `/commit` | Conventional commit message generation |\n| **debug-loop** | `/debug` or bug reports | Hypothesis-driven: gather → hypothesize → test → fix → prevent |\n| **to-prd** | New features / ideas | Converts rough ideas into structured PRDs |\n\n---\n\n## Custom Tools\n\nOpenCode MAX includes lightweight custom tools in `.opencode/tools/`:\n\n| Tool | Purpose |\n|------|---------|\n| `handoff_save` / `handoff_load` | Persist and restore structured handoff notes across sessions |\n| `run-checks` | Run tests/lint/typecheck commands in sequence with a compact report |\n\n---\n\n## Gruvbox MAX Theme\n\nA carefully crafted Gruvbox dark theme with:\n\n- **Warm orange** primary accents (`#fe8019`)\n- **Tinted diff backgrounds** — green-tinted for additions, red-tinted for removals\n- **Full syntax highlighting** — 9 distinct token colors\n- **High contrast** — dark background (`#1d2021`) with light text (`#ebdbb2`)\n- **Active borders** — orange glow on focused elements\n\n### Color Palette\n\n| Role | Color | Hex |\n|------|-------|-----|\n| Primary | Orange | `#fe8019` |\n| Secondary | Blue | `#83a598` |\n| Accent | Aqua | `#8ec07c` |\n| Success | Green | `#b8bb26` |\n| Warning | Yellow | `#fabd2f` |\n| Error | Red | `#fb4934` |\n| Info | Blue | `#83a598` |\n| Background | Dark | `#1d2021` |\n| Text | Light | `#ebdbb2` |\n\n---\n\n## Permissions\n\nOpenCode MAX uses a **secure-by-default** permission model:\n\n### Auto-allowed (no prompt)\n- Reading files (except `.env`)\n- Git read operations (`status`, `diff`, `log`, `branch`, `show`)\n- Search tools (`grep`, `rg`, `find`, `ls`, `cat`)\n- Test runners (`npm test`, `jest`, `vitest`, `pytest`, `cargo test`)\n- Linters and type checkers (`tsc`, `eslint`, `prettier`, `clippy`)\n- Build commands (`npm run build`, `cargo build`, `go build`)\n- Web fetch and search\n\n### Ask first (prompts for approval)\n- Git write operations (`commit`, `push`, `merge`, `rebase`, `checkout`)\n- Docker commands\n- Make commands\n- External directory access\n- Doom loop detection (same tool called 3x with same input)\n\n### Blocked (denied)\n- Destructive commands (`rm`, `rm -rf`)\n- System commands (`sudo`, `chmod`, `chown`)\n- Reading `.env` files\n\n### Agent-specific permissions\nEach agent has tailored permissions:\n- **Build**: Full power, blocks destructive commands\n- **Plan**: Read-only — cannot edit files or run most commands\n- **Code Reviewer**: Read-only + git diff/log\n- **Debugger**: Can edit + run tests, needs approval for other commands\n\n---\n\n## Keybindings\n\n| Action | Shortcut |\n|--------|----------|\n| Switch agent | `Tab` / `Shift+Tab` |\n| Leader key | `Ctrl+X` |\n| New session | `\u003cLeader\u003e` + `N` |\n| Session list | `\u003cLeader\u003e` + `L` |\n| Compact session | `\u003cLeader\u003e` + `C` |\n| Model list | `\u003cLeader\u003e` + `M` |\n| Agent list | `\u003cLeader\u003e` + `A` |\n| Command list | `Ctrl+P` |\n| Copy messages | `\u003cLeader\u003e` + `Y` |\n| Undo | `\u003cLeader\u003e` + `U` |\n| Toggle sidebar | `\u003cLeader\u003e` + `B` |\n| Toggle tips | `\u003cLeader\u003e` + `H` |\n| Exit | `Ctrl+C` / `Ctrl+D` |\n\n---\n\n## Customization\n\n### Change the model\n\nEdit `opencode.json` and update the `model` field for any agent:\n\n```jsonc\n{\n  \"agent\": {\n    \"build\": {\n      \"model\": \"openai/gpt-5.1-codex\"  // or any provider/model\n    }\n  }\n}\n```\n\n### Add your own agent\n\nCreate a markdown file in `.opencode/agents/`:\n\n```markdown\n---\ndescription: My custom agent\nmode: subagent\ntemperature: 0.3\npermission:\n  edit: allow\n  bash:\n    \"*\": ask\n---\n\nYou are a custom agent. Do amazing things.\n```\n\n### Add a new command\n\nCreate a markdown file in `.opencode/commands/`:\n\n```markdown\n---\ndescription: My custom command\nagent: build\n---\n\nDo something cool with: $ARGUMENTS\n```\n\n### Add a new skill\n\nCreate `.opencode/skills/my-skill/SKILL.md`:\n\n```markdown\n---\nname: my-skill\ndescription: What this skill does\n---\n\n## Instructions for the agent...\n```\n\n### Add an MCP server\n\nEdit `opencode.json`:\n\n```jsonc\n{\n  \"mcp\": {\n    \"my-server\": {\n      \"type\": \"local\",\n      \"command\": [\"npx\", \"-y\", \"my-mcp-server\"],\n      \"enabled\": true\n    }\n  }\n}\n```\n\n### Change the theme\n\nEither use a built-in theme in `tui.json`:\n```json\n{ \"theme\": \"tokyonight\" }\n```\n\nOr modify `.opencode/themes/gruvbox-max.json` to your liking.\n\n---\n\n## Pro Tips\n\n### 1. Use the right agent for the job\nDon't use Build for planning. Don't use Plan for coding. Hit `Tab` to switch.\n\n### 2. Start with `/plan` for complex tasks\nBefore touching code, run `/plan \u003cdescription\u003e`. This creates a structured plan that the Build agent can follow.\n\n### 3. Use `/review` before every commit\nOne command catches bugs, security issues, and style problems. Much cheaper than production bugs.\n\n### 4. Invoke subagents with `@`\nType `@debugger investigate the login timeout` to delegate to a specialist without leaving your main conversation.\n\n### 5. Use skills for workflow enforcement\nThe `plan-first` skill ensures agents don't jump into code without a plan. The `tdd` skill enforces Red-Green-Refactor.\n\n### 6. Chain commands for power workflows\n```\n/plan Add pagination to /api/users\n# Review the plan, approve it\n# Switch to Build agent (Tab)\n# Implement the plan\n/test\n/review\n/commit\n```\n\n### 7. Use `/pre-commit` as your quality gate\nIt gives a clear safe/fix/do-not-commit verdict before you commit.\n\n### 8. Let `@grill-me` challenge your decisions\nBefore finalizing architecture, invoke `@grill-me` to find blind spots.\n\n---\n\n## Reference Docs\n\nThis configuration is inspired by and built upon:\n\n- [OpenCode Documentation](https://opencode.ai/docs) — Official docs\n- [Graphify](https://github.com/safishamsi/graphify) — Knowledge graph skill patterns\n- [Claude Code Templates](https://github.com/anthropics/claude-code) — Agent configuration patterns\n- [Matt Pocock's Skills](https://github.com/mattpocock/skills) — Workflow skill design\n- [Oh My Codex (OmX)](https://github.com/hiaux0/oh-my-codex) — Agent orchestration patterns\n- [Andrej Karpathy's LLM Skills](https://karpathy.ai/) - Base of entire design\n\n---","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fab1nv%2Fopencode-max","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fab1nv%2Fopencode-max","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fab1nv%2Fopencode-max/lists"}