A command-line tool for communicating with Solo 2 hardware security keys, including their built-in security applications.

Listing Solo 2 devices, installing signed firmware updates, using FIDO, OATH, PIV, or NDEF functions, and interacting with bootloader mode.

It provides terminal commands for finding connected keys, updating their firmware, and accessing supported applications.

solo2-cli — Skill by solokeys

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods

npx agentmods add skills/solokeys/solo2/solo2-cli

Any agent

npx skills add solokeys/solo2 --skill solo2-cli

Clone the repo

git clone --depth 1 https://github.com/solokeys/solo2

Made for: Claude Code, Codex.

Per session 69 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 782 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. Scan, not verified.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5	$0.00069	$0.00782
Opus 5	$0.00034	$0.00391
Sonnet 5	$0.00014	$0.00156
Haiku 4.5	$0.00007	$0.00078

Measured 3d ago against content hash 100d150cacba, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

solo2-cli scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/solo2-cli/SKILL.md · 45 lines

How it starts

The opening of the file, as written. The whole thing — 45 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Using the `solo2` CLI

solo2 is the host tool for Solo 2 keys. Source is in cli/; run solo2 --help (or cargo run -- --help) for the authoritative, version-specific surface.

Install / run

cargo install solo2            # installs the `solo2` binary
solo2 list                     # list connected devices (alias: solo2 ls)
cargo run -- list              # run from this repo without installing

Linux: install the udev rule cli/70-solo2.rules; the CCID apps (OATH/PIV/OpenPGP) need a PC/SC stack (pcscd). macOS/Windows have PC/SC built in. FIDO is plain USB-HID (no driver).

Top-level commands

solo2 list — enumerate keys (shows UUID, firmware version, locked/unlocked).
solo2 update [--dry-run] [--yes] [--all] [--with <file.sb2>] — install the latest SoloKeys-signed firmware; downloads, verifies SHA-256, flashes. Prompts on major updates. --with flashes a specific .sb2.
solo2 app <APP> … — talk to an on-device application (below).
solo2 bootloader {list|reboot} — interact with keys in bootloader mode.
solo2 pki ca fetch-certificate <R1|T1|S3|…> — fetch Solo 2 PKI certs.
solo2 completion {bash|fish|zsh|powershell} — shell completions.

infer_subcommands is on, so unambiguous prefixes work (e.g. solo2 app fido i → init).

On-device apps (`solo2 app …`)

admin — wink (blink LED to identify), version, uuid, locked (Secure=locked / Hacker=unlocked), maintenance (reboot into LPC55 bootloader), restart (reboot as Solo 2), aid.
fido — init, wink. (Credential create/assert is done by a FIDO2 client/browser; see the solo2-examples skill.)
oath — register (positional args or --uri), list, totp/hotp, delete <label>, rename, reset, aid. TOTP/HOTP secrets stored on the key.
piv — PIV applet operations.
ndef — data, capabilities, aid (tap-to-URL).

Notes

Identify which physical key you're talking to with solo2 app admin wink before destructive ops; target a specific key with the device selector flags (solo2 --help).
solo2 app admin locked is the quick way to tell a Secure key (locked) from a Hacker (unlocked).
For building/flashing firmware (not just talking to a key), see the flash-solo-hacker skill.
Worked, tested command sequences live in examples/ — see the solo2-examples skill.

Read the full file on GitHub · 45 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

3d ago First seen · 45 lines · 69 tokens per session scan A 100d150cacba

Subscribe to this mod's changes

solo2-cli is a skill published in the GitHub repository solokeys/solo2 (707 stars, last pushed 13d ago), licensed Apache-2.0. It adds 69 tokens to every session and 782 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Hardware and IoT Security

add-macos-statusbar

Add a macOS menu bar status indicator for NanoClaw. Shows a bolt icon with a green/red dot indicating whether NanoClaw is running, with Start, Stop, and Restart controls. macOS only.

nanocoai/nanoclaw · 49 tokens

cli-anything-3mf

3MF mesh geometry editor — detect and resize cylindrical holes, repair meshes, compare 3D printing files. Works with BambuStudio and PrusaSlicer 3MF files.

HKUDS/CLI-Anything · 44 tokens

platform-port

Guide porting FastLED to new MCU platforms, including int.h types, clockless drivers, SPI implementations, and platform detection. Use when adding support for a new microcontroller family or board.

FastLED/FastLED · 42 tokens

doca-compress

Use this skill for hands-on DOCA Compress programming on a BlueField DPU, ConnectX NIC, or host with DOCA — enabling compress-deflate, decompress-deflate, decompress-lz4-stream, or decompress-lz4-block tasks on a docacompress context (the hardware supports DEFLATE both directions plus LZ4 decompress; LZ4 encode is NOT…

NVIDIA/skills · 242 tokens

pcbway

PCBWay PCB fabrication and assembly — turnkey/consigned assembly, design rules, ordering workflow. Alternative to JLCPCB for manufacturing. Use with KiCad. Use this skill when the user mentions PCBWay, needs turnkey assembly (PCBWay sources parts by MPN), has parts not available on LCSC, needs assembled boards with…

aklofas/kicad-happy · 119 tokens

anta-validation

Validate Arista EOS network state with structured pass/fail verdicts using ANTA. Use for "is this switch healthy", "did my change break anything", "verify BGP/interfaces/hardware are correct", "run a health check on this device". Read-only. A test for a feature the device does not run reports notapplicable — never a…

automateyournetwork/netclaw · 84 tokens