surrealfs
SurrealFS virtual filesystem for AI agents. Rust core + Python agent (Pydantic AI). Persistent file operations backed by SurrealDB. Part of the surreal-skills collection.
npx skills add majiayu000/claude-skill-registry --skill surrealfs --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# SurrealFS -- Virtual Filesystem for AI Agents SurrealFS provides a persistent, queryable virtual filesystem backed by SurrealDB. Designed for AI agents that need durable file operations, hierarchical storage, and content search across sessions. ## Components | Component | Crate/Package | Language | Purpose | |-----------|---------------|----------|---------| | Core Library | `surrealfs` | Rust | Filesystem operations, CLI REPL, SurrealDB storage layer | | AI Agent | `surrealfs-ai` | Python (Pydantic AI) | Agent interface with tool integration, HTTP hosting | ## Rust Core -- Commands The `surrealfs` crate provides a REPL with POSIX-like commands: | Command | Description | |---------|-------------| | `ls` | List directory contents | | `cat` | Display file contents | | `tail` | Show last lines of a file | | `nl` | Number lines of a file | | `grep` | Search file contents | | `touch` | Create empty file | | `mkdir` | Create directory | | `write_file` | Write content to file | | `edit` | Edit file contents | | `cp` | Copy file | | `cd` | Change directory | | `pwd` | Print working directory | Supports piping from external commands: `curl https://example.com > /pages/example.html` Storag
- Components
- Rust Core -- Commands
- Python AI Agent
- Quick Start
- Use Cases
- Security Considerations
- Full Documentation
Install the Rust core cargo install surrealfs Start the REPL with embedded storage surrealfs Or connect to a remote SurrealDB instance surrealfs --endpoint ws://localhost:8000 --user root --pass root --ns agent --db workspace Install the Python agent pip install surrealfs-ai Run the agent HTTP server python -m surrealfs_ai --host 127.0.0.1 --port 7932
What does the surrealfs skill do?
SurrealFS virtual filesystem for AI agents. Rust core + Python agent (Pydantic AI). Persistent file operations backed by SurrealDB. Part of the surreal-skills collection.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill surrealfs --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.