ToolFront▌

--- **Website: [https://statespace.com](https://statespace.com/)** **Documentation: [https://docs.statespace.com](https://docs.statespace.com/)** --- _A declarative framework for building AI-friendly web applications that agents can navigate and interact with._ ## Installation Install the CLI: ```bash curl -fsSL https://statespace.com/install.sh | bash ``` ## Example ### Create it Start with one file: `README.md` ````yaml --- tools: - [expr] --- ```component echo "Random number: $RANDOM" ``` # Instructions - The component loads a random number when the page loads - Use the `expr` tool to perform calculations with it ```` ### Serve it Save the example above as `myapp/README.md` and run: ```bash $ statespace serve myapp/ Running on `http://127.0.0.1:8000` ``` ### Ask it Pass the URL to any agent that can make HTTP requests: ```bash claude "Multiply the random number in http://127.0.0.1:8000 by 256" ``` ### Deploy it Create a free [Statespace account](https://statespace.com/auth/login) and deploy your app to the cloud: ```bash $ statespace deploy myapp/ Deployed to https://myapp.statespace.app ``` ## Concepts

Tools — Give agents controlled access to CLI commands over HTTP.

```yaml --- tools: - [grep] - [curl, -X, GET, { }] - [psql, -c, { regex: "^SELECT\b.*" }] --- ```

Components — Render live data inside component code blocks.

````yaml ```component echo "Server time: $(date)" ``` ````

Instructions — Guide agents through your data, workflows, and pages.

```markdown # Instructions - Use grep to search for logs in ./data - Query the database for recent users - See [analyze](src/analyze.md) for more workflows ```

## Features ✅ **Simple** — It's just Markdown. Easy to learn, easy to use, easy to maintain. ⚡ **Lightweight** — Install a single Rust binary. No dependencies. 🌐 **Universal** — Works immediately with any agent that can make HTTP requests. 📦 **Portable** — Deploy apps to the cloud for a public URL, or run them locally. 🔒 **Secure** — Restrict access to your private apps with token-based authentication. ## Community & Contributing - **Discord**: Join our [community server](https://discord.gg/rRyM7zkZTf) for real-time help and discussions - **X**: Follow us [@statespace_tech](https://x.com/statespace_tech) for updates and news - **Issues**: Report bugs or request features on [GitHub Issues](https://github.com/statespace-tech/statespace/issues) ## License This project is licensed under the terms of the MIT license.