ReCloud

Local-first AI orchestration: a desktop tray app, RC-API (HTTP workflow engine + catalog), and a stdio MCP server so Cursor talks to one tool surface while execution splits between your machine and the API.

Documentation in this book matches the reference codebase layout (RC-API, ReCloud_app MCP bundle, ReCloudTrayApp / Tauri tray). It avoids fictional infra (no grant materials, no placeholder communities).

What's inside

Area	Doc
First run	getting-started.md
Shape of the system	architecture.md
Keys, mcp.json, rules file	configuration.md
Parts in plain language	core-components.md
HTTP surface	api-reference.md
Tools & activation	tools-catalog.md
Ops	admin-overview.md, deployment.md
Safety	security.md
Smoke checks	testing.md
Extending tools	plugin-development.md
Troubleshooting	faq.md
Canonical links	links.md

Architecture (high level)

graph TB
  subgraph desktop [Desktop]
    TRAY[Tray app]
  end
  subgraph ide [IDE]
    CURSOR[Cursor MCP client]
  end
  subgraph runtime [Same or adjacent host]
    MCP[MCP server stdio]
    API[RC-API HTTP]
  end
  subgraph external [Providers]
    GEMINI[Gemini via RC-API config]
    FS[(Filesystem)]
  end

  TRAY -->|writes mcp.json, keys, rules .mdc| CURSOR
  CURSOR <-->|MCP stdio| MCP
  TRAY -->|health / settings| API
  MCP -->|Bearer RC_API_KEY /tools/execute| API
  MCP --> FS
  API --> GEMINI
  API --> FS

Loading

Start with getting-started.md.