ccusage Development
SkillDev toolsThis skill guides your AI through development work on the ccusage repository. Once added, it can edit workspace packages, update the npm launcher or native packaging, and adjust dependencies or shared configuration. It also knows how to run the project's build, typecheck, test, format, and check commands.
Available today. Use it from your connected AI after setup.
No other account needed.
After adding it, give your AI a ccusage task, such as editing a package or running the build or tests, and it will follow the project's own workflow.
Then ask your AI: use the ccusage Development skill
What your AI can do with it
- Edit workspace packages in the ccusage repository
- Update the npm launcher or native packaging
- Manage dependencies and shared configuration
- Run the project build
- Run typechecks and tests
- Format code and run the full check
What this skill tells your AI
The instructions your AI receives, as published by ccusage/ccusage in .agents/skills/development/SKILL.md and read by ahel’s review.
Root AGENTS.md holds the repository shape and the standing policies. This
skill is about working in the tree: the npm packaging seam, the recipes, and
validation.
The npm Packaging Seam
apps/ccusage is the npm shell around the Rust binary — package metadata,
config-schema.json, and the packaging and benchmark scripts. Its
src/cli.js launcher resolves the platform binary from the matching
@ccusage/ccusage-<platform>-<arch> optional dependency and spawns it; those
packages live in packages/ccusage-<platform>-<arch> and ship nothing but
bin/ccusage.
The Nushell scripts in apps/ccusage/scripts/ own the binary side and share
native-binary.nu: ensure-native-binary.nu puts a usable, portable binary in
place for a local build, stage-native-package.nu fills one platform package,
and verify-native-package.nu runs from each platform package's prepack. A
packaging change usually touches the launcher and those scripts together.
Gotchas
.claude/skillsis generated from.agents/skillsbynix/agent-skills.nix. Edit the source tree; leave the generated one uncommitted.LOG_LEVELgates runtime noise (rust/crates/ccusage-core/src/logger.rs):0suppresses progress and box titles,>= 4logs pricing refresh detail. UseLOG_LEVEL=0whenever output is captured or compared.
references/commands.md covers just, where a new dependency or tool belongs,
validation, and releases.
Signals
- GitHub stars
- 19k
- Forks
- 830
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
development- Source
- github.com/ccusage/ccusage