# Telos Cloud

Telos Cloud is the managed runtime for Goal Specifications. It provisions the
working environment and agent compute, builds and deploys the implementation,
then operates it against the Goal Spec.

## What Telos Cloud manages

Telos Cloud manages the infrastructure around a Goal Spec: agent execution,
working environments, deployment, service health, verification, evidence, and
the controller that keeps the desired state true.

The Goal Spec remains the source of truth. Code and infrastructure are the
current implementation of that specification.

## Deploy a Goal Specification

Set the Goal Spec platform to `cloud`, authenticate, and apply it:

```bash
telos login
telos apply SPEC.md
```

Applying a new Goal Spec creates a managed session. Telos packages its resolved
skills, provisions the environment, runs the implementation and evaluation
agents, and reports the resulting service and session.

## CLI and web UI

The Telos CLI and web UI use the same API and expose the same Cloud resources.
You can create or update Goal Specs, start sessions, inspect status, follow
activity, review evidence and cost, and remove sessions from either surface.

Use `telos login` to authenticate the CLI. Sign in on the web to manage the
same organization and sessions visually.

## Continuous reconciliation

An applied Goal Spec becomes persistent desired state. Telos Cloud repeatedly
checks the running service against it. When the service drifts or the Goal Spec
changes, Telos repairs the implementation and evaluates the result again.

Update a managed service by editing its Goal Spec and applying it to the same
session:

```bash
telos apply SPEC.md --session sess_9f2ka81
```

## Verification and evidence

An implementation agent changes the service. A separate evaluation agent then
checks the result against the Goal Spec and any required skill rubrics. A
failed evaluation blocks acceptance and returns concrete findings to the next
implementation cycle.

Each session keeps an auditable record of agent activity, verdicts, findings,
costs, and checkpoints. Use the web UI or `telos describe` and `telos logs` to
inspect it.

## Session lifecycle

Managed sessions move through provisioning, deployment, verification, and
operation. The CLI provides the same lifecycle controls as the web UI:

```bash
telos list
telos describe sess_9f2ka81
telos logs -f sess_9f2ka81
telos delete sess_9f2ka81
```

`list` shows current sessions, `describe` reports lifecycle and service details,
`logs` follows agent and verification activity, and `delete` stops and removes
the managed deployment.