coco CLI
Command-line tool for analyzing ODB++ PCB design files.
When to Use
Use coco CLI in these situations:
- •ODB++ folder detected - Directory containing
matrix/,steps/,misc/folders - •PCB-related queries - Layer, net, component, feature, distance measurement requests
- •DFM verification - Clearance checks, short detection, design rule validation
- •Keywords present - ODB++, PCB, Gerber, layer, netlist, DRC
Installation
bash
# Check installation coco --help # If not installed # Linux/macOS: ./scripts/install.sh # Windows: ./scripts/install.ps1
ODB++ Folder Identification
ODB++ folders are identified by internal structure (folder name is irrelevant):
code
<any_name>/ <- path for --input ├── matrix/ ├── steps/ └── misc/
If matrix/, steps/, misc/ folders are all present, it's an ODB++ root.
Command Usage
IMPORTANT: Always run --help first to discover available commands and options:
bash
# Discover all commands coco --help # Get specific command options (REQUIRED before using any command) coco <command> --help
Basic Workflow
bash
# 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
Troubleshooting
| Symptom | Solution |
|---|---|
| command not found | Run scripts/install.sh |
| step not found | Specify --step <name> option |