Documentation
Build with BernOps using detailed guides for jobs, workers, runtime variables, queues, scopes, and integration patterns.
Understand the platform
Learn the control, orchestration, and execution planes before wiring external systems into BernOps.
Write better jobs
Use Playwright conventions for readable reports, clear failures, and safe secret handling.
Integrate safely
Choose narrow API key scopes and coordinate queue-based work.
Core concepts
How the platform is structured and where each piece runs.
Coding agent CLI
Connect a computer, authenticate Pi providers, register repositories, and manage the BernOps host.
Efficient agent tools
Discover operation contracts, use compact reads, preview atomic planning, and verify readiness and usage safely.
Get started
Create the first workspace and project, then run your first Playwright job.
Platform overview
The technical mental model for projects, workers, orchestration, and boundaries.
Execution
How Playwright jobs, workers, variables, and telemetry work together.
Playwright jobs
How to write BernOps-compatible Playwright specs with clear runtime checks and reports.
Runtime variables
How project variables become Playwright environment variables and how jobs consume them.
Workers and execution
Worker connection, temporary workspaces, generated Playwright config, logs, steps, and failure handling.
Workers and pool
Connect and manage workspace workers with the CLI, then configure shared execution capacity and concurrency limits.
Integrations
How external systems authenticate and exchange work with BernOps.
API reference
Public endpoint schemas, authentication, scopes, and request examples.
GitHub integration
How BernOps connects to GitHub repositories, what permissions are required, and how exports stay reviewable.
API keys and scopes
How to choose project API key scopes and safely give machines access to BernOps.
Automation SDK
Instrument external Node.js automations and native Playwright jobs with the private SDK.
Queues
How jobs and external workers produce, claim, complete, and fail units of work.