git:20260606.1aab6cf to git:20260922.1d55c02
21 added, 16 removed. Audit A to A.
# KiCad MCP — OpenCode Usage Guide
- When the task involves KiCad, PCB design, schematic review, ERC/DRC, manufacturing export, BOM, routing, DFM, or KiCad project files, use the `kicad` MCP server.
+ When a task involves KiCad, PCB design, schematic review, ERC/DRC, manufacturing
+ export, BOM, routing, DFM, or KiCad project files, use the configured `kicad` MCP
+ server.
- ## Default Policy
+ ## Default policy
- 1. **Inspect before editing.** Always read current project state first.
- 2. **Run quality gates.** Use `project_quality_gate` before suggesting release.
- 3. **Never run destructive tools** without explicit user confirmation.
- 4. **Prefer read-only tools** unless the user asks to modify the project.
- 5. **After edits**, run ERC/DRC and summarize changed files.
+ 1. Inspect the current project state before proposing or making edits.
+ 2. Prefer read-only MCP operations unless the user explicitly requests a change.
+ 3. Run `project_quality_gate` before describing a design as release-ready.
+ 4. Never execute destructive or irreversible tools without explicit user intent.
+ 5. After edits, run the applicable ERC/DRC and validation gates and report the
+ changed files and remaining violations.
- ## Tool Categories
+ ## OpenCode permissions
- | Category | Behavior |
- |----------|----------|
- | `kicad_*` | All KiCad MCP tools |
- | `write` | File write operations — set to "ask" |
- | `bash` | Shell execution — set to "ask" |
+ OpenCode permission keys match tool names and support wildcards. For example,
+ `"kicad_*": "ask"` gates every tool exposed by the `kicad` MCP server. Per-agent
+ permission rules override the global policy, so a dedicated review agent can allow
+ KiCad reads while keeping `edit` denied and `bash` gated.
- ## Quick Start
+ The legacy `tools` boolean configuration is deprecated; use `permission` for new
+ configurations.
+ ## Quick start
+
```bash
- # Install the MCP server
uvx kicad-mcp-pro
```
- In OpenCode, the kicad tools appear automatically once configured in `opencode.json`.
+ Once `opencode.json` contains the MCP entry, OpenCode discovers the KiCad tools
+ from the server automatically.