# LocalCloud docs index for agents

Use these raw Markdown routes for compact agent context, then follow the HTML pages for full details.

## Quick start
```bash
curl -fsSL https://local.cloud/install.sh | sh
localcloud doctor
localcloud start --local-only
curl -fsS http://localhost:5380/readiness
eval "$(localcloud env)"
localcloud console
```

- Homebrew alternative to the first line: `brew install LocalGCloud/tap/localcloud`.
- Skip the install line when `localcloud --version` already works. If the installer prints a `source` command, run it before the next line.
- `localcloud start` waits for the runtime. The readiness check uses the default gateway port 5380; if the CLI remapped it, use the gateway URL from `localcloud status`.
- `localcloud console` opens the web console in a browser; skip it in headless sessions.

### Docker-only hosts
Without the CLI (for example on Windows), run the image directly, wait for readiness, and export the environment from the runtime:

```bash
docker volume create localcloud-data

docker run -d --name localcloud \
  -p 127.0.0.1:5380-5405:5380-5405 \
  -m 4g \
  -v localcloud-data:/var/lib/localcloud \
  agentcloud/localcloud:latest

for attempt in $(seq 1 60); do curl -fsS http://localhost:5380/readiness && break; sleep 2; done
eval "$(curl -fsS 'http://localhost:5380/env?format=shell')"
```

## Setup and runtime
- https://local.cloud/docs/ — getting started.
- https://local.cloud/docs/configuration/ — services, projects, persistence, and networking.
- https://local.cloud/docs/sdk-examples/ — standard Google Cloud SDK examples configured for localhost.
- https://local.cloud/docs/terraform/ — Terraform endpoint overrides and local validation.
- https://local.cloud/docs/seed-data/ — repeatable local data setup.
- https://local.cloud/docs/console/ — web console for local health and data inspection.

## Agent routes
- https://local.cloud/ai/agents.md — agent guide.
- https://local.cloud/ai/agent-template.md — AGENTS.md template.
- https://local.cloud/ai/services.md — ports, environment variables, and guides.
- https://local.cloud/ai/compatibility.md — capabilities and boundaries per service.
- https://github.com/LocalGCloud/LocalGCloud.github.io/tree/main/agent-skills — Agent Skills package.