Справочник CLI

Команды для людей.
Результаты для AI.

lean-ctx работает автоматически после настройки. Но когда вам нужен контроль, эти команды к вашим услугам.

Основные команды

Основные команды

lean-ctx setup

Разовая настройка. Автоматически определяет ваш shell (zsh/bash/fish), находит установленные AI-инструменты, настраивает MCP и shell hooks. Выполните один раз и больше не думайте об этом.

Выполните один раз после установки
lean-ctx init

Быстрая настройка для конкретного AI-инструмента. Используйте --agent cursor, --agent claude, --agent codex или --agent gemini для настройки MCP для этого инструмента.

Альтернатива setup для отдельных агентов
lean-ctx gain

Просмотр панели экономии. Общая экономия tokens за всё время, коэффициенты сжатия, топ-команды и оценки стоимости в USD. Сохраняется между всеми сессиями.

Проверяйте в любое время
Точно знайте, сколько экономите

Мониторинг и аналитика

lean-ctx gain

Панель общей экономии с подсчётом tokens, коэффициентом сжатия, топ-командами и отслеживанием стоимости в 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

Панель с автообновлением. Обновляется каждые 2 секунды, пока ваши AI-инструменты экономят tokens в реальном времени.

● 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

30-дневный график экономии с дневными столбцами, спарклайнами и визуализацией тренда. Отслеживайте траекторию вашей экономии.

$ 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

Веб-панель на localhost:3333. Интерактивные графики, история сессий и мониторинг в реальном времени в вашем браузере.

$ lean-ctx dashboard

◆ lean-ctx Dashboard

→ http://localhost:3333

Interactive charts, session history, command breakdown

Press Ctrl+C to stop

lean-ctx wrapped

«Spotify Wrapped» для вашей экономии tokens. Красивые, готовые к публикации отчёты с вашей статистикой за всё время, топ-командами и достижениями в сжатии.

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

Проверка и оптимизация

Диагностика

lean-ctx doctor

Выполняет 8 проверок установки - бинарный файл, shell hook, конфигурация MCP, файл статистики, директория cache, поддерживаемый shell, определение AI-инструмента и проверка версии.

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

Сканирует историю вашего shell на предмет команд, которые могли бы выиграть от сжатия, но ещё не перехватываются.

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

Измеряет реальную экономию tokens в вашей кодовой базе с помощью tiktoken (o200k_base). Точные цифры, без оценок.

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%)

Полный контроль

Продвинутые команды

Команда Описание
lean-ctx init --agent <name> Быстрая настройка MCP для конкретного AI-инструмента (cursor, claude, codex, gemini, windsurf, copilot, cline, roo, pi, qwen, trae, amazonq, jetbrains)
lean-ctx read <file> -m <mode> Чтение любого файла с режимом сжатия (full, map, signatures, diff, aggressive, entropy). Кэшированные чтения возвращают ~13 токенов. Используйте --fresh для обхода кэша.
lean-ctx diff Сжатый git diff - структурированный вывод с описанием изменений
lean-ctx grep <pattern> Эффективный по tokens поиск по паттерну с компактным контекстом
lean-ctx find <pattern> Поиск файлов по имени - компактные результаты с подсчётом файлов
lean-ctx ls Листинг директории в виде компактной карты дерева
lean-ctx -c "<cmd>" Сжать вывод любой произвольной команды через lean-ctx
lean-ctx config set <key> <value> Настройка параметров lean-ctx - интервалы checkpoint, TTL cache, режим CRP
lean-ctx cache [stats|clear|invalidate] Управление CLI кэшем файлов - статистика, очистка записей или инвалидация путей
lean-ctx setup Настройка одной командой - конфигурирует хуки оболочки, MCP редактора и проверяет, что всё работает

Готовы увидеть вашу экономию?

Установите lean-ctx, выполните setup и начните экономить tokens немедленно. Проверяйте панель с помощью gain когда захотите.