A checklist for connecting a new command to a command-line program. A command-line program is software controlled by typed commands in a terminal.

Use it when adding a CLI command to check its implementation, argument handling, routing in the entry file, and usage information.

It prevents a command from being implemented in a file but forgotten in the program's routing and help text, leaving users unable to run or discover it.

cli-wiring — Skill for Claude Code and Codex by Azure-Samples

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.

Any agent

npx skills add Azure-Samples/eShopLite --skill cli-wiring

Clone the repo

git clone --depth 1 https://github.com/Azure-Samples/eShopLite

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/azure-samples/eshoplite/cli-wiring/github.svg)](https://agentmods.dev/skills/azure-samples/eshoplite/cli-wiring)

Your own site

<a href="https://agentmods.dev/skills/azure-samples/eshoplite/cli-wiring"><img src="https://agentmods.dev/badge/skills/azure-samples/eshoplite/cli-wiring/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/azure-samples/eshoplite/cli-wiring"><img src="https://agentmods.dev/badge/skills/azure-samples/eshoplite/cli-wiring.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

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

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

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin 91% copy Near-identical to another mod 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.1	$0.00000	$0.00481
Opus 5.5	$0.00000	$0.00192
Sonnet 5.5	$0.00000	$0.00096
Haiku 4.5	$0.00000	$0.00048

Measured 1mo ago against content hash 931fdb23ad9c, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

cli-wiring 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 1mo 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.

Origin

This is a copy

91% identical to cli-wiring — 4 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

.squad/templates/skills/cli-wiring/SKILL.md · 48 lines

What it actually says

Skill: CLI Command Wiring

Bug class: Commands implemented in packages/squad-cli/src/cli/commands/ but never routed in cli-entry.ts.

Checklist — Adding a New CLI Command

Create command file in packages/squad-cli/src/cli/commands/<name>.ts
- Export a run<Name>(cwd, options) async function (or class with static methods for utility modules)

Add routing block in packages/squad-cli/src/cli-entry.ts inside main():

if (cmd === '<name>') {
  const { run<Name> } = await import('./cli/commands/<name>.js');
  // parse args, call function
  await run<Name>(process.cwd(), options);
  return;
}

Add help text in the help section of cli-entry.ts (search for Commands:):

console.log(`  ${BOLD}<name>${RESET}     <description>`);
console.log(`             Usage: <name> [flags]`);

Verify both exist — the recurring bug is doing step 1 but missing steps 2-3.

Wiring Patterns by Command Type

Type	Example	How to wire
Standard command	`export.ts`, `build.ts`	`run*()` function, parse flags from `args`
Placeholder command	`loop`, `hire`	Inline in cli-entry.ts, prints pending message
Utility/check module	`rc-tunnel.ts`, `copilot-bridge.ts`	Wire as diagnostic check (e.g., `isDevtunnelAvailable()`)
Subcommand of another	`init-remote.ts`	Already used inside parent + standalone alias

Common Import Pattern

import { BOLD, RESET, DIM, RED, GREEN, YELLOW } from './cli/core/output.js';

Use dynamic await import() for command modules to keep startup fast (lazy loading).

History

#237 / PR #244: 4 commands wired (rc, copilot-bridge, init-remote, rc-tunnel). aspire, link, loop, hire were already present.

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.

1mo ago First seen · 48 lines · 0 tokens per session scan A 931fdb23ad9c

Subscribe to this mod's changes

cli-wiring is a skill published in the GitHub repository Azure-Samples/eShopLite (168 stars, last pushed 6d ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 481 tokens. A static security scan graded it A with 0 findings. It is 91% identical to cli-wiring, differing in 4 lines, and is treated as a copy.

Debugging aspire azd azd-templates azure-openai chromadb deepseek-r1

error-handler

Design error handling, structured logging, and observability with OpenTelemetry (traces, metrics, logs), error classification, recovery patterns (retry with jitter, circuit breaker, bulkhead, timeout), error budgets/SLOs with burn rate alerts, and production incident triage. Use when user asks to implement error…

EliasOulkadi/shokunin · 125 tokens

performance-profiler

Performance profiling and optimization for web apps — Core Web Vitals (LCP, INP, CLS), Lighthouse audits, bundle analysis, backend profiling (CPU, memory, DB queries), N+1 detection, caching strategies (Redis, CDN, HTTP), and performance budgets. Use when user asks to improve performance, run Lighthouse audit, profile…

EliasOulkadi/shokunin · 118 tokens

gsd-forensics

Post-mortem investigation for failed GSD workflows — analyzes git history, artifacts, and state to diagnose what went wrong.

SpillwaveSolutions/agent-brain · 29 tokens

investigation-case

Deep forensic investigation of bugs, incidents, or reported problems. Sweeps all sources (Jira, Slack, GitHub, Confluence, Codebase, Datadog/NR), cross-references data, reconstructs timeline, identifies root cause, and produces Investigation Case with Fix Plan. Use when the user says "investigation", "investigate"…

ivanhoinacki/team-exp-claude-config · 118 tokens

debug-mode

Hypothesis-driven debugging workflow that requires runtime evidence before making fixes. Spins up a local log server so browser code can POST structured logs to a file the AI reads directly. Use when the user says "debug", "debug mode", "help me debug", "find this bug", "why isn't this working", "what's wrong with"…

ivanhoinacki/team-exp-claude-config · 120 tokens

dejavu-scan

Trigger a manual scan for antipatterns. Use when user asks "scan for patterns", "dejavu scan", "check for mistakes".

cmg8431/claude-dejavu · 33 tokens