Reliability, tied to the user journey.

# Run from a Nines source checkout with Docker running.
([ -f .env ] || python3 scripts/setup-local.py --playground) && \
  docker compose -p nines-playground -f compose.playground.yaml up --build -d

# Open http://127.0.0.1:18080 and sign in with admin / admin.
# Review and deploy the sample SLO's rules in its Rules tab.

# Optional: exercise collection, deployment, RBAC and alert recovery.
docker compose -p nines-playground -f compose.playground.yaml run --rm verify

# Build once from a source checkout, or use the alpha binary.
go build -o bin/nines ./cmd/nines

bin/nines validate --offline -f examples/api-availability.slo.yaml --agent

bin/nines rules generate --offline \
  -f examples/api-availability.slo.yaml --tenant commerce

bin/nines capabilities --offline --agent

# Use a token issued for your deployment and tenant.
export NINES_API_KEY="YOUR_TENANT_API_KEY"

nines config set-context production \
  --server https://nines.example.com --tenant commerce

nines get slos --context production --agent
nines plan --context production -f examples/api-availability.slo.yaml --agent

# Alternative: use the server's configured SSO provider.
nines login --context production --method sso

# SLO target
nines:slo_target:ratio{nines_tenant="prometheus",nines_slo="checkout-success"}

# Measured SLI for the short burn window
nines:sli:ratio{nines_tenant="prometheus",nines_slo="checkout-success",window="60s"}

# Error-budget consumption rate
nines:slo_burn_rate:ratio{nines_tenant="prometheus",nines_slo="checkout-success"}

# Active critical or warning burn alerts
ALERTS{alertname="NinesSLOBurnRate",alertstate="firing"}

// Preview a typed SLO plan; NINES_APPLY=true applies it to the configured tenant.
package main

import (
	"context"
	"fmt"
	"log"
	"os"
	"time"

	v1 "github.com/ishantanu/nines/api/v1alpha1"
	"github.com/ishantanu/nines/client"
)

func main() {
	c, err := client.New(client.Config{URL: os.Getenv("NINES_URL"), Tenant: os.Getenv("NINES_TENANT"), Token: os.Getenv("API_TOKEN")})
	if err != nil {
		log.Fatal(err)
	}
	slo := v1.NewSLO("api-availability", "production", v1.SLOSpec{DisplayName: "API availability", Service: "gateway", Target: .999, WindowSeconds: 86400, StepSeconds: 60, GoodQuery: `sum(increase(http_requests_total{code!~"5.."}[1m]))`, TotalQuery: `sum(increase(http_requests_total[1m]))`})
	ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
	defer cancel()
	plan, err := c.Plan(ctx, slo)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%s %s (expected revision %d)\n", plan.Action, slo.Metadata.Name, plan.ExpectedRevision)
	if os.Getenv("NINES_APPLY") != "true" {
		fmt.Println("Review the plan; set NINES_APPLY=true to apply.")
		return
	}
	revision, err := c.Apply(ctx, slo, plan.ExpectedRevision)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("Applied revision %d, digest %s\n", revision.Revision, revision.Digest)
}

{
  "mcpServers": {
    "nines": {
      "command": "/path/to/nines-mcp",
      "args": [
        "--server", "https://nines.example.com",
        "--tenant", "commerce"
      ],
      "env": {
        "API_TOKEN": "YOUR_TENANT_VIEWER_TOKEN"
      }
    }
  }
}