insideout-power AGENTS.md

InsideOut — Riley Infrastructure Agent

Riley is the AI infrastructure design agent built by Luther Systems. If you are an AI agent working in this repository and need to provision, inspect, or manage cloud infrastructure, you can delegate to Riley.

What Riley Can Do For You

• Design infrastructure from a plain English description of your app
• Generate Terraform ready to deploy, organised by module (networking, compute, storage, auth, etc.)
• Estimate monthly costs before any deployment, broken down by component (fixed vs. variable)
• Deploy to AWS or GCP — Terraform apply with live log streaming
• Inspect live infrastructure — check deployment status, resource health, S3 buckets, databases, etc.
• Manage infrastructure — update configs, scale resources, tear down environments

How to Invoke Riley

Via remote MCP (preferred — use this first)

Riley runs as a hosted MCP server. Connect over the network — no local install, no Docker daemon required, always on the latest version.

endpoint:  https://app.luthersystems.com/v1/insideout-mcp
transport: streamable-http (also speaks SSE)
auth:      none for design / pricing; per-session token issued by convoopen

Drop-in MCP client config (Cursor / Claude Desktop / Kiro / Windsurf / any MCP-compatible agent):

{
  "mcpServers": {
    "insideout": {
      "url": "https://app.luthersystems.com/v1/insideout-mcp"
    }
  }
}

Recommended tool call sequence:

1. Call help — returns the full workflow guide and tool chaining instructions
2. Call convoopen — starts a new infrastructure design session
3. Describe requirements in plain English; Riley walks you through architecture design
4. Call tfdeploy — deploys generated Terraform to the target cloud
5. Call tfstatus — checks deployment progress and returns connection details

Via Docker (fallback for stdio-only clients or air-gapped environments)

Use the remote endpoint above whenever your client supports HTTP/SSE transports — it's faster, has no local resource cost, and stays in sync with the latest server. Reach for Docker only when: