---
name: august-cyber
description: Autonomous offensive security testing, auto-patching, scope-locked cloud sandboxes, and byte-exact HTTP retesting with headless agent auth and billing.
---

# August Cyber Agent Skill

Use August Cyber to discover attack surfaces, verify target ownership, launch scope-locked Linux sandboxes, run CyberCART security models, generate minimal patches, and verify 200 -> 403 fixes.

Everything runs from the CLI and API with zero browser required.

## 1. Install the CLI

```bash
curl -fsSL https://api.august.so/install | sh
```

## 2. Sign Up or Log In Headlessly (Email OTP)

Ask the user for their email address (or use your own agent mailbox), then run:

```bash
august auth register --email <email> --accept-terms --json
```

Email OTP mints a standard operational key (`acrt_...`) for models, sandboxes, target verification, and usage. To manage sub-keys, spend limits, and billing programmatically, have the workspace owner mint an `acrt_admin_...` key once in `https://august.so/console/keys` and connect it with `august login --key <acrt_admin_...>`. Ask the user for the 6-digit code emailed to them (or read it from your inbox), then verify:

```bash
august auth verify <6-digit-code> --json
```

Credentials are saved to `~/.config/august/credentials.json` (`0600`).

## 3. Check Balance & Top Up Credits

```bash
august account status --json
august billing status --json
august billing topup --amount-cents 2500 --json
```

When a checkout URL is returned, present it to the user and reconcile once paid:

```bash
august billing reconcile <order_id> --json
```

## 4. Manage Scoped Keys (Admin Key Required)

```bash
august keys list --json
august keys create --label "CI Runner" --scopes inference,sandboxes,targets:verify,usage:read --json
august keys revoke <key_id> --json
```

## 5. Run the Closed-Loop Security Workflow

### Map routes, RLS policies, and MCP tools locally

```bash
august routes --json
```

### Verify target ownership (mandatory before any remote sandbox testing)

```bash
august sandbox challenge staging.example.com --json
# Publish the DNS TXT record or /.well-known/august-verify.txt file, then verify:
august sandbox verify staging.example.com --json
```

### Launch a scope-locked cloud sandbox and test

```bash
august sandbox create --target staging.example.com --size small --ttl 900 --json
august sandbox exec <sbx_id> -- curl -sS https://staging.example.com/health
august sandbox evidence <sbx_id> --out evidence.json
august sandbox stop <sbx_id>
```

### Run CyberCART models directly (OpenAI, Anthropic, or Responses compatible)

- Base URL: `https://api.august.so/v1`
- Endpoints: `POST /v1/chat/completions`, `POST /v1/messages`, `POST /v1/responses`, `GET /v1/models`
- Auth: `Authorization: Bearer <acrt_...>` (or `x-api-key` on `/v1/messages`)
- Models: `august-cybercart-pro`, `august-cybercart-flash`

### Replay and verify fixes

```bash
august retest --json
```
