capsule-fs README

The project's README from github.com/unicity-aos/capsule-fs. As one markdown file: README.md.

astrid-capsule-fs

License: MIT OR Apache-2.0 MSRV: 1.94

Filesystem tools for Astrid OS agents.

In the OS model, this capsule is the coreutils package. It gives agents the ability to read, write, search, and navigate the workspace filesystem through the kernel's VFS airlock.

Tools

Tool Description
read_file Read file contents with optional line range (start_line, end_line)
write_file Write content to a file
replace_in_file Replace an exact string match in a file (rejects 0 or >1 occurrences)
list_directory List entries in a directory
grep_search Recursive content search with depth, file count, and match count caps
create_directory Create a directory
delete_file Delete a file (session-created files only, no whiteout support yet)
move_file Move a file with 10MB size limit, existence checks, and rollback on failure

All operations go through the VFS airlock. The kernel enforces path boundaries, copy-on-write isolation, and capability checks before any host filesystem access occurs.

Development

cargo build --target wasm32-unknown-unknown --release

License

Dual-licensed under MIT and Apache 2.0.

Copyright (c) 2025-2026 Joshua J. Bouw and Unicity Labs.

capsule-fs (unicity-aos/capsule-fs)

Searching Database…

Что это такое?capsule-fs — это набор инструментов для работы с файлами для ИИ-агентов внутри Unicity AOS (также называемой Astrid OS). Он даёт агентам инструменты readfile, writefile, replaceinfile, listdirectory, grepsearch, createdirectory, deletefile и movefile, и все операции проходят через VFS airlock ядра ОС.
Это самостоятельное приложение или оно встраивается во что-то большее?Это «капсула» — модуль, который встраивается в ядро Unicity AOS и работает как пакет coreutils для этой операционной системы агентов, а не запускается самостоятельно.
Эти инструменты работают без остальной Unicity AOS?Нет — каждая операция проходит через VFS airlock ядра, который проверяет границы путей, изоляцию копирования при записи и права доступа, прежде чем обратиться к реальной файловой системе.
Есть ли ограничения на удаление и перемещение файлов?Да: deletefile работает только с файлами, созданными в текущей сессии (поддержки whiteout пока нет), а movefile ограничивает размер 10 МБ, проверяет существование файлов и откатывает изменения при ошибке.
Что делает replaceinfile, если найдено несколько совпадений?Он полностью отклоняет правку: replaceinfile срабатывает только при точном совпадении строки, которое встречается в файле ровно один раз, что предотвращает случайную перезапись в нескольких местах.
Что умеет grepsearch?Это инструмент рекурсивного поиска по содержимому с ограничениями на глубину поиска, количество просканированных файлов и число возвращаемых совпадений, чтобы агенты не могли запустить неконтролируемый поиск.
От чего именно защищает VFS airlock?Это привратник ядра для доступа к файловой системе: он проверяет границы путей, изолирует запись через копирование при записи и проверяет права доступа, прежде чем любой инструмент обратится к файловой системе хоста.
What are similar projects?SPACE, just-bash, mirage, agentbox, composio, coop, arc-code, computer
Size
0.2 MB
Stars
8.4K
Age
7mo
Commits · 90 Days