feat!: remove legacy ccusage packages

Author: ryoppippi

.agents/skills/ccusage-agent-sources/SKILL.md

@@ -21,7 +21,7 @@ ccusage amp daily
 ccusage pi daily
 ```
 
-Standalone agent binaries such as `ccusage-codex`, `ccusage-opencode`, `ccusage-amp`, and `ccusage-pi` are deprecated compatibility wrappers. Preserve compatibility when needed, but do not promote standalone binaries in new docs, tests, or examples.
+Standalone agent wrapper packages have been removed. Use the unified `ccusage <agent> ...` commands in docs, tests, and examples, and do not reintroduce wrapper commands such as `ccusage-codex`, `ccusage-opencode`, `ccusage-amp`, or `ccusage-pi`.
 
 Cost modes:
 
@@ -46,13 +46,12 @@ Read only the relevant reference before changing parser behavior, token mappings
 - Treat Codex, OpenCode, Amp, and pi-agent as agent subcommands under the unified `ccusage` CLI.
 - Reuse shared packages such as `@ccusage/terminal`, `@ccusage/internal`, pricing helpers, and logging where appropriate.
 - Keep command names and flag semantics aligned unless the source data forces a difference.
-- Internal workspace runtime libraries for bundled/private agent apps belong in `devDependencies`.
-- Deprecated wrapper packages must keep install-time runtime dependencies such as `ccusage` in `dependencies`.
+- Internal workspace runtime libraries for bundled/private packages belong in `devDependencies`.
 
 ## Adapter Layout
 
 New or migrated agent implementations belong under `apps/ccusage/src/adapter/<agent>/`.
-Keep agent-specific code there, not in deprecated wrapper packages. Split files by responsibility when the implementation grows:
+Keep agent-specific code there. Split files by responsibility when the implementation grows:
 
 - `index.ts` - thin public adapter surface: `detect<Agent>()`, `load<Agent>Rows()`, and high-level wiring.
 - `paths.ts` - environment variables, default directories, and path discovery.
@@ -76,7 +75,7 @@ Before adding or changing an adapter, read `apps/ccusage/src/adapter/ARCHITECTUR
 For each migrated or new agent:
 
 - Put all source-specific runtime logic under `apps/ccusage/src/adapter/<agent>/`.
-- Keep deprecated wrapper packages as thin compatibility commands only.
+- Keep agent-specific package logic under `apps/ccusage/src/adapter/<agent>/`.
 - Implement fast detection that short-circuits once a usable source file is found.
 - Use shared file walking, JSONL byte marker scanning where applicable, worker gating, logging, pricing fetcher lifecycle, date formatting, table rendering, and all-agent aggregation.
 - Keep adapter code responsible for source paths, raw parsing, token mapping, model mapping, source metadata, and agent-specific pricing.

.agents/skills/ccusage-development/SKILL.md

@@ -10,10 +10,6 @@ description: Work in the ccusage monorepo with its unified ccusage command surfa
 This is a monorepo. Check the nearest package-specific `CLAUDE.md` before editing a package:
 
 - `apps/ccusage/CLAUDE.md` - main Claude Code usage CLI and library
-- `apps/codex/CLAUDE.md` - Codex usage tracking CLI
-- `apps/opencode/CLAUDE.md` - OpenCode usage tracking CLI
-- `apps/amp/CLAUDE.md` - Amp usage tracking CLI
-- `apps/pi/CLAUDE.md` - pi-agent usage tracking CLI
 - `docs/CLAUDE.md` - VitePress documentation site
 
 The canonical user-facing command is `ccusage` with agent subcommands:
