Project guidance for the Donut command-line interface, a text-based program operated from a terminal, written in TypeScript.

Use it when editing the CLI, its commands, terminal interface components, shared UI code, or Vitest unit tests.

It keeps CLI changes aligned with the project's module boundaries, user-interface structure, and test layout.

How nerds-odd-e/doughnut configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to nerds-odd-e/doughnut. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/nerds-odd-e/doughnut/main/.agents/skills/cli/SKILL.md

Clone the repo

git clone --depth 1 https://github.com/nerds-odd-e/doughnut

Made for: Claude Code.

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/nerds-odd-e/doughnut/cli/github.svg)](https://agentmods.dev/skills/nerds-odd-e/doughnut/cli)

Your own site

<a href="https://agentmods.dev/skills/nerds-odd-e/doughnut/cli"><img src="https://agentmods.dev/badge/skills/nerds-odd-e/doughnut/cli/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/nerds-odd-e/doughnut/cli"><img src="https://agentmods.dev/badge/skills/nerds-odd-e/doughnut/cli.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

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

When invoked 3,691 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 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.1	$0.00014	$0.03691
Opus 5.5	$0.00006	$0.01476
Sonnet 5.5	$0.00003	$0.00738
Haiku 4.5	$0.00001	$0.00369

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

Security

Grade A, and why

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

.agents/skills/cli/SKILL.md · 120 lines

How it starts

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

donut-cli

TypeScript CLI for Donut. Lives in cli/.

Structure

cli/
  src/                 # Production code: `main`/`run`, `nonInteractiveCli`, `interactiveInkSession` (TTY → Ink edge), Ink app, `commands/`
  src/commonUIComponents/  # Context-neutral Ink UI reused across stages and the main prompt (borders, guidance lists, y/n, past user block, stage key context)
  src/sessionScrollback/  # One Ink `<Static>` session history above the live column; transcript factories + recall answered rows; append context for stages
  src/commands/        # Slash-command and subcommand implementations + aggregated help
  src/shims/           # Modules referenced only from the esbuild `bundle` script (aliases)
  tests/               # Vitest unit tests (*.test.ts)
  vitest.config.ts
  tsconfig.json
  package.json

TypeScript module exports

Keep each module’s public surface small: export only what other modules actually use. Prefer leaving helpers, constants, and types unexported when they are implementation details. Do not add exports “for tests” or “maybe later” — if only tests need a symbol, test through a stable-boundary entry point when possible (unit-testing skill; see Vitest: observable behavior below). Avoid widening the export list when a single import site could instead live next to the code.

Commands

Task	Command
Build bundle	`pnpm cli:bundle`
Run tests	`pnpm cli:test`
Format	`pnpm cli:format`
Lint	`pnpm cli:lint`

For dough-test-optimization, measure pnpm cli:test as the complete ordinary feedback path, including the Python tests. For per-test Vitest durations, use CURSOR_DEV=true nix develop -c pnpm -C cli exec vitest run --reporter=json; that narrower profile does not replace verification or timing of the complete CLI command.

Architecture notes

CLI architecture guidance lives in this rule and in cli/ code layout.

Apply architectural changes when a feature needs them; challenge the fit first.

Read the full file on GitHub · 120 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.

1mo ago First seen · 120 lines · 14 tokens per session scan A 5ffddc05a82a

Subscribe to this mod's changes

cli is a skill published in the GitHub repository nerds-odd-e/doughnut (50 stars, last pushed today), licensed MIT. It adds 14 tokens to every session and 3,691 once invoked, about $0.0001 per session on Opus 5.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-09-17.

Languages TypeScript

no-bare-casts

Writing as in TypeScript or TSX production code, modifying a file that contains a bare as cast, silencing a type error with a cast, encountering as unknown as, or reviewing a cast site.

prisma/orm · 52 tokens

aws-sst-development

SST v4 (Ion) expert for managing AWS resources as code with the Pulumi-backed framework.

sickn33/agentic-awesome-skills · 26 tokens

league-akari-shard-development

Use when creating, extending, refactoring, splitting, or reviewing League Akari main or renderer shards, including shard file organization, controller/loader/executor/handler boundaries, naming conventions, renderer TSX usage, platform guards, and public contract compatibility.

LeagueAkari/LeagueAkari · 58 tokens

dd-code-generation

Use pup CLI for immediate Datadog operations or generate code for integration into applications.

DataDog/pup · 16 tokens

fast-typescript-check

Keep www-sacred's TypeScript fast to type-check and fast to run. Use when touching the ASCII/canvas animation components (the only real per-frame code here), tightening type-check wall-clock, or auditing a change for runtime or compiler regressions. Scoped to this repo — a React 19 / Next.js 16 component library plus…

internet-development/www-sacred · 84 tokens

typescript-magician

Designs complex generic types, refactors any types to strict alternatives, creates type guards and utility types, and resolves TypeScript compiler errors. Use when the user asks about TypeScript (TS) types, generics, type inference, type guards, removing any types, strict typing, type errors, infer, extends…

mcollina/skills · 108 tokens

doughnut: Skill for Claude Code