organize CLI
organize — CLI для разбора загрузок и фотоархивов: выбирает файлы по тексту документов и данным снимков EXIF.
- 3 186 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Рабочий запуск переносит, переименовывает или удаляет все файлы, совпавшие с правилом.
- Пользовательские фильтры и действия могут выполнять встроенный Python и команды оболочки.
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/organizeОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Рабочий запуск переносит, переименовывает или удаляет все файлы, совпавшие с правилом.
- Пользовательские фильтры и действия могут выполнять встроенный Python и команды оболочки.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
organize — CLI для автоматической обработки файлов по правилам в текстовом файле YAML. Пользователь выбирает папки, фильтры и действия: программа переносит счета, переименовывает документы и находит дубликаты. Правило может отбирать файлы по расширению, имени, данным снимка EXIF или тексту внутри документа. Сначала пользователь запускает пробный режим и видит будущие изменения. После просмотра плана он выполняет правило в рабочем режиме. Для нестандартных задач в конфигурацию можно включить Python и команды оболочки.
Для кого. Сотрудникам, которые регулярно разбирают папки с загрузками, счетами или фотографиями по повторяющимся признакам.
Подходит, если
- PDF-счета копятся в загрузках, и сотрудник раскладывает их в отдельный каталог.
- Фотограф группирует снимки по дате съемки из EXIF, сохраненной внутри файла.
- Перед очисткой пустых папок администратор просматривает результат симуляции.
- Офисная команда отбирает документы по извлеченному тексту PDF или DOCX.
Не подходит, если
- Пользователь собирается применить незнакомые правила с `shell` или Python к рабочим файлам без просмотра.
- Удаление единственного экземпляра документов недопустимо, а правило содержит действие `delete`.
- Команда ожидает планировщик постоянного наблюдения, но настроила только разовый вызов правил.
Пример запроса к агенту
Создай правило organize для PDF в загрузках и покажи `organize sim`, не запускай перенос до просмотра списка.Ограничения
Нужен Python 3.9 или новее; пакет называется `organize-tool`, хотя команда запускается как `organize`. Правила пользователь описывает в конфигурации, поэтому перед рабочим запуском надо задать папки и проверить совпадения фильтров. Симуляция показывает план, а изменения выполняются отдельной командой `run`. При переходе с версии 2 на 3 автор советует свериться с руководством миграции: в новой версии менялись действия, фильтры и параметры.
Как отключить. Уберите `organize run` из расписания и скриптов. Сохраните конфигурацию отдельно; уже перенесенные или удаленные файлы остановка программы не возвращает.
Частые вопросы
Как посмотреть будущие изменения?
`organize sim` показывает, какие файлы подошли и что произойдет. Сверьте исходные и конечные папки, затем выполняйте `organize run`, если план верен.
Где редактировать правило?
Создайте конфигурацию через `organize new`, затем откройте `organize edit`. Если редактор не открылся, `organize show --reveal` покажет папку с `config.yaml`.
Почему правило ничего не делает?
В примере README сообщение `Nothing to do` означает, что PDF в выбранной папке нет. Сопоставьте `locations` и фильтр `extension` с файлами, затем снова запустите симуляцию.
Как заранее найти ошибку конфигурации?
Запустите `organize check`. Команда проверяет конфигурацию без рабочего применения правил; после исправления ошибок переходите к `organize sim`.
Как выбрать другой файл правил?
В синтаксисе README команда принимает `<config>` как имя или путь. Передайте свой файл после `organize sim`, затем просмотрите план выбранной конфигурации.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI строит локальный индекс заметок с «катализаторами», вопросами по вашим записям, чтобы агент находил нужное лучше grep
Скилл для Codex: безопасное обслуживание локального состояния, отчет без записи по умолчанию, бэкап и архив вместо удаления, чистка логов и воркстри
CLI повторяет выбранную команду, подсвечивает изменения вывода и хранит историю для сравнения результатов пользователем и агентом.
Интерактивный поиск в терминале помогает выбирать файлы, команды из истории и строки из длинного списка по частям названия.
Одна настройка Claude Code и Codex через диалог: общие инструкции, правила, плагины, скиллы, статусная строка и память поправок
MCP-сервер для работы агента с локальным компьютером: терминал и долгие процессы, поиск и правка файлов, Excel, PDF и DOCX
Коротко о README
Правило состоит из `locations`, `filters` и `actions`. Среди примеров автора есть сортировка счетов по имени и удаление пустых каталогов. Список конфигураций показывает `organize list`, проверку синтаксиса выполняет `organize check`.