| name | bootstrap |
| description | Dispatch project bootstrap requests to a repository-owned `.agents/scripts/bootstrap.sh` implementation.
|
Bootstrap
Contract
Prereqs:
- Run from the target repository root unless the user explicitly names another
repository path.
agent-run is installed from nils-cli 0.20.0 or newer and available on
PATH.
- The target repository owns an executable
.agents/scripts/bootstrap.sh.
- Bootstrap behavior must remain repository-specific because dependency
managers, sensitive setup policy, and local services differ by project.
Inputs:
- User-provided bootstrap arguments, passed through to the project-local script.
- Optional repository path when bootstrapping a different checkout.
Outputs:
- The project-local script's stdout, stderr, exit code, and artifact paths.
- A clear stop message when no project-local implementation exists.
Failure modes:
.agents/scripts/bootstrap.sh is missing or is not executable.
agent-run is unavailable or reports a blocked required project
environment.
- The project-local script exits non-zero.
- The requested repository path is not a directory.
Entrypoint
Resolve the repository root, then invoke the project-local script through
agent-run so repository .envrc / .env decisions are explicit:
agent-run exec --cwd "$repo_root" -- ./.agents/scripts/bootstrap.sh "$@"
When the script is missing or not executable, report:
no project-local implementation: .agents/scripts/bootstrap.sh
Workflow
- Resolve the target repository root.
- Verify
.agents/scripts/bootstrap.sh exists and is executable.
- Run the script through
agent-run exec --cwd "$repo_root" --, passing
through user arguments.
- Report the script's exit code and any setup notes it prints.
- Do not add generic bootstrap behavior to runtime-kit.
Boundary
Runtime-kit owns only the dispatch contract. Each consuming repository owns its
own bootstrap implementation.