Shareable data apps for AI agents
Website: https://statespace.com
Documentation: https://docs.statespace.com
AI doesn't know your data, but it knows Unix and filesystems. Statespace lets you transform your files and CLI tools into shareable data apps that any agent can discover and use. Build database explorers, share business rules, or document legacy APIs. Once you’ve created an app, deploy and monitor it with our cloud platform.
Installation
bash$ curl -fsSL https://statespace.com/install.sh | bash
Quickstart
1. Create it
Run statespace init in the current directory:
bash$ statespace init
2. Build it
Add constrained CLI tools to README.md or any other Markdown file:
yaml--- tools: - [grep] - [python, scripts/summarize.py] - [sqlite3, data/app.db, { regex: "^(SELECT|EXPLAIN)\\b.*" }] --- # Instructions - Only run read-only queries against the database - Use `summarize.py` for aggregations and report generation - Use `grep` to search across local files and logs
Alternatively, let your coding agent build it out for you:
bash$ claude "Document my database schema and add tools to query it"
3. Run it
Run your app locally:
bash$ statespace run --port 8000
Agents and HTTP clients can now read pages and execute tools:
bash# Read a page $ curl http://localhost:8000/README.md # Execute a CLI tool $ curl -X POST http://localhost:8000/README.md \ -H "Content-Type: application/json" \ -d '{"command": ["grep", "-r", "revenue", "."]}'
4. Deploy it
Deploy your app to the cloud:
bash$ statespace deploy --name demo
Your app is now live at a public URL:
bash$ curl https://demo.statespace.app/README.md
5. Share it
Point any agent at the URL directly:
bash$ claude "Use the API at https://demo.statespace.app to break down revenue by region"
Or wire it up as an MCP server:
json"mcpServers": { "statespace": { "command": "npx", "args": ["-y", "statespace-mcp", "https://demo.statespace.app"] } }
Features
- 🔌 Any CLI tool —
psql,sqlite3,grep,python— if it runs in a shell, it works - 🔒 Safe by default — regex constraints mean agents can only run what you explicitly allow
- 🧠Self-describing — Markdown pages are both the documentation and the interface
- 📖 Composable — split across pages so agents load only what they need and save tokens
- 🚀 Shareable — deploy to a URL, wire up as an MCP server, or share with teammates
Community & Contributing
- Discord: Join our community server for real-time help and discussions
- X: Follow us @statespace_tech for updates and news
- Issues: Report bugs or request features on GitHub Issues
License
This project is licensed under the terms of the MIT license.
