Référence CLI

Des commandes pour les humains.
Des résultats pour l'IA.

lean-ctx fonctionne automatiquement après l'installation. Mais quand vous voulez garder le contrôle, ces commandes sont à votre disposition.

L'essentiel

Commandes essentielles

lean-ctx setup

Configuration unique. Détecte automatiquement votre shell (zsh/bash/fish), trouve les outils IA installés, configure MCP et les hooks shell. À exécuter une seule fois, puis vous n'y pensez plus.

À exécuter une seule fois après l'installation
lean-ctx init

Configuration rapide pour un outil IA spécifique. Utilisez --agent cursor, --agent claude, --agent codex ou --agent gemini pour configurer MCP directement pour cet outil.

Alternative par agent au setup
lean-ctx gain

Consultez votre tableau de bord des économies. Tokens économisés sur la durée, taux de compression, commandes les plus utilisées et estimations en USD. Persistant entre toutes les sessions.

Consultable à tout moment
Sachez exactement ce que vous économisez

Suivi & analyses

lean-ctx gain

Tableau de bord des économies cumulées avec comptage des tokens, taux de compression, commandes les plus utilisées et suivi des coûts en USD.

$ lean-ctx gain

◆ lean-ctx Token Savings Dashboard

────────────────────────────────

1.7M saved 76.8% rate $4.25 USD

Top Commands

curl 48x ████████████ 728K

git 34x ██████ 375K

lean-ctx gain --live

Tableau de bord en direct avec rafraîchissement automatique. Mis à jour toutes les 2 secondes pendant que vos outils IA économisent des tokens en temps réel.

● LIVE

$ lean-ctx gain --live

◆ lean-ctx LIVE refreshing every 2s

────────────────────────────────

1.7M saved ▁▃█▇██▁█

Session: 42 cmds | 89.2K saved | 94.1% rate

Press q to quit

lean-ctx gain --graph

Graphique d'économies sur 30 jours avec barres quotidiennes, sparklines et visualisation de tendance. Visualisez votre trajectoire d'économies.

$ lean-ctx gain --graph

Token Savings (30 days)

03-20██████████████████████ 1.0M

03-21███████████████ 690K

03-22████████████████████████ 1.1M

03-23 9.4K

03-24██████████████████████ 1.7M

lean-ctx dashboard

Tableau de bord web sur localhost:3333. Graphiques interactifs, historique des sessions et suivi en temps réel dans votre navigateur.

$ lean-ctx dashboard

◆ lean-ctx Dashboard

→ http://localhost:3333

Interactive charts, session history, command breakdown

Press Ctrl+C to stop

lean-ctx wrapped

Un « Spotify Wrapped » pour vos économies de tokens. Des rapports élégants et partageables avec vos statistiques cumulées, vos commandes les plus utilisées et vos performances de compression.

weekly monthly lifetime

$ lean-ctx wrapped monthly

◆ Your March 2026 Wrapped

────────────────────────────────

4.9M tokens saved

3,241 commands compressed

$12.16 USD saved

Top pattern: curl (97% compression)

You're in the top 5% of lean-ctx users

Vérifier et optimiser

Diagnostics

lean-ctx doctor

Exécute 8 vérifications d'installation - binaire, hook shell, config MCP, fichier de statistiques, répertoire de cache, shell supporté, détection d'outils IA et vérification de version.

Binary installed

Shell hook active (zsh)

MCP config (Cursor)

Stats persistence

Cache directory

Data directory writable

Project detection

Graph index

Search index

Agent hooks

Version up to date

All 11 checks passed

lean-ctx discover

Analyse votre historique shell à la recherche de commandes qui pourraient bénéficier de la compression mais ne sont pas encore interceptées.

Found 12 uncompressed commands:

kubectl - 34 calls, ~89% savings possible

helm - 12 calls, ~76% savings possible

terraform - 8 calls, ~82% savings possible

Run setup to enable these

lean-ctx benchmark run

Mesure les économies réelles de tokens dans votre base de code avec tiktoken (o200k_base). Des chiffres exacts, pas d'estimations.

src/auth.ts (123 lines)

full: 3,517 → 3,517 (0%)

map: 3,517 → 412 (88%)

signatures: 3,517 → 252 (93%)

entropy: 3,517 → 312 (91%)

Contrôle total

Commandes avancées

Commande Description
lean-ctx init --agent <name> Configuration MCP rapide pour un outil IA spécifique (cursor, claude, codex, gemini, windsurf, copilot, cline, roo, pi, qwen, trae, amazonq, jetbrains)
lean-ctx read <file> -m <mode> Lire n'importe quel fichier avec un mode de compression (full, map, signatures, diff, aggressive, entropy). Les lectures en cache retournent ~13 tokens. Utilisez --fresh pour contourner le cache.
lean-ctx diff Diff git compressé - sortie structurée avec résumés des modifications
lean-ctx grep <pattern> Recherche de motifs économe en tokens avec contexte compact
lean-ctx find <pattern> Rechercher des fichiers par nom - résultats compacts avec comptage
lean-ctx ls Listing de répertoire sous forme d'arborescence compacte
lean-ctx -c "<cmd>" Compresser la sortie de n'importe quelle commande shell via lean-ctx
lean-ctx config set <key> <value> Configurer les paramètres de lean-ctx - intervalles de checkpoint, TTL du cache, mode CRP
lean-ctx cache [stats|clear|invalidate] Gérer le cache CLI - afficher les statistiques, vider les entrées ou invalider des chemins spécifiques
lean-ctx setup Configuration en une commande - configure les hooks shell, le MCP de l'éditeur et vérifie que tout fonctionne

Prêt à voir vos économies ?

Installez lean-ctx, exécutez setup, et commencez à économiser des tokens immédiatement. Consultez votre tableau de bord avec gain quand vous le souhaitez.