tidybot CLI
CLI раскладывает мусорную папку вроде Downloads по местам с правилами на естественном языке, а агент судит файлы.
- 109 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Перемещает и переименовывает файлы после вашего подтверждения плана, содержимое файлов читает агент.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/tidybotОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Перемещает и переименовывает файлы после вашего подтверждения плана, содержимое файлов читает агент.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
tidybot не содержит модели. Решает агент (Claude Code или любой, кто умеет запускать команды), а CLI поставляет факты, кэширует краткие описания файлов, превращает решения в план и выполняет перемещения с историей отмены. Работает через места: каталоги назначения, у каждого есть правило словами. Цикл такой. Команда `tidybot summary todo` показывает файлы без описания, агент читает их и сохраняет описания, `tidybot scan --json` выдает компактный список с дубликатами, `tidybot propose` создает план без перемещений. Вы правите план командами `plan show` и `plan set`, затем `tidybot apply` двигает файлы, а `tidybot undo --last` возвращает их с прежними именами. Файлам с именами вроде `scan0001.pdf` CLI помогает подобрать имена по содержимому, а `tidybot find` ищет по описаниям.
Для кого. Тем, у кого папка загрузок или сканов завалена файлами, и кто готов отдать разбор агенту, но хочет проверить план до перемещений.
Подходит, если
- Папка Downloads забита сканами, фото и PDF с именами из UUID.
- Агент готовит план перемещений, а вы просматриваете и правите его до запуска.
- Нужен поиск по содержимому: договор аренды за 2025 год.
- Нужно прочитать PDF, DOCX, PPTX и XLSX, которые `cat` не открывает.
Не подходит, если
- Нужно навсегда удалить файлы: tidybot отправляет их только в корзину.
- Агент недоступен: без него CLI не принимает решений.
- Требуется синхронизация с облаком или обработка вне локальных папок.
Пример запроса к агенту
Разбери мою папку ~/Downloads с помощью tidybot: опиши файлы, предложи план и не двигай ничего до моей проверки.Ограничения
Модели внутри нет, качество разбора зависит от агента и тарифа, которым он пользуется. Описания файлов, особенно картинок, готовят агент или его субагенты на дешевой модели, и содержимое файлов уходит этой модели. Перемещения не затирают существующие файлы, прерванные операции CLI восстанавливает, а удаление идет в корзину или в выбранную вами папку. Читает PDF с китайскими шрифтами, DOCX, PPTX, XLSX и тексты в UTF-16 и Windows-1252. Для HEIC, WebP и первых страниц PDF делает превью в JPEG. Нужен Node.js, сборка из исходников требует pnpm.
Как отключить. Удалите пакет командой `npm uninstall -g tidybot`. Историю и места хранит локальная конфигурация, ее очистите отдельно.
Частые вопросы
Как установить tidybot?
Выполните `npm install -g tidybot`. Из исходников: `pnpm install`, `pnpm build` и `pnpm link --global`.
Двигает ли агент файлы сам?
Нет. Агент пишет план командой `tidybot propose`, перемещения выполняет только `tidybot apply` после вашей проверки.
Как вернуть файлы обратно?
Командой `tidybot undo --last`: она возвращает перемещенные файлы на место и восстанавливает исходные имена.
Удаляет ли tidybot файлы?
Навсегда не удаляет. Файлы уходят в корзину или в папку, которую вы укажете.
Как найти файл позже?
Командой вроде `tidybot find lease 2025`: поиск идет по сохраненным описаниям и ключевым словам.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыorganize — CLI для разбора загрузок и фотоархивов: выбирает файлы по тексту документов и данным снимков EXIF.
CLI на Rust для macOS: смотрит и меняет приложения по умолчанию для файлов и ссылок, есть MCP-сервер и скилл для агента
CLI строит локальный индекс заметок с «катализаторами», вопросами по вашим записям, чтобы агент находил нужное лучше grep
tasks-axi дает агенту короткие команды для бэклога в Markdown: добавить, начать, закрыть, заблокировать, найти готовую работу
Одна настройка Claude Code и Codex через диалог: общие инструкции, правила, плагины, скиллы, статусная строка и память поправок
CLI повторяет выбранную команду, подсвечивает изменения вывода и хранит историю для сравнения результатов пользователем и агентом.
Коротко о README
tidybot ведет файлы через места с правилами, кэширует описания и дает проверяемый план с историей отмены.