coco CLI

Command-line tool for analyzing PCB design files (ODB++, Cadence).

When to Use

Use coco CLI in these situations:

1. ODB++ folder detected - Directory containing matrix/, steps/, misc/ folders
2. Cadence file detected - .brd or .sip file, or Cadence .out directory
3. PCB-related queries - Layer, net, component, feature, distance measurement requests
4. DFM verification - Clearance checks, short detection, design rule validation
5. Keywords present - ODB++, PCB, Cadence, Allegro, layer, netlist, DRC

Installation

IMPORTANT: 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

Input Identification

ODB++

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.

Cadence

• .brd or .sip file - auto-detected, uses Extracta + cache
• .out directory - use --input-kind cadence
• Requires: Cadence Extracta license (Extracta must be installed and licensed)

Command Usage

IMPORTANT: 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

Basic Workflow

# 1. Discover commands
coco --help

# 2. Check command options
coco list-layers --help

# 3. Run with appropriate options
coco list-layers --input <odb_path>

Use Cases

• DFM Clearance Verification
• Net Analysis

Troubleshooting

Symptom	Solution
command not found	Run install script or download manually (see Installation)
step not found	Specify --step <name> option