tqdm CLI
Команда tqdm добавляет индикатор к потоку строк или байтов, чтобы пользователь видел ход долгого сценария агента.
- 31 379 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- CLI читает переданный поток; запись и сетевые действия зависят от соседних команд сценария и их прав.
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/tqdm-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI читает переданный поток; запись и сетевые действия зависят от соседних команд сценария и их прав.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
tqdm можно вставить между командами оболочки, чтобы наблюдать за обработкой потока. Данные проходят дальше без добавления индикатора в основной вывод, а счетчик появляется в отдельном потоке сообщений. Агент может добавить такой шаг в копирование, упаковку или обработку выгрузки и сделать длительную операцию понятнее пользователю. CLI считает строки или байты и показывает скорость выполнения. Если заранее известен общий объем, можно передать его для расчета доли и оставшегося времени. Есть отдельные режимы для программ, которые сами печатают числовой прогресс.
Для кого. Авторам длительных сценариев обработки, которым нужно показывать человеку ход выполнения команд агента.
Подходит, если
- Большая выгрузка обрабатывается потоком, и пользователь хочет видеть продвижение.
- При упаковке файлов известен общий объем данных.
- Сценарий уже выводит числовой счетчик, который удобно показать индикатором.
- Агент готовит команду для терминала с раздельными данными и служебным выводом.
Не подходит, если
- Нужно управлять очередью заданий, повторно запускать неудачные задания и восстанавливать прерванные операции.
- Процесс не передает наблюдаемые данные или счетчик прогресса.
- Вы ожидаете точный срок завершения при неизвестном объеме работы.
Пример запроса к агенту
Добавь индикатор объема в существующую команду упаковки, сохрани данные в основном потоке и объясни, откуда взят общий размер.Ограничения
Для процента и оценки оставшегося времени требуется подходящий общий объем; без него виден только уже обработанный поток. Терминал должен корректно поддерживать возврат каретки, иначе журнал может заполняться отдельными строками индикатора. В режиме числового обновления tqdm принимает числа; заранее извлеките счетчики из текстового журнала, если хотите использовать его как источник. tqdm наблюдает передаваемые данные, но не проверяет корректность результата и не отменяет побочные действия соседних команд.
Как отключить. Уберите tqdm из цепочки команд или остановите весь сценарий. Частично записанные соседними командами файлы проверьте отдельно.
Частые вопросы
Попадет ли индикатор в обрабатываемые данные?
По умолчанию нет. Данные идут в стандартный вывод, индикатор — в поток сообщений об ошибках.
Можно считать байты вместо строк?
Да. Используйте `--bytes`.
Как задать полный объем?
Передайте его через `--total` в подходящих единицах.
Можно использовать без Python-импорта?
Да. У пакета есть отдельная команда tqdm и запуск как модуль.
Почему индикатор идет новыми строками?
Терминал или журнал может не поддерживать нужное управление курсором. Проверьте способ отображения вывода.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI запускает несколько команд в одном терминале и помечает их вывод, чтобы пользователь различал процессы сценария агента.
CLI превращает изменения Git в пошаговый разбор с кодом, вопросами и объяснениями от подключенного ИИ-агента
Анализатор дампов потоков Java с MCP-сервером: агент ищет взаимоблокировки и зависшие потоки, не читая сотни мегабайт стека
CLI сохраняет шаги работы кодинг-агента и связывает строки файла с вызовом инструмента, разговором и исходным запросом.
Две команды для терминала на Rust: qq отвечает на быстрый вопрос по командной строке, а qa делает один шаг с файлами и командами
Открытый агентский терминал на Rust и Tauri: свои ключи моделей, таймлайн диалога и прозрачные вызовы инструментов.
Коротко о README
Пакет также содержит Python-библиотеку, но для потоков оболочки достаточно CLI. Есть настройки единиц измерения и вида индикатора.