TOADSource ↗

Agent-friendly, human-authorized

Let the agent work. Keep the decisions.

The open TOAD Operator skill gives coding agents a precise operating contract. It accelerates the work without inventing a second, opaque automation path.

Open and reusable

One skill, two explicit modes.

Agent-assisted

The agent inspects, plans, reconciles authorized changes, and returns exact acceptance evidence.

Use $toad-operator in agent-assisted mode.
Prepare my one-node deployment.
Stop before billable resources.

Manual learning

The agent becomes a teacher: it explains one concept and command, then waits while you type and interpret it.

Use $toad-operator in manual-learning mode.
Do not execute deployment commands for me.
Teach one step, let me type it, then review my output.

The complete AGPL-licensed skill lives in skills/toad-operator beside the infrastructure it operates.

human + agent / one CLI

Your briefPlan

$ pnpm run doctor -- --json

{ "ok": true, "passed": 18, "failed": 0 }
PLAN READYThe workstation and local inputs are ready.

Illustrative handoff · commands stay visible · actions follow your authorization

A bounded operating contract

Read

Diagnose first

Doctor, status, verify, and diagnose produce structured evidence without changing the cluster.

Plan

Stay declarative

Heat, manifests, and configuration remain the source of truth. Manual console repair is not the normal path.

Stop

Keep sensitive decisions human

Destroy, restore, CA rotation, and billable expansion require explicit authority.

A useful diagnostic handoff

pnpm run support

Created …/toad-support-….json
Doctor: 17 passed, 1 warning, 0 failed

pnpm run app -- diagnose my-service --json

{
  "ok": false,
  "services": [{ "running": 1, "desired": 2 }],
  "checks": [{ "name": "https", "actualStatus": 503 }],
  "hints": ["Inspect the failed task before retrying"]
}

The allow-listed support report excludes credentials, keys, cloud identifiers, addresses, and logs. After the user reviews it, an agent can combine that bounded context with an application diagnosis without receiving unrestricted cloud access.