Local Setup (Human)¶
Run Engineering Runtime on a laptop or workstation. No Go toolchain, no
source checkout, and no cloud CLI are required for the core path — only the
engrt binary.
For the shortest path, use Quick Start. This page is the fuller local contract: home layout, env vars, day-to-day commands, and a throwaway sandbox.
1. Install the binary¶
Follow Installation for macOS or Linux. Windows support is not yet available in v0.9.9. Confirm:
2. Runtime Home¶
Default location:
| OS | Path |
|---|---|
| macOS / Linux | ~/.engrt |
Relocate for a project or experiment:
Full layout and ownership rules: Runtime Home.
3. Authenticate¶
The runtime never stores credentials. Export or log in with the platform, then validate:
export ENGRT_GITHUB_TOKEN=ghp_… # GitHub PAT
engrt auth status
engrt auth login github # optional explicit check
CLI-native platforms (GCP, Kubernetes, OpenShift) use their own login, then
an authentication.<provider> block in config.yaml. See
Authentication.
4. Day-to-day usage¶
Provider operations
engrt files write ./notes.txt hello
engrt github user get
engrt github repo view cli/cli
engrt github --help # live surface for this binary
Command Engine (allowed binaries only)
engrt command run git status
engrt command run gh repo list --limit 5
engrt command run kubectl get pods
Capabilities
engrt capability validate ~/work/engineering-runtime-capabilities/capabilities/files/notes-roundtrip.md
engrt capability execute ~/work/engineering-runtime-capabilities/capabilities/files/notes-roundtrip.md \
--input path=./hello.txt --input message="local run"
Discover contracts (refreshed with the binary)
Audit
Mark interactive sessions on the audit trail:
5. Shared company capabilities¶
Clone a version-controlled store at a reviewed revision and declare its
capabilities/ directory under capabilities.sources:
See Sharing a Capability Directory
and the
engineering-runtime-capabilities
repo.
6. Throwaway sandbox (upgrade / experiment)¶
Same pattern CI uses — isolate Home so you never touch your real config:
export ENGRT_HOME="$PWD/runtime-home"
export ENGRT_GITHUB_TOKEN=ghp_…
rm -rf "$ENGRT_HOME"
engrt bootstrap
engrt config validate
Wipe and re-bootstrap after swapping binary versions to test upgrades. See Upgrading.
Next¶
| Goal | Page |
|---|---|
| First capability | Quick Start |
| Change what is allowed | Policy |
| Understand or select a native-tool target | Where operations run |
| Run the same thing in a pipeline | CI/CD |
Let an AI drive engrt only |
AI agent |
Operational examples on this site were verified against Runtime 0.14.0. After bootstrap, the version-exact files in Runtime Home win.