opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@opencode-ai/plugin", "@macrodata/opencode"],
  "permission": {
    "external_directory": {
      "/Users/<YOUR_USERNAME>/.config/macrodata/**": "allow"
    },

    "read": "allow",
    "edit": "ask",

    "bash": {
      "git *": "allow",
      "npm *": "allow",
      "bun *": "allow",
      "python3 *": "allow",
      "ls *": "allow",
      "cat *": "allow",
      "crwl *": "allow",
      "npx gitnexus *": "allow",
      "*": "ask"
    },

    "skill": {
      "ultraskill-*": "allow",
      "agent-*": "allow",
      "macrodata-*": "allow",
      "gitnexus-*": "allow"
    },

    "puppeteer_*": "allow",
    "macrodata_*": "allow",
    "gitnexus_*": "allow",
    "exa_*": "allow",
    "brave_*": "allow",
    "fetcher_*": "allow",
    "context7_*": "allow",
    "time_*": "allow",
    "youtube_*": "allow",
    "reddit_*": "allow",
    "gitingest_*": "allow",
    "mcp_compass_*": "allow",
    "data_explorer_*": "allow",

    "github_*": "ask",
    "desktop_commander_*": "ask"
  },
  "agent": {
    "plan-cheap": {
      "mode": "primary",
      "model": "github-copilot/gpt-5-mini",
      "temperature": 0.1,
      "description": "Cheap planner",
      "prompt": "{file:~/.config/opencode/planner-directive.md}",
      "tools": {
        "write": false,
        "edit": false,
        "bash": true
      },
      "permission": {
        "task": { "*": "allow" }
      }
    },
    "build-cheap": {
      "mode": "primary",
      "model": "github-copilot/gpt-5-mini",
      "temperature": 0.3,
      "description": "Cheap builder",
      "tools": {
        "write": true,
        "edit": true,
        "bash": true
      }
    },
    "build-gpt": {
      "mode": "primary",
      "model": "openai/gpt-5.3-codex",
      "options": {
        "reasoningEffort": "high"
      },
      "description": "Elite implementation agent",
      "tools": {
        "write": true,
        "edit": true,
        "bash": true
      }
    },
    "plan-gpt": {
      "mode": "primary",
      "model": "openai/gpt-5.4",
      "options": {
        "reasoningEffort": "high"
      },
      "description": "Deep thinking planner",
      "prompt": "{file:~/.config/opencode/planner-directive.md}",
      "tools": {
        "write": false,
        "edit": false,
        "bash": true
      },
      "permission": {
        "task": { "*": "allow" }
      }
    },
    "plan-gemini": {
      "mode": "primary",
      "model": "github-copilot/gemini-3.1-pro",
      "temperature": 0.1,
      "description": "Deep thinking planner",
      "prompt": "{file:~/.config/opencode/planner-directive.md}",
      "tools": {
        "write": false,
        "edit": false,
        "bash": true
      },
      "permission": {
        "task": { "*": "allow" }
      }
    },
    "build-gemini": {
      "mode": "primary",
      "model": "github-copilot/gemini-3-flash",
      "temperature": 0.3,
      "description": "Fast & Cheap builder",
      "tools": {
        "write": true,
        "edit": true,
        "bash": true
      }
    },
    "core-development/*": {
      "mode": "subagent",
      "description": "CORE IMPLEMENTATION CLUSTER. A group of specialized models for building high-quality software. Delegate here to generate production-ready Frontend, Backend, and API code. These agents are optimized for specific framework implementations and architectural patterns.",
      "permission": {
        "task": {
          "general": "allow",
          "explore": "allow"
        }
      }
    },
    "data-ai/*": {
      "mode": "subagent",
      "description": "AI & DATA SPECIALIST CLUSTER. Dedicated experts for advanced AI engineering and data science. Use this group for designing RAG systems, vector database indexing, feature engineering, and model training workflows.",
      "permission": {
        "task": {
          "general": "allow",
          "explore": "allow"
        }
      }
    },
    "infrastructure/*": {
      "mode": "subagent",
      "description": "INFRASTRUCTURE & OPERATIONS CLUSTER. A specialized team for cloud environments and deployment stability. Delegate all tasks involving AWS/GCP/Azure, Kubernetes, CI/CD pipelines, and systems security to this group.",
      "permission": {
        "task": {
          "general": "allow",
          "explore": "allow"
        }
      }
    },
    "quality-assurance/*": {
      "mode": "subagent",
      "description": "QA & AUDIT CLUSTER. Independent verification experts. Use this group for objective code reviews, vulnerability assessments, performance profiling, and automated testing to ensure the highest reliability standards.",
      "permission": {
        "task": {
          "general": "allow",
          "explore": "allow"
        }
      }
    },
    "developer-experience/*": {
      "mode": "subagent",
      "description": "WORKFLOW & TOOLING CLUSTER. Experts in development ergonomics and repository hygiene. Delegate Git operations, dependency management, and MCP tool development to this specialist group.",
      "permission": {
        "task": {
          "general": "allow",
          "explore": "allow"
        }
      }
    },
    "research-analysis/*": {
      "mode": "subagent",
      "description": "TECHNICAL KNOWLEDGE CLUSTER. Specialized agents for deep research and synthesis. Use them for academic literature reviews, competitive technical analysis, benchmarking, and tracking technology trends.",
      "permission": {
        "task": {
          "general": "allow",
          "explore": "allow"
        }
      }
    },
    "orchestration/*": {
      "mode": "subagent",
      "description": "META-PROCESS CLUSTER. Experts in managing long-running, multi-step workflows. Delegate to this group when the task requires complex context management, error recovery across agents, or multi-task coordination.",
      "prompt": "{file:~/.config/opencode/planner-directive.md}",
      "permission": {
        "task": {
          "*": "allow"
        }
      }
    },
    "general": {
      "mode": "subagent",
      "description": "Can be used for executing subtasks, writing code, and modifying files. You can delegate implementation to this agent.",
      "tools": {
        "write": true,
        "edit": true,
        "bash": true
      }
    },
    "explore": {
      "mode": "subagent",
      "description": "CRITICAL: USE PROACTIVELY to search patterns, read files, and explore the codebase. DO NOT guess file contents or architecture. You MUST use this agent to read code.",
      "tools": {
        "write": false,
        "edit": false
      }
    }
  },
  "mcp": {
    "puppeteer": {
      "type": "local",
      "enabled": false,
      "command": ["<NPX_PATH>", "-y", "@modelcontextprotocol/server-puppeteer"]
    },
    "memory": {
      "type": "local",
      "enabled": false,
      "command": [
        "<NODE_PATH>",
        "<NPX_PATH>",
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    },
    "gitnexus": {
      "type": "local",
      "enabled": true,
      "command": ["<NODE_PATH>", "<GITNEXUS_PATH>", "mcp"]
    },
    "exa": {
      "type": "remote",
      "enabled": true,
      "url": "https://mcp.exa.ai/mcp?tools=web_search_exa,web_search_advanced_exa,get_code_context_exa,crawling_exa,company_research_exa,people_search_exa,deep_researcher_start,deep_researcher_check"
    },
    "brave-search": {
      "type": "local",
      "enabled": true,
      "command": ["<NODE_PATH>", "<BRAVE_SEARCH_MCP_PATH>"],
      "environment": {
        "BRAVE_API_KEY": "YOUR_API_KEY"
      }
    },
    "fetcher": {
      "type": "local",
      "enabled": true,
      "command": ["<NODE_PATH>", "<FETCHER_MCP_PATH>"]
    },
    "reddit": {
      "type": "local",
      "enabled": true,
      "command": ["<PYTHON_PATH>", "-m", "mcp_server_reddit"]
    },
    "youtube-transcript": {
      "type": "local",
      "enabled": true,
      "command": ["bunx", "mcp-server-youtube-transcript"]
    },
    "youtube-data": {
      "type": "local",
      "enabled": true,
      "command": ["<NODE_PATH>", "<YOUTUBE_DATA_MCP_PATH>"],
      "environment": {
        "YOUTUBE_API_KEY": "YOUR_API_KEY"
      }
    },
    "time": {
      "type": "local",
      "enabled": true,
      "command": [
        "<PYTHON_PATH>",
        "-m",
        "mcp_server_time",
        "--local-timezone",
        "<YOUR_TIMEZONE>"
      ]
    },
    "context7": {
      "type": "local",
      "enabled": true,
      "command": ["<NODE_PATH>", "<CONTEXT7_MCP_PATH>"]
    },
    "desktop-commander": {
      "type": "local",
      "enabled": true,
      "command": ["<NODE_PATH>", "<DESKTOP_COMMANDER_MCP_PATH>"]
    },
    "github": {
      "type": "local",
      "enabled": true,
      "command": ["<NODE_PATH>", "<GITHUB_MCP_PATH>"],
      "environment": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_TOKEN"
      }
    },
    "gitingest": {
      "type": "local",
      "enabled": true,
      "command": [
        "<PYTHON_PATH>",
        "<GITINGEST_MCP_PATH>/src/gitingest_mcp/server.py"
      ]
    },
    "data-explorer": {
      "type": "local",
      "enabled": true,
      "command": ["<DATA_EXPLORER_MCP_PATH>"]
    },
    "kaggle": {
      "type": "local",
      "enabled": false,
      "command": ["<KAGGLE_MCP_PYTHON_PATH>", "<KAGGLE_MCP_SERVER_PATH>"],
      "environment": {
        "KAGGLE_USERNAME": "YOUR_USERNAME",
        "KAGGLE_KEY": "YOUR_API_KEY"
      }
    },
    "google-maps": {
      "type": "local",
      "enabled": false,
      "command": ["<NODE_PATH>", "<GOOGLE_MAPS_MCP_PATH>"],
      "environment": {
        "GOOGLE_MAPS_API_KEY": "YOUR_API_KEY"
      }
    },
    "simple-arxiv": {
      "type": "local",
      "enabled": false,
      "command": ["<PYTHON_PATH>", "-m", "mcp_simple_arxiv"]
    },
    "mcp-compass": {
      "type": "local",
      "enabled": true,
      "command": ["<NODE_PATH>", "<NPX_PATH>", "-y", "@liuyoshio/mcp-compass"]
    }
  }
}