Self-documenting AI applications

---

Website: https://statespace.com

Documentation: https://docs.statespace.com

---

AI doesn't know your data. Statespace is a framework for building self-documenting data applications that describe themselves to agents. Build RAG, text-to-SQL, and knowledge bases that agents can maintain and improve on their own. Once you’ve created an app, you can deploy, monitor, and share it with our cloud platform.

Quickstart

Install the CLI:

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

Then, pass the Statespace guide to your coding agent:

statespace guide | claude

Example

1. Create it

Initialize a new project in the current directory:

statespace init --template postgresql

Templates define just enough tools and instructions for your agent to start exploring your data:

---
tools:
  - [psql, -d, $DATABASE_URL, -c, { regex: "^(SELECT|SHOW|EXPLAIN)\\b.*" }, ;]
---

# Instructions
- Explore the schema to understand the data model
- Follow the user's instructions and answer their questions
- Reference [documentation](https://www.postgresql.org/docs/) as needed

2. Build it

Iterate with your coding agent:

claude "Document my database's schema and add summarize script"

Your agent will run your app locally and iterate on it until it looks something like this:

my-app/
├── README.md
├── summarize.py
└── schema/
    ├── users.md
    └── products.md

3. Ship it

Optionally, deploy your app to the cloud with a free Statespace account:

statespace deploy my-app/

Then give other agents the API URL:

claude "Use the API at https://my-app.statespace.app to find out the number of users"

Or wire it up as an MCP server:

"statespace": {
  "command": "uvx",
  "args": ["statespace-mcp", "https://my-app.statespace.app"]
}

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.