🗂️ LiveFolders v0.22.0 — Now with concurrent shell session isolation — per-session invocation slots, async dispatch, SIGKILL escalation — Landlock (Linux) + sandbox-exec (macOS) — Apache 2.0 — Star us on GitHub! ★

🗂️ LiveFolders

Chain tools into one call.

Declare a pipeline in folder.yaml — the agent triggers the whole chain with a single echo / cat. No per-step JSON, no per-step model turn.

A virtual filesystem alternative to MCP — built in Rust, zero dependencies for tool authors.
1 round trip per workflow, not N.

★ Star on GitHub ▼ Install Now

One Call. Whole Pipeline.

Declare a chain of steps in folder.yaml. The agent writes once, reads once — the kernel runs the pipeline. A 5-step chain becomes one model turn, not five.

ℹ️ The write call blocks until the pipeline finishes — by the time cat runs, the final result is ready. No polling, no glue code, no stale data.

Why a Folder Beats JSON Tool-Calling

🔄 1 round trip per workflow, not N

A 5-step chain is one model turn, not five. The agent writes once and reads once — the kernel runs the pipeline.

🧹 No schema chatter between stages

Stages hand bytes to each other on stdin/stdout — no re-serializing through the model, no per-call validation overhead.

🔎 Lazy discovery

ls, cat index.md, cat how_to.md. Tool docs load only when the agent needs them, instead of every schema squatting in the context window.

🐚 Shell composition for free

Agents already know |, xargs, tee. Composing tools doesn't require a new protocol.


What Is It?

LiveFolders mounts a virtual filesystem on your machine. Every tool you install appears as a directory of plain files. An LLM reads a file to call the tool — no JSON protocol, no SDK, no special client. Any agent that can run cat or echo can use it.

cat .livefolders/tools/users/list │ ▼ ┌───────────────────┐ │ LiveFoldersFS │ FUSE virtual filesystem └─────────┬─────────┘ │ spawns handler ▼ ┌───────────────────┐ │ bash handler │ curl -s https://api.example.com | jq ... └─────────┬─────────┘ │ HTTP GET ▼ ┌───────────────────┐ │ REST API │ any HTTP endpoint └─────────┬─────────┘ │ JSON response ▼ ┌───────────────────┐ │ LiveFoldersFS │ formats result as file content └─────────┬─────────┘ │ ▼ cat output: # Users / ## Mr. Rudolph Robel-Fay / ID: 1 ...
cat .livefolders/tools/users/list # → # Users # # → ## Mr. Rudolph Robel-Fay # → ID: 1 # → Created: 2024-01-15 # → Avatar: https://cdn.example.com/avatars/1.jpg