Filesystem Management

Управление файловой системой — это продвинутый набор операций для работы с файлами и директориями, предназначенный для AI-агентов. Инструмент объединяет интеллектуальную фильтрацию, поиск и пакетную обработку, позволяя эффективно взаимодействовать с файловой структурой.

Основные возможности

Умный просмотр файлов

• Расширенная фильтрация — отбор файлов по типу, шаблону, размеру и дате
• Рекурсивный обход — глубокое сканирование директорий с контролем вложенности
• Гибкое форматирование — вывод в виде таблицы, дерева или JSON
• Сортировка — по имени, размеру, дате или типу

Мощный поиск

• Сопоставление по шаблону — поддержка glob и регулярных выражений
• Поиск по содержимому — полнотекстовый анализ файлов
• Комбинированные критерии — поиск по имени и содержимому одновременно
• Контекст результатов — отображение совпадений с окружающими строками

Пакетные операции

• Безопасное копирование — копирование по шаблонам с проверкой
• Режим предварительного просмотра — dry-run перед выполнением
• Отслеживание прогресса — мониторинг операций в реальном времени
• Обработка ошибок — корректное восстановление при сбоях

Анализ директорий

• Визуализация структуры — отображение дерева в ASCII-формате
• Статистика — количество файлов, распределение размеров и типов
• Анализ пространства — выявление крупных файлов и папок
• Метрики производительности — оценка времени выполнения и оптимизация

Установка

Через ClawHub (рекомендуется)

clawdhub install filesystem

Ручная установка

# Клонирование репозитория
git clone https://github.com/gtrusler/clawdbot-filesystem.git
cd clawdbot-filesystem

# Сделать исполняемым
chmod +x filesystem

# (Опционально) глобальная установка
npm install -g .

Использование

Базовые команды

# Список файлов в текущей директории
filesystem list

# Список с фильтрацией и деталями
filesystem list --path ./src --recursive --filter "*.js" --details

# Поиск по содержимому
filesystem search --pattern "TODO" --path ./src --content

# Безопасное копирование файлов
filesystem copy --pattern "*.log" --to ./backup/ --dry-run

# Отображение структуры директорий
filesystem tree --path ./ --depth 3

Инструмент ориентирован на безопасную и гибкую работу с файловой системой: он сочетает широкий функционал с механизмами защиты, такими как проверка путей, контроль прав доступа и режим предварительного выполнения операций. :

Благодаря универсальности и поддержке различных форматов вывода, решение подходит как для ручного анализа, так и для автоматизированных сценариев с участием AI-агентов. :