Skip to content

Commit 0310c78

Browse files
committed
docs(agents): document implementation language choices
Route small command-oriented automation to Nushell and data-heavy, testable automation to Babashka. Keep production binaries in Rust and npm-integrated APIs in TypeScript so future tooling changes follow the same criteria used by the benchmark migration.
1 parent 7337292 commit 0310c78

1 file changed

Lines changed: 4 additions & 0 deletions

File tree

‎AGENTS.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,10 @@ Check the nearest package-specific `AGENTS.md` before editing package code:
3333
## Always-On Reminders
3434

3535
- The canonical user-facing CLI is `ccusage` with agent subcommands such as `ccusage amp`, `ccusage codex`, `ccusage opencode`, and `ccusage pi`.
36+
- Use Nushell for small structured automation that primarily orchestrates external commands, files, HTTP, and JSON.
37+
- Use Babashka when automation develops a reusable data model, multiple transformation stages, substantial reporting logic, or focused unit tests.
38+
- Use Rust for production binaries and CPU- or memory-intensive tooling.
39+
- Use TypeScript when the implementation directly benefits from the npm and JavaScript ecosystem or exposes a JavaScript API.
3640
- Standalone agent wrapper packages have been removed. Do not add docs, tests, or features that promote `ccusage-amp`, `ccusage-codex`, `ccusage-opencode`, or `ccusage-pi`.
3741
- Runtime libraries for bundled packages belong in `devDependencies` unless explicitly requested otherwise.
3842
- When initializing this repository environment, run `direnv allow` so the pinned Nix dev shell is activated.

0 commit comments

Comments
 (0)