Core · In-cluster execute
The fix runs where your workloads run — not in our VPC.
RemOps Agent installs with Helm, heartbeats to the API, pulls approved actions, executes them locally, and reports success or failure. That is the entire trust boundary in one sentence.
01 · Agent
Helm install. Heartbeat. Poll. Execute. Report.
Generate an agent install token in onboarding, install into your cluster, and confirm heartbeat. From then on, approved work leaves the SaaS as pending executions and returns as results — never as remote shell from our side.
POST /agent/register+ periodic heartbeatGET /agent/executions/pendingpull modelPOST /agent/executions/{id}/resultcloses the loop
helm install remops-agent ./charts/remediation-agent \ --namespace remops-system --create-namespace \ --set platformUrl=https://api.remopsai.com \ --set agentToken=•••••••• ♥ heartbeat ok · polling pending executions ✓ action patch_configmap · success ✓ incident RESOLVED
02 · Action catalog
Kubernetes, cloud, and code actions your runbooks already name
Remediation plans map onto a catalog your agent can run locally — restarts, patches, rollbacks, scaling, and common cloud/code operations — without teaching RemOps your private SSH keys.
- Kubernetes: restart, scale, patch, rollback, delete
- AWS: targeted operational actions your packs support
- GitHub: PR-oriented remediation paths
- Chat / paging updates when you want humans notified
03 · Verify
Execution without verification is just hope
Plans include verification expectations — latency thresholds, error-rate windows, pod readiness. Results stream back onto the incident so “resolved” means measured, not assumed.
Post-action checks
- p99 payments.api < 300ms for 5m → pass
- CrashLoop count == 0 → pass
- Error rate < 0.5% → pass
RESOLVED 54s after approve
04 · Day-2 ops
Agent health is part of onboarding — not an afterthought
The onboarding checklist tracks agent registration and heartbeat so you know when full launch is real. Soft launch remains useful for intake → investigate → approve demos without cluster access.
- Onboarding step for agent token + install
- Heartbeat visibility in the checklist
- Failed executions surface on the incident, not in a black hole
Shipping every week.
- Helm agent chartInstall token → register → heartbeat.
- Pending pull modelAgent fetches work; SaaS never pushes shell.
- Result reportingSuccess/failure closes the incident loop.
- Action catalogK8s-first packs with cloud/code extensions.
Frequently asked questions
In your Kubernetes cluster (or environment you control). It needs network access to api.remopsai.com for poll/report only.
No. Write access stays with the agent’s local identity and the packs you install beside it.
Soft: webhook → investigate → approve queues work. Full: agent connected and at least one real remediation executes and reports.
The incident can move to FAILED with the agent’s result payload. You keep the audit trail and can remediate manually or re-plan.
Yes for demos — agent can report simulated execution while you validate the control plane.
Finish the incident inside your network.
Install the agent when you are ready for full launch. Until then, soft launch still proves the loop.