statespace-search · statespace-tech/statespace-search GitHub 开源项目

Shareable data apps for AI agents

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

$ curl -fsSL https://statespace.com/install.sh | bash

Quickstart

1. Create it

Run statespace init in the current directory:

$ statespace init

2. Build it

Add constrained CLI tools to README.md or any other Markdown file:

---
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:

$ claude "Document my database schema and add tools to query it"

3. Run it

Run your app locally:

$ statespace run --port 8000

Agents and HTTP clients can now read pages and execute tools:

# 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:

$ statespace deploy --name demo

Your app is now live at a public URL:

$ curl https://demo.statespace.app/README.md

5. Share it

Point any agent at the URL directly:

$ claude "Use the API at https://demo.statespace.app to break down revenue by region"

Or wire it up as an MCP server:

"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.