werkr Documentation

werkr is a next-gen, AI-native developer environment manager that allows you to configure and create environments, sandboxes, and AI workspaces in a fast and reproducible way.

What is werkr?

werkr provides deterministic execution environments that reconcile with organizational policy. It gives you a single, declarative way to define where and how code runs — whether it's a developer on a laptop, a CI pipeline, or an AI agent in a sandbox.

Key Features

• Reproducible — Define environments once, spin them up identically everywhere.
• Local or cloud — Run on a developer laptop, in a container, or in the cloud.
• Deployable in your tenant — Your data, your rules, your compliance.
• Centrally configurable — Set org defaults while allowing local customizations.
• AI-native — Purpose-built for AI tooling and agents with governed access.
• Built for human and machine code — Same guardrails for both.

How it works

werkr uses a Kubernetes-inspired declarative model. You define Workstations and Workstation Configurations as YAML manifests. werkr reconciles these definitions against the actual state of your infrastructure, creating and configuring environments automatically.

# Example: define a workstation
apiVersion: werkr.dev/v1alpha1
kind: Workstation
metadata:
  name: my-dev-env
  labels:
    devtype: k8s
spec:
  os:
    id: debian-13
  provider: gcp
  resources:
    diskSize: 30

Getting Started

Ready to get started? Follow the installation guide to set up werkr, then create your first local workstation.