rtk-ai__rtk/README_fr.md

Proxy CLI haute performance qui reduit la consommation de tokens LLM de 60-90%

Site web • Installer • Depannage • Architecture • Discord

English • Francais • 中文 • 日本語 • 한국어 • Espanol

---

rtk filtre et compresse les sorties de commandes avant qu'elles n'atteignent le contexte de votre LLM. Compatible avec tous les agents de code IA — il suffit de prefixer les commandes avec rtk. Binaire unique, zero dependance, <10ms d'overhead.

Economies de tokens (session de developpement de 30 min)

Operation	Frequence	Standard	rtk	Economies
ls / tree	10x	2 000	400	-80%
cat / read	20x	40 000	12 000	-70%
grep / rg	8x	16 000	3 200	-80%
git status	10x	3 000	600	-80%
git diff	5x	10 000	2 500	-75%
git log	5x	2 500	500	-80%
git add/commit/push	8x	1 600	120	-92%
cargo test / npm test	5x	25 000	2 500	-90%
Total		~118 000	~23 900	-80%

Estimations basees sur des projets TypeScript/Rust de taille moyenne.

Installation

Homebrew (recommande)

brew install rtk

Installation rapide (Linux/macOS)

curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh

Cargo

cargo install --git https://github.com/rtk-ai/rtk

Verification

rtk --version   # Doit afficher "rtk 0.27.x"
rtk gain        # Doit afficher les statistiques d'economies

Attention : Un autre projet "rtk" (Rust Type Kit) existe sur crates.io. Si rtk gain echoue, vous avez le mauvais package.

Demarrage rapide

Utilisation directe avec n'importe quel agent :

rtk git status              # Statut compact
rtk cargo test              # Echecs uniquement (-90%)
rtk grep "pattern" .        # Resultats groupes

Ou reecriture automatique avec Claude Code :

rtk init --global           # Installer le hook
# Redemarrer Claude Code — les commandes sont reecrites automatiquement
git status                  # → rtk git status (transparent)

RTK est un binaire autonome. Le hook Claude Code reecrit les commandes automatiquement, mais n'importe quel agent fonctionne en prefixant rtk.

Comment ca marche

  Sans rtk :                                       Avec rtk :

  Agent  --git status-->  shell  -->  git           Agent  --git status-->  RTK  -->  git
    ^                                   |             ^                      |          |
    |        ~2 000 tokens (brut)       |             |   ~200 tokens        | filtre   |
    +-----------------------------------+             +------- (filtre) -----+----------+

Quatre strategies appliquees par type de commande :

1. Filtrage intelligent - Supprime le bruit (commentaires, espaces, boilerplate)
2. Regroupement - Agregat d'elements similaires (fichiers par dossier, erreurs par type)
3. Troncature - Conserve le contexte pertinent, coupe la redondance
4. Deduplication - Fusionne les lignes de log repetees avec compteurs

Commandes

Fichiers

rtk ls .                        # Arbre de repertoires optimise
rtk read file.rs                # Lecture intelligente
rtk read file.rs -l aggressive  # Signatures uniquement
rtk find "*.rs" .               # Resultats compacts
rtk grep "pattern" .            # Resultats groupes par fichier
rtk diff file1 file2            # Diff condense

Git

rtk git status                  # Status compact
rtk git log -n 10               # Commits sur une ligne
rtk git diff                    # Diff condense
rtk git add                     # -> "ok"
rtk git commit -m "msg"         # -> "ok abc1234"
rtk git push                    # -> "ok main"

Tests

rtk test cargo test             # Echecs uniquement (-90%)
rtk vitest run                  # Vitest compact
rtk pytest                      # Tests Python (-90%)
rtk go test                     # Tests Go (-90%)
rtk cargo test                  # Tests Cargo (-90%)

Build & Lint

rtk lint                        # ESLint groupe par regle
rtk tsc                         # Erreurs TypeScript groupees
rtk cargo build                 # Build Cargo (-80%)
rtk cargo clippy                # Clippy (-80%)
rtk ruff check                  # Linting Python (-80%)

Conteneurs

rtk docker ps                   # Liste compacte
rtk docker logs <container>     # Logs dedupliques
rtk kubectl pods                # Pods compacts

Analytics

rtk gain                        # Statistiques d'economies
rtk gain --graph                # Graphique ASCII (30 jours)

Claude Code uniquement (lit les fichiers de session ~/.claude/projects/) :

rtk discover                    # Opportunites d'economies manquees dans l'historique
rtk discover --all --since 7    # Tous les projets, 7 derniers jours
rtk learn                       # Corrections CLI depuis l'historique d'erreurs
rtk cc-economics                # Analyse des couts tokens par session Claude Code

Bientot : rtk discover pour Aider, Cline, Goose et l'historique shell (tous agents). Suivre #273.

Configuration

# ~/.config/rtk/config.toml
[tracking]
database_path = "/chemin/custom.db"

[hooks]
exclude_commands = ["curl", "playwright"]

[tee]
enabled = true
mode = "failures"

Documentation

• TROUBLESHOOTING.md - Resoudre les problemes courants
• INSTALL.md - Guide d'installation detaille
• ARCHITECTURE.md - Architecture technique

Contribuer

Les contributions sont les bienvenues ! Ouvrez une issue ou une PR sur GitHub.

Rejoignez la communaute sur Discord.

Licence

Licence MIT - voir LICENSE pour les details.

Avertissement

Voir DISCLAIMER.md.