cynthion-setup

Installs and verifies Cynthion CLI, Packetry, tshark, and Linux udev rules for USB analysis.

2|Updated May 13, 2026
One-click install
npx skills add https://github.com/curtisgalloway/public-skills --skill cynthion-setup-curtisgalloway
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cynthion-setup
Source: https://github.com/curtisgalloway/public-skills/tree/main/plugins/hardware-lab/skills/cynthion-setup
Command: npx skills add https://github.com/curtisgalloway/public-skills --skill cynthion-setup-curtisgalloway

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a Cynthion USB analyzer requires installing several tools across different platforms, and missing any one of them causes other Cynthion skills to fail with confusing errors. This Skill walks through the complete installation and verification process so the environment works the first time. ## Core Features & Use Cases - Cross-platform installation: Installs the cynthion CLI via uv, Packetry, and tshark on macOS, Linux, and Windows with platform-specific commands. - Linux udev configuration: Copies the bundled 54-cynthion.rules file and reloads udev so the device is accessible without root. - Verification and troubleshooting: Confirms each tool with version checks and cynthion info, plus fixes for common failures like missing PATH entries or charge-only USB cables. - Use Case: You just unboxed a Cynthion on a new Linux machine. Run this Skill to install every prerequisite, configure udev rules, and verify device access before capturing USB traffic. ## Quick Start Set up Cynthion on this machine and verify the device is detected.

Frequently Asked Questions about cynthion-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a Cynthion USB analyzer on a new machine?▼

Install uv first, then run uv tool install cynthion for the CLI, install Packetry and tshark through your platform's package manager, and on Linux copy the bundled udev rules. Verify everything by plugging in the device and running cynthion info.

How do I install the cynthion CLI with uv?▼

Run uv tool install cynthion for a first install or uv tool upgrade cynthion to update. The CLI has no --version flag, so confirm the installation with cynthion info, which prints the Cynthion and Apollo versions.

Why does cynthion info report no device found on Linux?▼

The device is only accessible as root without udev rules. Copy the bundled 54-cynthion.rules file to /etc/udev/rules.d/, reload udev, and replug the device. Also check the cable is data-capable and connected to the CONTROL port.

Does Cynthion setup work on macOS and Windows?▼

Yes, the procedure covers all three platforms. macOS uses brew for Packetry and Wireshark, Windows uses the Packetry installer and Wireshark installer with the TShark component, and udev rules are Linux-only.

Why is tshark required for Cynthion USB capture analysis?▼

tshark is the preferred decoder for USB pcap files produced by Cynthion captures. The bundled Python fallback decoder is best-effort only and insufficient for most real captures, so tshark should be treated as required.