# Kubeletto

Kubeletto is a serverless container platform (PaaS) designed to deploy public container images or GitHub repositories directly to HTTPS endpoints with automated scaling and zero-downtime rollouts.

## Core Reference
- **Website**: https://kubeletto.com
- **API Boundary**: https://api.kubeletto.com
- **Subdomain Routing**: https://*.kubeletto.app
- **Full Guide**: https://kubeletto.com/llms-full.txt

## CLI Installation
```bash
# macOS/Linux Installer
curl -fsSL https://kubeletto.com/install.sh | sh

# Homebrew (macOS/Linux)
brew install kubeletto/tap/kubeletto

# Go install
go install github.com/benebobaa/kubeletto/apps/cli/cmd/kubeletto@latest
```

## Common Operations

### Authentication
```bash
kubeletto login                            # Interactive browser device flow
kubeletto login --api-key kl_secret...      # Non-interactive token auth
```

### Deployment
```bash
kubeletto deploy my-api --image nginx:alpine    # Deploy container image
kubeletto deploy my-api --repo <url> --branch main # Deploy GitHub repository
```

### Status & Checkups
```bash
kubeletto status my-api --output json     # Raw JSON status details
kubeletto doctor my-api --output json     # Diagnostic checkup list
```

### Log Streaming
```bash
kubeletto logs my-api --tail 100           # Fetch last 100 runtime logs
kubeletto logs my-api --build              # Inspect latest build logs
```

### Environment Config
```bash
kubeletto env list my-api                  # List variables
kubeletto env set my-api PORT=8080         # Set variable
kubeletto env delete my-api PORT           # Delete variable
```

## Agent Guidelines
- **Output Format**: Always append `--output json` when executing CLI commands programmatically.
- **Non-Interactive Execution**: Always pass `--yes` / `-y` or `--non-interactive` to bypass interactive confirmation prompts in scripts.
- **Diagnostics**: Run `kubeletto doctor <app-name> --output json` to identify failure reasons and next actions.