Skip to content

docs(guides): migrate runner_env examples to env.runner #2756

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ralphbean merged 2 commits into from
Jul 1, 2026
Merged

docs(guides): migrate runner_env examples to env.runner #2756

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2cd430f
docs(guides): migrate runner_env examples to env.runner
ralphbean Jun 29, 2026
e9113c9
Merge branch 'main' into docs/update-env-config-guides
ralphbean Jun 30, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 7 additions & 6 deletions docs/guides/user/building-custom-agents.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -143,11 +143,12 @@ validation_loop:

post_script: customized/scripts/post-my-agent.sh

runner_env:
MY_VAR: "${MY_VAR}"
ISSUE_KEY: "${ISSUE_KEY}"
GH_TOKEN: "${GH_TOKEN}" # auto-minted in CI when --mint-url is provided
FULLSEND_OUTPUT_SCHEMA: ${FULLSEND_DIR}/customized/schemas/my-agent-result.schema.json
env:
runner:
MY_VAR: "${MY_VAR}"
ISSUE_KEY: "${ISSUE_KEY}"
GH_TOKEN: "${GH_TOKEN}" # auto-minted in CI when --mint-url is provided
FULLSEND_OUTPUT_SCHEMA: ${FULLSEND_DIR}/customized/schemas/my-agent-result.schema.json

timeout_minutes: 20

Expand Down Expand Up @@ -462,7 +463,7 @@ jobs:

5. **`ANTHROPIC_VERTEX_PROJECT_ID` and `CLOUD_ML_REGION`** — must be in the workflow `env` block so the `gcp-vertex.env` file (copied into the sandbox with `expand: true`) resolves correctly.

6. **All `runner_env` variables** must appear in the workflow `env` block. If your harness references `MY_VAR: "${MY_VAR}"`, the workflow must set `MY_VAR`.
6. **All `env.runner` variables** must appear in the workflow `env` block. If your harness references `MY_VAR: "${MY_VAR}"`, the workflow must set `MY_VAR`.

## Step 8: Trigger the agent

Expand Down
18 changes: 10 additions & 8 deletions docs/guides/user/customizing-agents.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,10 +40,11 @@ validation_loop:
script: scripts/validate-output-schema.sh
max_iterations: 2

runner_env:
PUSH_TOKEN: "${PUSH_TOKEN}" # auto-minted in CI when --mint-url is provided
REPO_FULL_NAME: "${REPO_FULL_NAME}"
REPO_DIR: "${GITHUB_WORKSPACE}/target-repo"
env:
runner:
PUSH_TOKEN: "${PUSH_TOKEN}" # auto-minted in CI when --mint-url is provided
REPO_FULL_NAME: "${REPO_FULL_NAME}"
REPO_DIR: "${GITHUB_WORKSPACE}/target-repo"
```

**Optional fields** (all have secure defaults and can be omitted):
Expand Down Expand Up @@ -358,10 +359,11 @@ validation_loop:
script: scripts/custom-validate.sh # Changed script
max_iterations: 5 # Changed from: 2

runner_env:
PUSH_TOKEN: "${PUSH_TOKEN}"
REPO_FULL_NAME: "${REPO_FULL_NAME}"
REPO_DIR: "${GITHUB_WORKSPACE}/target-repo"
env:
runner:
PUSH_TOKEN: "${PUSH_TOKEN}"
REPO_FULL_NAME: "${REPO_FULL_NAME}"
REPO_DIR: "${GITHUB_WORKSPACE}/target-repo"
```

Then create your custom skill at `.fullsend/customized/skills/my-custom-linting/SKILL.md`.
Expand Down
Loading