PCB design file analysis CLI (ODB++, Cadence .brd/.sip). Query layers/nets/components, measure feature distances, analyze net clearances, render PNG images.
Command-line tool for analyzing PCB design files (ODB++, Cadence).
Use coco CLI in these situations:
matrix/, steps/, misc/ folders.brd or .sip file, or Cadence .out directoryIMPORTANT: First check if coco is already installed. If coco --help succeeds, skip installation entirely.
coco --help
If the command above succeeds, coco is ready to use. Do NOT run install scripts again.
Only if coco --help fails (command not found), install using one of the methods below:
# Linux/macOS:
curl -fsSL https://raw.githubusercontent.com/yongsun-park/coco-cli-releases/main/skills/coco-cli/scripts/install.sh | bash
# Windows (PowerShell):
irm https://raw.githubusercontent.com/yongsun-park/coco-cli-releases/main/skills/coco-cli/scripts/install.ps1 | iex
Manual install (if scripts are blocked):
Download from GitHub Releases, place in the path below, and add to PATH.
| OS | File | Default path |
|---|---|---|
| Windows | coco-windows-x64.exe | %LOCALAPPDATA%\Pentacube\CubicAI\bin\coco.exe |
| macOS (Apple Silicon) | coco-macos-arm64 | ~/.local/bin/coco |
| macOS (Intel) | coco-macos-x64 | ~/.local/bin/coco |
| Linux | coco-linux-x64 | ~/.local/bin/coco |
ODB++ folders are identified by internal structure (folder name is irrelevant):
<any_name>/ <- path for --input
├── matrix/
├── steps/
└── misc/
If matrix/, steps/, misc/ folders are all present, it's an ODB++ root.
.brd or .sip file - auto-detected, uses Extracta + cache.out directory - use --input-kind cadenceIMPORTANT: Always run --help first to discover available commands and options:
# Discover all commands
coco --help
# Get specific command options (REQUIRED before using any command)
coco <command> --help
# 1. Discover commands
coco --help
# 2. Check command options
coco list-layers --help
# 3. Run with appropriate options
coco list-layers --input <odb_path>
| Symptom | Solution |
|---|---|
| command not found | Run install script or download manually (see Installation) |
| step not found | Specify --step <name> option |