# unicity-aos/capsule-fs

Filesystem tools for agents. Read, write, replace, grep, list, create, delete, move via VFS airlock. Part of Unicity AOS.

Repository: https://github.com/unicity-aos/capsule-fs
Canonical: https://ross.abutalabs.com/products/capsule-fs
Language: Rust
License: Apache-2.0
License Family: permissive
Last push: 2026-07-09T19:29:28+00:00

## Health v2 (maintenance only)
Score: 76/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 91, release rhythm 92, longevity 12
- inputs: {"age_days": 170, "days_push": 55, "days_rel": 55, "gap_med": 25, "n_releases_24m": 2}
- flags: young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 8482, forks 15 (observed 2026-08-28T04:10:23.080139+00:00)

## What it is
A Rust library providing filesystem tools (read, write, replace, grep, list, create, delete, move) for AI agents, exposed through a kernel-enforced VFS airlock. It acts as the coreutils package for Astrid OS agents, with path boundaries, copy-on-write isolation, and capability checks.

## Use cases
- give an AI agent safe file read/write access
- sandbox agent filesystem operations behind a VFS airlock
- let agents grep and search workspace files
- enforce path boundaries and capability checks for agent file tools
- build agent tooling on Astrid OS with coreutils-like file operations

## When to choose
- you are building agents on Astrid OS or a similar kernel/VFS model
- you need sandboxed, capability-checked filesystem tools for agents
- you want Rust/WASM agent filesystem primitives with rollback and limits

## When to avoid
- you need a general-purpose filesystem library for ordinary applications
- you need full delete/whiteout support or files larger than 10MB moves
- your agent framework expects MCP or direct host filesystem access without a kernel airlock

## Facets
- artifact type: library
- maturity: active
- function: file-system, search-engine, developer-tools, mcp
- domain: developer-tools, files
- platform: rust, wasm, cross-platform
- tags: agent-tools, vfs, sandboxed-filesystem, coreutils, capsule, astrid-os, ai-agents, command-line

## Member repositories
- unicity-aos/capsule-fs (main) score 76

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:23.080139+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:27:08.777677+00:00, confidence not recorded.
  - readme: https://github.com/unicity-aos/capsule-fs (fetched 2026-08-28T04:10:23.080139+00:00, sha cfd7c5a07c56)
- Data as of 2026-08-30T08:39:29.467469+00:00.