name: coco-cli
description: ODB++ PCB design file analysis CLI. Query layers/nets/components, measure feature distances, analyze net clearances, render PNG images.
license: LicenseRef-Proprietary
compatibility: Requires coco CLI binary. Supports Windows, macOS, Linux.
metadata:
author: Pentacube
version: "0.1.0"

coco CLI

Command-line tool for analyzing ODB++ PCB design files.

When to Use

Use coco CLI in these situations:

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

Installation

# 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):

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

# 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