Skip to content

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:

engrt version
engrt bootstrap
engrt config validate

2. Runtime Home

Default location:

OS Path
macOS / Linux ~/.engrt

Relocate for a project or experiment:

export ENGRT_HOME=/tmp/runtime-home
engrt bootstrap

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)

ls ~/.engrt/commands/
cat ~/.engrt/commands/github_commands.txt
ls ~/.engrt/specs/

Audit

engrt audit tail -n 20
engrt audit tail --output json

Mark interactive sessions on the audit trail:

export ENGRT_CONSUMER=human

5. Shared company capabilities

Clone a version-controlled store at a reviewed revision and declare its capabilities/ directory under capabilities.sources:

engrt capability execute github/github-repo-health \
  --input repository=cli/cli

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.