@@ -26,9 +22,9 @@ ccusage amp daily
 ccusage pi daily
 ```
 
-Standalone agent binaries such as `ccusage-codex`, `ccusage-opencode`, `ccusage-amp`, and `ccusage-pi` are deprecated compatibility wrappers. Keep backward compatibility where it already exists, but prefer `ccusage <agent> ...` in docs, tests, examples, and new behavior.
+Standalone agent wrapper packages have been removed. Prefer `ccusage <agent> ...` in docs, tests, examples, and new behavior, and do not reintroduce wrapper commands such as `ccusage-codex`, `ccusage-opencode`, `ccusage-amp`, or `ccusage-pi`.
 
-Agent apps are still bundled runtime payloads. Treat runtime libraries as bundled assets: add dependencies to each app's `devDependencies` unless the user explicitly asks otherwise. Deprecated wrapper packages are the exception: keep install-time dependencies such as `ccusage` in `dependencies` when the wrapper needs them after installation.
+Agent implementations live inside the bundled `ccusage` package. Treat runtime libraries as bundled assets: add dependencies to each package's `devDependencies` unless the user explicitly asks otherwise.
 
 ## Common Commands
 
@@ -59,7 +55,7 @@ Tools are managed by `flake.nix` and `package.json`. Use `comma` or `nix run` fo
 - Use Gunshi for CLI commands; use the `use-gunshi-cli` skill for details.
 - Only export constants, functions, and types used by other modules.
 - Keep internal-only files and helpers private where possible.
-- Dependency additions go in `devDependencies` for bundled/private packages, but keep install-time wrapper dependencies in `dependencies`.
+- Dependency additions go in `devDependencies` for bundled/private packages.
 
 ## Post-Change Workflow
 

.agents/skills/ccusage-docs/SKILL.md

@@ -28,7 +28,7 @@ The docs build copies `apps/ccusage/config-schema.json` to `docs/public/config-s
 ## Content Rules
 
 - Prefer the unified command form in new or edited docs: `ccusage codex ...`, `ccusage opencode ...`, `ccusage amp ...`, and `ccusage pi ...`.
-- Standalone wrapper commands such as `ccusage-codex`, `ccusage-opencode`, `ccusage-amp`, and `ccusage-pi` are deprecated. Mention them only for migration or compatibility notes.
+- Standalone wrapper commands such as `ccusage-codex`, `ccusage-opencode`, `ccusage-amp`, and `ccusage-pi` have been removed. Do not promote or reintroduce them in docs.
 - Place screenshots immediately after the page H1 when a guide has a primary screenshot.
 - Use relative image paths such as `/screenshot.png` for files in `docs/public/`.
 - Always include descriptive alt text for screenshots and images.

CLAUDE.md

@@ -27,17 +27,13 @@ Use these skills before working in this repository:
 Check the nearest package-specific `CLAUDE.md` before editing package code:
 
 - `apps/ccusage/CLAUDE.md` - main Claude Code usage CLI and library
-- `apps/codex/CLAUDE.md` - Codex usage tracking CLI
-- `apps/opencode/CLAUDE.md` - OpenCode usage tracking CLI
-- `apps/amp/CLAUDE.md` - Amp usage tracking CLI
-- `apps/pi/CLAUDE.md` - pi-agent usage tracking CLI
 - `docs/CLAUDE.md` - VitePress documentation site
 
 ## Always-On Reminders
 
 - The canonical user-facing CLI is `ccusage` with agent subcommands such as `ccusage amp`, `ccusage codex`, `ccusage opencode`, and `ccusage pi`.
-- Standalone agent binaries such as `ccusage-amp`, `ccusage-codex`, `ccusage-opencode`, and `ccusage-pi` are deprecated compatibility wrappers. Do not add new docs, tests, or features that promote them as the primary interface.
-- Agent apps are still bundled runtime payloads. Put runtime libraries in each app's `devDependencies` unless explicitly requested otherwise. Deprecated wrapper packages may keep install-time dependencies such as `ccusage` in `dependencies`.
+- 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`.
+- Runtime libraries for bundled packages belong in `devDependencies` unless explicitly requested otherwise.
 - Prefer tools provided by the Nix dev shell before falling back to ad hoc installs: `rg`, `fd`, `fzf`, `delta`, `dust`, `jq`, `gh`, `hyperfine`, `similarity`, `typos`, and `typos-lsp`. When a missing tool would be useful for repeated agent work in this repository, add it to `flake.nix`.
 - Use `logger.ts` instead of `console.log`.
 - Use `.ts` extensions for local imports.

CONTRIBUTING.md

@@ -49,7 +49,7 @@ pnpm typecheck
 pnpm run test
 ```
 
