docs: RTK documentation update - upstream + fork integration
- Update guide/ultimate-guide.md: RTK section (l.11084-11174) - Two repositories: upstream (stable) + fork (extended features) - Fork features: vitest, pnpm, prisma, gain, discover - Bug fixes documented (grep/ls fixed in fork) - Installation options: cargo, fork, binary - Add guide/third-party-tools.md: RTK card (l.86) - Comparison upstream vs fork - Token savings: 70-90% depending on stack - Cross-reference to ultimate-guide Section 9 - Update machine-readable/reference.yaml: - rtk_upstream + rtk_fork_extended (two repos) - third_party_tools_rtk entry added - Line numbers updated - Update docs/resource-evaluations/rtk-evaluation.md: - UPDATE 2026-02-01 section with fork comparison - Fork features table (JS/TS stack support) - Installation instructions for fork Total: 4 files, ~320 lines modified Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
parent
9f9f735436
commit
fdee3305c5
4 changed files with 435 additions and 31 deletions
|
|
@ -1,16 +1,47 @@
|
|||
# Resource Evaluation: RTK (Rust Token Killer)
|
||||
|
||||
**Date**: 2026-01-28
|
||||
**Date**: 2026-01-28 (Updated: 2026-02-01)
|
||||
**Evaluator**: Claude Sonnet 4.5
|
||||
**Resource URL**: https://github.com/pszymkowiak/rtk
|
||||
**Resource URL**: https://github.com/pszymkowiak/rtk (upstream)
|
||||
**Fork URL**: https://github.com/FlorianBruniaux/rtk (extended)
|
||||
**Resource Type**: CLI Tool (Rust)
|
||||
**Author**: pszymkowiak
|
||||
**Version Tested**: v0.2.0 (2026-01-23)
|
||||
**Community Engagement**: 8 stars, 0 forks (as of 2026-01-28)
|
||||
**Author**: pszymkowiak (upstream), FlorianBruniaux (fork)
|
||||
**Version Tested**: v0.2.0 upstream, v0.4.0+ fork (feat/all-features)
|
||||
**Community Engagement**: 8 stars (upstream), fork active development
|
||||
|
||||
---
|
||||
|
||||
## Executive Summary
|
||||
## 🆕 UPDATE 2026-02-01: Extended Fork Available
|
||||
|
||||
**Fork Status**: An extended fork by FlorianBruniaux adds critical missing features:
|
||||
|
||||
| Feature | Upstream v0.2.0 | Fork v0.4.0+ |
|
||||
|---------|----------------|--------------|
|
||||
| **JS/TS Stack** | ❌ Not supported | ✅ `rtk vitest`, `rtk pnpm`, `rtk prisma` |
|
||||
| **Bug Fixes** | ❌ grep/ls broken | ✅ Fixed in fork |
|
||||
| **Analytics** | ❌ None | ✅ `rtk gain`, `rtk discover` |
|
||||
| **Token Savings** | 72.6% (git only) | 70-90% (full stack) |
|
||||
|
||||
**Fork Highlights**:
|
||||
- ✅ `rtk vitest run` - 90% reduction on test outputs
|
||||
- ✅ `rtk pnpm list` - 70% reduction on package trees
|
||||
- ✅ `rtk prisma migrate` - Migration status filtered
|
||||
- ✅ `rtk gain` - Token savings analytics dashboard
|
||||
- ✅ `rtk discover` - Find missed optimization opportunities
|
||||
- ✅ Bug fixes: grep and ls now work correctly
|
||||
|
||||
**Installation (Fork)**:
|
||||
```bash
|
||||
git clone https://github.com/FlorianBruniaux/rtk.git
|
||||
cd rtk && git checkout feat/all-features
|
||||
cargo install --path . --force
|
||||
```
|
||||
|
||||
**Recommendation Update**: Fork addresses all critical gaps identified in this evaluation. For modern JS/TS stacks (T3 Stack, Next.js, etc.), **use the fork**. For git-only workflows, upstream remains stable.
|
||||
|
||||
---
|
||||
|
||||
## Executive Summary (Original Evaluation - Upstream v0.2.0)
|
||||
|
||||
RTK (Rust Token Killer) is a high-performance CLI proxy that filters and compresses command outputs **before they reach LLM contexts**. Real-world testing on the Claude Code Ultimate Guide repository confirms **72.6% average token reduction** across git workflows (92.3% for `git log`), validating the advertised 70% savings claim.
|
||||
|
||||
|
|
|
|||
344
guide/third-party-tools.md
Normal file
344
guide/third-party-tools.md
Normal file
|
|
@ -0,0 +1,344 @@
|
|||
# Third-Party Tools for Claude Code
|
||||
|
||||
> Community tools for token tracking, session management, configuration, and alternative UIs.
|
||||
>
|
||||
> **Last verified**: February 2026
|
||||
|
||||
## Table of Contents
|
||||
|
||||
1. [About This Page](#about-this-page)
|
||||
2. [Token & Cost Tracking](#token--cost-tracking)
|
||||
3. [Session Management](#session-management)
|
||||
4. [Configuration Management](#configuration-management)
|
||||
5. [Alternative UIs](#alternative-uis)
|
||||
6. [Multi-Agent Orchestration](#multi-agent-orchestration)
|
||||
7. [Plugin Ecosystem](#plugin-ecosystem)
|
||||
8. [Known Gaps](#known-gaps)
|
||||
9. [Recommendations by Persona](#recommendations-by-persona)
|
||||
|
||||
---
|
||||
|
||||
## About This Page
|
||||
|
||||
This page catalogs **community-built tools that extend Claude Code**. Each tool has been verified against its public repository or package registry. Only tools with a public source (GitHub, npm, PyPI) are included.
|
||||
|
||||
**What this page is NOT**:
|
||||
- Not a list of AI tools that complement Claude Code (see [AI Ecosystem](./ai-ecosystem.md))
|
||||
- Not DIY monitoring scripts (see [Observability](./observability.md))
|
||||
- Not MCP server recommendations (see [MCP Servers Ecosystem](./mcp-servers-ecosystem.md))
|
||||
|
||||
---
|
||||
|
||||
## Token & Cost Tracking
|
||||
|
||||
### ccusage
|
||||
|
||||
The most mature cost tracking tool for Claude Code. Parses local session data to produce cost reports by day, month, session, or 5-hour billing window.
|
||||
|
||||
| Attribute | Details |
|
||||
|-----------|---------|
|
||||
| **Source** | [npm: ccusage](https://www.npmjs.com/package/ccusage) / [ccusage.com](https://ccusage.com) |
|
||||
| **Install** | `bunx ccusage` (fastest) or `npx ccusage` |
|
||||
| **Language** | TypeScript (Node.js 18+) |
|
||||
| **Version** | 18.x (actively maintained) |
|
||||
|
||||
**Key features**:
|
||||
|
||||
- `ccusage daily` / `ccusage monthly` / `ccusage session` - aggregated cost reports
|
||||
- `ccusage blocks --live` - real-time monitoring against 5-hour billing windows
|
||||
- `--breakdown` flag for per-model cost split (Opus/Sonnet/Haiku)
|
||||
- `--since` / `--until` date filtering
|
||||
- JSON output (`--json`) for programmatic access
|
||||
- Offline mode with cached pricing data
|
||||
- MCP server integration (`@ccusage/mcp`)
|
||||
- macOS widget (`ccusage-widget`) and [Raycast extension](https://www.raycast.com/nyatinte/ccusage)
|
||||
|
||||
**Limitations**: Relies on local JSONL parsing; cost estimates may differ from official Anthropic billing. No team aggregation without manual log merging.
|
||||
|
||||
> **Cross-ref**: The main guide covers basic ccusage commands at [ultimate-guide.md Section 2.4](./ultimate-guide.md) (cost monitoring).
|
||||
> For DIY cost tracking with hooks, see [Observability](./observability.md).
|
||||
|
||||
---
|
||||
|
||||
### ccburn
|
||||
|
||||
A Python TUI for visual token burn-rate tracking. Displays charts showing consumption rate relative to Claude's billing windows.
|
||||
|
||||
| Attribute | Details |
|
||||
|-----------|---------|
|
||||
| **Source** | [GitHub: JuanjoFuchs/ccburn](https://github.com/JuanjoFuchs/ccburn) / [Blog post](https://juanjofuchs.github.io/ai-development/2026/01/13/introducing-ccburn-visual-token-tracking.html) |
|
||||
| **Install** | `pip install ccburn` |
|
||||
| **Language** | Python 3.10+ (Rich + Plotext) |
|
||||
|
||||
**Key features**:
|
||||
|
||||
- Terminal charts showing token consumption over time
|
||||
- Burn-rate indicators (on-track / slow-down warnings)
|
||||
- Compact display mode
|
||||
- Visual budget tracking against limits
|
||||
|
||||
**Limitations**: Python-only ecosystem. Smaller community than ccusage. No MCP integration.
|
||||
|
||||
**When to choose ccburn over ccusage**: If you prefer visual burn-rate charts over tabular reports, or if your toolchain is Python-based.
|
||||
|
||||
---
|
||||
|
||||
### RTK (Rust Token Killer)
|
||||
|
||||
A CLI proxy that filters command outputs **before** they reach Claude's context.
|
||||
|
||||
| Attribute | Details |
|
||||
|-----------|---------|
|
||||
| **Source** | [GitHub: pszymkowiak/rtk](https://github.com/pszymkowiak/rtk) (upstream stable) |
|
||||
| **Fork** | [GitHub: FlorianBruniaux/rtk](https://github.com/FlorianBruniaux/rtk) (extended features) |
|
||||
| **Install** | `cargo install rtk` or binary download |
|
||||
| **Language** | Rust (standalone binary) |
|
||||
| **Version** | v0.2.0+ (upstream), v0.4.0+ (fork) |
|
||||
|
||||
**Key features**:
|
||||
|
||||
- `rtk git log` (92% reduction), `rtk git status` (76% reduction), `rtk git diff` (56% reduction)
|
||||
- `rtk vitest run`, `rtk prisma`, `rtk pnpm` (fork only, 70-90% reduction)
|
||||
- `rtk gain` - token savings analytics
|
||||
- `rtk discover` - find missed optimization opportunities (fork only)
|
||||
|
||||
**Two versions:**
|
||||
|
||||
- **Upstream** (pszymkowiak): Stable, git/find/cat focus, minimal dependencies
|
||||
- **Fork** (FlorianBruniaux): Adds JS/TS stack support (vitest, pnpm, prisma), bug fixes (grep, ls), analytics
|
||||
|
||||
**When to choose RTK vs ccusage/ccburn**:
|
||||
|
||||
- RTK **reduces** token consumption (preprocessing)
|
||||
- ccusage/ccburn **monitor** it (postprocessing)
|
||||
- Use both together for maximum efficiency
|
||||
|
||||
**Limitations**: Early-stage project. Upstream has grep/ls bugs (fixed in fork). Not suitable for interactive commands or very small outputs.
|
||||
|
||||
> **Cross-ref**: Full docs at [ultimate-guide.md Section 9](./ultimate-guide.md#command-output-optimization-with-rtk)
|
||||
|
||||
---
|
||||
|
||||
## Session Management
|
||||
|
||||
### claude-code-viewer
|
||||
|
||||
A web-based UI for browsing and reading Claude Code conversation history (JSONL files).
|
||||
|
||||
| Attribute | Details |
|
||||
|-----------|---------|
|
||||
| **Source** | [GitHub: d-kimuson/claude-code-viewer](https://github.com/d-kimuson/claude-code-viewer) / [npm: @kimuson/claude-code-viewer](https://www.npmjs.com/package/@kimuson/claude-code-viewer) |
|
||||
| **Install** | `npx @kimuson/claude-code-viewer` or `npm install -g @kimuson/claude-code-viewer` |
|
||||
| **Language** | TypeScript (Node.js 18+) |
|
||||
| **Version** | 0.5.x |
|
||||
|
||||
**Key features**:
|
||||
|
||||
- Project browser with session counts and metadata
|
||||
- Full conversation display with syntax highlighting
|
||||
- Tool usage results inline
|
||||
- Real-time updates via Server-Sent Events (auto-refreshes when files change)
|
||||
- Responsive design (desktop + mobile)
|
||||
|
||||
**Limitations**: Read-only (cannot edit or resume sessions). No cost data. Requires existing `~/.claude/projects/` history.
|
||||
|
||||
> **Cross-ref**: For session search from the CLI, see [session-search.sh](../examples/scripts/session-search.sh) in [Observability](./observability.md).
|
||||
|
||||
---
|
||||
|
||||
## Configuration Management
|
||||
|
||||
### claude-code-config
|
||||
|
||||
A TUI for managing `~/.claude.json` configuration, focused on MCP server management.
|
||||
|
||||
| Attribute | Details |
|
||||
|-----------|---------|
|
||||
| **Source** | [GitHub: joeyism/claude-code-config](https://github.com/joeyism/claude-code-config) |
|
||||
| **Install** | `pip install claude-code-config` |
|
||||
| **Language** | Python (Textual TUI) |
|
||||
|
||||
**Key features**:
|
||||
|
||||
- Visual MCP server management (add, edit, remove)
|
||||
- Configuration file editing with validation
|
||||
- TUI navigation for `~/.claude.json` structure
|
||||
|
||||
**Limitations**: Limited to `~/.claude.json` scope. Does not manage `.claude/settings.json`, hooks, or slash commands.
|
||||
|
||||
---
|
||||
|
||||
### AIBlueprint
|
||||
|
||||
A CLI that scaffolds pre-configured Claude Code setups with hooks, commands, statusline, and workflow automation.
|
||||
|
||||
| Attribute | Details |
|
||||
|-----------|---------|
|
||||
| **Source** | [GitHub: Melvynx/aiblueprint](https://github.com/Melvynx/aiblueprint) |
|
||||
| **Install** | `npx aiblueprint-cli` |
|
||||
| **Language** | TypeScript |
|
||||
|
||||
**Key features**:
|
||||
|
||||
- Pre-built security hooks
|
||||
- Custom command templates
|
||||
- Statusline configuration
|
||||
- Workflow automation presets
|
||||
|
||||
**Limitations**: Opinionated configuration choices. Some features require a premium tier. Does not read existing config (scaffolds from scratch).
|
||||
|
||||
> **Cross-ref**: For manual Claude Code configuration, see [ultimate-guide.md Section 4](./ultimate-guide.md) (CLAUDE.md, settings, hooks, commands).
|
||||
|
||||
---
|
||||
|
||||
## Alternative UIs
|
||||
|
||||
### Claude Chic
|
||||
|
||||
A styled terminal UI for Claude Code built on Anthropic's claude-agent-sdk. Replaces the default Claude Code TUI with a visually enhanced experience.
|
||||
|
||||
| Attribute | Details |
|
||||
|-----------|---------|
|
||||
| **Source** | [Blog: matthewrocklin.com](https://matthewrocklin.com/introducing-claude-chic/) / [PyPI: claudechic](https://pypi.org/project/claudechic/) |
|
||||
| **Install** | `uvx claudechic` |
|
||||
| **Language** | Python (Textual + claude-agent-sdk) |
|
||||
| **Status** | Alpha |
|
||||
|
||||
**Key features**:
|
||||
|
||||
- Color-coded messages (orange: user, blue: Claude, grey: tools)
|
||||
- Collapsible tool usage blocks
|
||||
- Git worktree management from within the UI
|
||||
- Multiple agents in a single window
|
||||
- `/diff` viewer, vim keybindings (`/vim`), shell commands (`!ls`)
|
||||
- Proper Markdown rendering with streaming
|
||||
|
||||
**Limitations**: Alpha status - expect breaking changes. Python dependency chain. Requires claude-agent-sdk. macOS/Linux only.
|
||||
|
||||
---
|
||||
|
||||
### Toad
|
||||
|
||||
A universal terminal frontend for AI coding agents. Supports Claude Code alongside Gemini CLI, OpenHands, Codex, and 12+ other agents via the Agent Client Protocol (ACP).
|
||||
|
||||
| Attribute | Details |
|
||||
|-----------|---------|
|
||||
| **Source** | [GitHub: batrachianai/toad](https://github.com/batrachianai/toad) / [willmcgugan.github.io/toad-released](https://willmcgugan.github.io/toad-released/) |
|
||||
| **Install** | `curl -fsSL batrachian.ai/install \| sh` or `uv tool install -U batrachian-toad --python 3.14` |
|
||||
| **Author** | Will McGugan (creator of Rich & Textual) |
|
||||
| **Language** | Python (Textual) |
|
||||
|
||||
**Key features**:
|
||||
|
||||
- Unified interface across 12+ agent CLIs
|
||||
- Full shell integration with tab completion
|
||||
- `@` file context injection with fuzzy search
|
||||
- Side-by-side diffs with syntax highlighting
|
||||
- Jupyter-inspired block navigation
|
||||
- Flicker-free character-level rendering
|
||||
|
||||
**Limitations**: macOS/Linux only (Windows via WSL). Agent support varies by ACP compatibility. No built-in session persistence yet (on roadmap).
|
||||
|
||||
---
|
||||
|
||||
### Conductor
|
||||
|
||||
A macOS desktop app for orchestrating multiple Claude Code instances in parallel using git worktrees.
|
||||
|
||||
| Attribute | Details |
|
||||
|-----------|---------|
|
||||
| **Source** | [conductor.build](https://docs.conductor.build) |
|
||||
| **Install** | Download from [conductor.build](https://docs.conductor.build) |
|
||||
| **Platform** | macOS only (Windows/Linux planned) |
|
||||
|
||||
**Key features**:
|
||||
|
||||
- Parallel Claude Code agents on separate git worktrees
|
||||
- Unified diff viewer for all agent changes
|
||||
- GitHub and Linear integration (inject issues as context)
|
||||
- MCP support and slash commands (`/research`)
|
||||
- Planning mode with bulk context injection
|
||||
|
||||
**Limitations**: macOS only (as of Feb 2026). Proprietary (not open source). Overlaps with multi-agent orchestration (see below).
|
||||
|
||||
---
|
||||
|
||||
### Claude Code GUI (VS Code Extension)
|
||||
|
||||
A third-party VS Code extension (not Anthropic's official extension) that adds a graphical layer on top of Claude Code.
|
||||
|
||||
| Attribute | Details |
|
||||
|-----------|---------|
|
||||
| **Source** | [VS Code Marketplace: MaheshKok.claude-code-gui](https://marketplace.visualstudio.com/items?itemName=MaheshKok.claude-code-gui) |
|
||||
| **Install** | VS Code Marketplace → search "Claude Code GUI" |
|
||||
|
||||
**Note**: This is **not** the official [Claude Code for VS Code](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code) extension by Anthropic. The official extension provides inline diffs, @-mentions, and plan review directly in the editor.
|
||||
|
||||
**Limitations**: Third-party, not Anthropic-maintained. Feature set may overlap with or lag behind the official extension.
|
||||
|
||||
---
|
||||
|
||||
## Multi-Agent Orchestration
|
||||
|
||||
This section covers tools for running **multiple Claude Code instances in parallel**. For detailed documentation, see:
|
||||
|
||||
- **[AI Ecosystem](./ai-ecosystem.md)** - Gas Town, multiclaude, agent-chat, claude-squad
|
||||
- **[Ultimate Guide Section 9](./ultimate-guide.md)** - Multi-instance workflows, git worktrees, orchestration frameworks
|
||||
|
||||
**Quick reference**:
|
||||
|
||||
| Tool | Type | Key Feature |
|
||||
|------|------|-------------|
|
||||
| [Gas Town](https://github.com/steveyegge/gastown) | Multi-agent workspace | Steve Yegge's agent-first workspace manager |
|
||||
| [multiclaude](https://github.com/dlorenc/multiclaude) | Multi-agent spawner | tmux + git worktrees (383+ stars) |
|
||||
| [agent-chat](https://github.com/justinabrahms/agent-chat) | Monitoring UI | Real-time SSE monitoring for Gas Town/multiclaude |
|
||||
| [Conductor](#conductor) | Desktop app | macOS parallel agents (also listed above) |
|
||||
|
||||
---
|
||||
|
||||
## Plugin Ecosystem
|
||||
|
||||
Claude Code's plugin system supports community-built extensions. For detailed documentation:
|
||||
|
||||
- **[Ultimate Guide Section 8](./ultimate-guide.md)** - Plugin system, commands, installation
|
||||
- **[claude-plugins.dev](https://claude-plugins.dev)** - 11,989 plugins, 63,065 skills indexed
|
||||
- **[claudemarketplaces.com](https://claudemarketplaces.com)** - Auto-scan GitHub for marketplace plugins
|
||||
- **[agentskills.io](https://agentskills.io)** - Open standard for agent skills (26+ platforms)
|
||||
|
||||
---
|
||||
|
||||
## Known Gaps
|
||||
|
||||
As of February 2026, the community tooling ecosystem has notable gaps:
|
||||
|
||||
| Gap | Description |
|
||||
|-----|-------------|
|
||||
| **Visual skills editor** | No GUI for creating/editing `.claude/skills/` — must edit YAML/Markdown manually |
|
||||
| **Visual hooks editor** | No GUI for managing hooks in `settings.json` — requires JSON editing |
|
||||
| **Unified admin panel** | No single dashboard combining config, sessions, cost, and MCP management |
|
||||
| **Session replay** | No tool replays sessions with playback controls (only static viewing) |
|
||||
| **Per-MCP-server profiler** | No way to measure token cost attributable to each MCP server individually |
|
||||
| **Cross-platform config sync** | No tool syncs Claude Code config across machines (must manual copy `~/.claude/`) |
|
||||
|
||||
---
|
||||
|
||||
## Recommendations by Persona
|
||||
|
||||
| Persona | Recommended Tools | Rationale |
|
||||
|---------|-------------------|-----------|
|
||||
| **Solo developer** | ccusage + claude-code-viewer | Cost awareness + session history review |
|
||||
| **Small team (2-5)** | ccusage + Conductor or multiclaude | Cost tracking + parallel development |
|
||||
| **Enterprise** | ccusage (MCP) + custom dashboards | Programmatic cost data + audit trails |
|
||||
| **Python-centric** | ccburn + Claude Chic | Native Python ecosystem tools |
|
||||
| **Multi-agent user** | Toad or Conductor | Unified agent management |
|
||||
| **Config-heavy setup** | claude-code-config + AIBlueprint | TUI config management + scaffolding |
|
||||
|
||||
---
|
||||
|
||||
## Related Resources
|
||||
|
||||
- [Observability](./observability.md) - DIY session monitoring, logging hooks, cost tracking scripts
|
||||
- [AI Ecosystem](./ai-ecosystem.md) - Complementary AI tools (Perplexity, Gemini, NotebookLM)
|
||||
- [MCP Servers Ecosystem](./mcp-servers-ecosystem.md) - Validated community MCP servers
|
||||
- [Architecture](./architecture.md) - How Claude Code works internally
|
||||
- [Ultimate Guide Section 8](./ultimate-guide.md) - Plugin system and marketplaces
|
||||
|
|
@ -11083,19 +11083,29 @@ You: "Fix typos in auth.ts, user.ts, and api.ts"
|
|||
|
||||
### Command Output Optimization with RTK
|
||||
|
||||
**RTK (Rust Token Killer)** filters bash command outputs **before** they reach Claude's context, achieving 72.6% average token reduction for git workflows.
|
||||
**RTK (Rust Token Killer)** filters bash command outputs **before** they reach Claude's context, achieving 70-90% token reduction across git, testing, and development workflows.
|
||||
|
||||
**Two Repositories:**
|
||||
|
||||
- **Upstream** (stable): [pszymkowiak/rtk](https://github.com/pszymkowiak/rtk) - Core git/find/cat optimizations
|
||||
- **Fork** (extended): [FlorianBruniaux/rtk](https://github.com/FlorianBruniaux/rtk) - Adds JS/TS tooling (vitest, pnpm, prisma) + analytics
|
||||
|
||||
**Installation:**
|
||||
|
||||
```bash
|
||||
# macOS ARM64 (Apple Silicon)
|
||||
# Option 1: Stable upstream (cargo)
|
||||
cargo install rtk
|
||||
|
||||
# Option 2: Extended fork with all features
|
||||
git clone https://github.com/FlorianBruniaux/rtk.git
|
||||
cd rtk && git checkout feat/all-features
|
||||
cargo install --path . --force
|
||||
|
||||
# Option 3: Binary (macOS ARM64)
|
||||
curl -fsSL "https://github.com/pszymkowiak/rtk/releases/latest/download/rtk-aarch64-apple-darwin.tar.gz" -o rtk.tar.gz && tar -xzf rtk.tar.gz && sudo mv rtk /usr/local/bin/ && rm rtk.tar.gz
|
||||
|
||||
# macOS Intel
|
||||
curl -fsSL "https://github.com/pszymkowiak/rtk/releases/latest/download/rtk-x86_64-apple-darwin.tar.gz" -o rtk.tar.gz && tar -xzf rtk.tar.gz && sudo mv rtk /usr/local/bin/ && rm rtk.tar.gz
|
||||
|
||||
# Verify installation
|
||||
rtk --version # Should output: rtk 0.2.0
|
||||
rtk --version # v0.4.0+ (fork) or v0.2.0+ (upstream)
|
||||
```
|
||||
|
||||
**Proven Token Savings (Benchmarked):**
|
||||
|
|
@ -11104,24 +11114,29 @@ rtk --version # Should output: rtk 0.2.0
|
|||
|---------|----------|-----|-----------|
|
||||
| `rtk git log` | 13,994 chars | 1,076 chars | **92.3%** |
|
||||
| `rtk git status` | 100 chars | 24 chars | **76.0%** |
|
||||
| `rtk find "*.md"` | 780 chars | 185 chars | **76.3%** |
|
||||
| `rtk git diff` | 15,815 chars | 6,982 chars | **55.9%** |
|
||||
| `cat CHANGELOG.md` | 163,587 chars | 61,339 chars | **62.5%** |
|
||||
| `rtk vitest run` (fork) | ~50,000 chars | ~5,000 chars | **90.0%** |
|
||||
| `rtk pnpm list` (fork) | ~8,000 chars | ~2,400 chars | **70.0%** |
|
||||
| `rtk cat CHANGELOG.md` | 163,587 chars | 61,339 chars | **62.5%** |
|
||||
|
||||
**Average: 72.6% token reduction**
|
||||
**Average: 70-90% token reduction depending on commands**
|
||||
|
||||
**Usage Pattern:**
|
||||
|
||||
```bash
|
||||
# Instead of:
|
||||
git log --oneline
|
||||
git status
|
||||
git diff HEAD~1
|
||||
|
||||
# Use:
|
||||
# Git operations (both versions)
|
||||
rtk git log
|
||||
rtk git status
|
||||
rtk git diff HEAD~1
|
||||
|
||||
# JS/TS Stack (fork only)
|
||||
rtk vitest run # Test results condensed
|
||||
rtk pnpm list # Dependency tree optimized
|
||||
rtk prisma migrate status # Migration status filtered
|
||||
|
||||
# Analytics (fork only)
|
||||
rtk gain # Show token savings stats
|
||||
rtk discover # Find missed optimization opportunities
|
||||
```
|
||||
|
||||
**Real-World Impact:**
|
||||
|
|
@ -11155,23 +11170,34 @@ rtk git diff HEAD~1
|
|||
- PreToolUse hook intercepts bash commands
|
||||
- Applies RTK wrapper when beneficial
|
||||
|
||||
**Limitations (v0.2.0):**
|
||||
**Fork Features (feat/all-features):**
|
||||
|
||||
- ❌ `grep` returns empty output (bug)
|
||||
- ❌ `ls` produces **worse** output (-274% token increase)
|
||||
- ⚠️ Early-stage project (8 GitHub stars, may be abandoned)
|
||||
- ⚠️ npm/pnpm/yarn not supported yet
|
||||
- ✅ `rtk vitest` - Test output condensed (90% reduction)
|
||||
- ✅ `rtk pnpm` - Package manager output optimized
|
||||
- ✅ `rtk prisma` - Database migration status filtered
|
||||
- ✅ `rtk gain` - Token savings analytics dashboard
|
||||
- ✅ `rtk discover` - Missed optimization opportunity finder
|
||||
- ✅ Bug fixes: `grep` and `ls` now work correctly
|
||||
|
||||
**Upstream Limitations (v0.2.0):**
|
||||
|
||||
- ⚠️ `grep` bug (returns empty output) - **Fixed in fork**
|
||||
- ⚠️ `ls` produces worse output - **Fixed in fork**
|
||||
- ⚠️ No JS/TS tooling support - **Added in fork**
|
||||
|
||||
**Recommendation:**
|
||||
|
||||
- ✅ Use for: git workflows, file finding, large file reading
|
||||
- ❌ Skip for: ls, grep, small outputs, quick exploration
|
||||
- ✅ **Fork**: Full-stack JS/TS projects, testing workflows, analytics needs
|
||||
- ✅ **Upstream**: Git-only workflows, minimal dependencies, stable releases
|
||||
- ❌ **Skip RTK**: Small outputs (<100 chars), quick exploration, interactive commands
|
||||
|
||||
**See also:**
|
||||
|
||||
- Evaluation: `docs/resource-evaluations/rtk-evaluation.md`
|
||||
- Templates: `examples/{claude-md,skills,hooks}/rtk-*`
|
||||
- GitHub: https://github.com/pszymkowiak/rtk
|
||||
- Upstream: https://github.com/pszymkowiak/rtk
|
||||
- Fork (extended): https://github.com/FlorianBruniaux/rtk
|
||||
- Third-party tools comparison: `guide/third-party-tools.md#rtk-rust-token-killer`
|
||||
|
||||
### Cost Tracking
|
||||
|
||||
|
|
|
|||
|
|
@ -41,9 +41,11 @@ deep_dive:
|
|||
bridge_schema: "examples/scripts/bridge-plan-schema.json"
|
||||
bridge_guide: "guide/ultimate-guide.md:14079"
|
||||
# Cost optimization - RTK (Rust Token Killer)
|
||||
rtk_tool: "https://github.com/pszymkowiak/rtk"
|
||||
rtk_upstream: "https://github.com/pszymkowiak/rtk"
|
||||
rtk_fork_extended: "https://github.com/FlorianBruniaux/rtk"
|
||||
rtk_evaluation: "docs/resource-evaluations/rtk-evaluation.md"
|
||||
rtk_guide: "guide/ultimate-guide.md:10478"
|
||||
rtk_guide: "guide/ultimate-guide.md:11084"
|
||||
rtk_third_party: "guide/third-party-tools.md:86"
|
||||
rtk_claude_md: "examples/claude-md/rtk-optimized.md"
|
||||
rtk_skill: "examples/skills/rtk-optimizer/SKILL.md"
|
||||
rtk_hook: "examples/hooks/bash/rtk-auto-wrapper.sh"
|
||||
|
|
@ -122,6 +124,7 @@ deep_dive:
|
|||
# Third-Party Tools (guide/third-party-tools.md) - Added 2026-02-01
|
||||
third_party_tools_guide: "guide/third-party-tools.md"
|
||||
third_party_tools_cost_tracking: "guide/third-party-tools.md:42"
|
||||
third_party_tools_rtk: "guide/third-party-tools.md:86"
|
||||
third_party_tools_session_mgmt: "guide/third-party-tools.md:105"
|
||||
third_party_tools_config_mgmt: "guide/third-party-tools.md:132"
|
||||
third_party_tools_alternative_uis: "guide/third-party-tools.md:170"
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue