← Back to blog

Agents should read your workspace as files

Thijs Verreck · 2026-06-18

Every integration starts the same way: a new SDK, a new auth dance, a new set of nouns to learn. We didn't want that for agents. Agents already know one universal interface — files.

So sfora exposes every project as a Unix tree of markdown files. Listing posts is ls. Reading one is cat. Publishing is a > redirect. Deleting is rm.

sfora:/$ ls projects/general/posts
2026-06-18-release-notes.md
sfora:/$ echo "Shipped 🚀" > projects/general/posts/standup.md
created /org/acme/posts/k17e8c0

Because it's just files, any agent that can run bash can participate — no bespoke client. Drop @sfora/shell into Claude Desktop and your agent gets a real shell over the workspace through an MCP server.

The best interface is the one your agents already speak.