-Use the canonical `ccusage` command in docs and tests. Deprecated compatibility wrappers such as `ccusage-codex`, `ccusage-opencode`, `ccusage-amp`, and `ccusage-pi` should not be promoted as the primary interface.
+Use the canonical `ccusage` command in docs and tests. Standalone wrapper packages such as `ccusage-codex`, `ccusage-opencode`, `ccusage-amp`, and `ccusage-pi` have been removed and should not be reintroduced.
 
 Do not proactively create documentation files unless the change requires user-facing documentation.
 

apps/amp/README.md

@@ -23,28 +23,10 @@
 
 > Analyze coding (agent) CLI token usage and costs from local data.
 
-## ccusage Family
-
-### 📊 [ccusage](https://www.npmjs.com/package/ccusage) - Coding (Agent) CLI Usage Analyzer
+## Supported Sources
 
 The main CLI tool for analyzing Claude Code, Codex, OpenCode, Amp, and pi-agent usage from local data. Track daily, weekly, monthly, and session-based usage with beautiful tables.
 
-### 🤖 [@ccusage/codex](https://www.npmjs.com/package/@ccusage/codex) - Codex Compatibility Wrapper
-
-Compatibility wrapper for OpenAI Codex usage. Prefer `ccusage codex` or `ccusage codex daily`.
-
-### 🚀 [@ccusage/opencode](https://www.npmjs.com/package/@ccusage/opencode) - OpenCode Compatibility Wrapper
-
-Compatibility wrapper for [OpenCode](https://github.com/opencode-ai/opencode) usage. Prefer `ccusage opencode`.
-
-### 🥧 [@ccusage/pi](https://www.npmjs.com/package/@ccusage/pi) - pi-agent Compatibility Wrapper
-
-Compatibility wrapper for [pi-agent](https://github.com/badlogic/pi-mono) usage. Prefer `ccusage pi`.
-
-### ⚡ [@ccusage/amp](https://www.npmjs.com/package/@ccusage/amp) - Amp Compatibility Wrapper
-
-Compatibility wrapper for [Amp](https://ampcode.com/) usage. Prefer `ccusage amp`.
-
 ## Installation
 
 ### Quick Start (Recommended)
@@ -64,15 +46,6 @@ npx ccusage@latest
 > 💡 **Runtime**: `bunx ccusage` is recommended for everyday use. If you use `npx`, include `@latest` and use Node.js 22+.
 > Because the published CLI shebang targets Node.js, package runners can start ccusage under Node.js even when launched through `bunx`. When ccusage finds `bun` in `PATH`, it automatically re-runs the bundled entrypoint with Bun for better warm runtime performance. Set `CCUSAGE_BUN_AUTO_RUN=0` to force Node.js.
 
-### Compatibility Packages
-
-```bash
-npx @ccusage/codex@latest       # Deprecated wrapper for: ccusage codex
-npx @ccusage/opencode@latest    # Deprecated wrapper for: ccusage opencode
-npx @ccusage/pi@latest          # Deprecated wrapper for: ccusage pi
-npx @ccusage/amp@latest         # Deprecated wrapper for: ccusage amp
-```
-
 ## Usage
 
 ```bash

apps/amp/index.js

@@ -39,7 +39,7 @@ Use small files under each adapter directory:
 - `pricing.ts` or `pricing-macro.ts` - model aliases, provider filters, and bundled pricing.
 - `types.ts` - adapter-local types.
 
-Do not put new source logic in deprecated standalone packages. Those packages are compatibility wrappers; ccusage adapter directories are the implementation home.
+Do not put source logic outside the ccusage adapter directories. The standalone wrapper packages have been removed, and `apps/ccusage/src/adapter/<agent>/` is the implementation home.
 
 When migrating an existing root-level implementation into an adapter, update internal import sites to point at `adapter/<agent>/...` directly. Avoid root-level re-export shims unless the path is part of the package's declared public exports or a dedicated bundled worker entry. `apps/ccusage/src/data-loader.ts` is such an entry: it keeps the optimized Claude loader in the separate `data-loader` chunk introduced by PR #984, while source logic stays under `adapter/claude/`.