repositories / pi-ext

pi-ext

bugabingas pi extensions

owned by bugabinga

extensions/runtime/README.md

Raw

runtime

Runtime detection telemetry for Pi footer/status.

Install / load

Loaded through the root pi-ext package. See root README.

Commands / tools / settings

Behavior

Detects project runtime from marker entries in cwd, then parent dirs up to $HOME. If $HOME is unset, or cwd is outside $HOME, only cwd is checked.

Detection order:

Reads runtime version with the matching runtime binary when available. Version lookup times out after 2500 ms. Missing binaries leave the runtime name as text.

If @bugabinga/pi-ext-footer is loaded, emits footer:segment:

Without footer, writes Pi status text under id runtime.

Refreshes on session start and agent end. UI output is skipped when the session has no UI.

Clears segment/status when no runtime is detected or session shuts down.

Markdown source
# runtime

Runtime detection telemetry for Pi footer/status.

## Install / load

Loaded through the root `pi-ext` package.
See [root README](../../README.md).

## Commands / tools / settings

- Commands: none.
- Tools: none.
- Hooks: `session_start`, `agent_end`, `session_shutdown`.
- Settings: none.

## Behavior

Detects project runtime from marker entries in `cwd`, then parent dirs up to
`$HOME`. If `$HOME` is unset, or `cwd` is outside `$HOME`, only `cwd` is
checked.

Detection order:

- `bun`:
  `bun.lock`, `bun.lockb`
- `deno`:
  `deno.json`, `deno.jsonc`, `deno.lock`
- `lua`:
  `stylua.toml`, `.stylua.toml`, `.luarc.json`, `.luarc.jsonc`, `init.lua`,
  `lua`, `*.lua`
- `nodejs`:
  `package.json`, `.nvmrc`, `.node-version`
- `python`:
  `pyproject.toml`, `requirements.txt`, `setup.py`, `setup.cfg`, `Pipfile`,
  `.python-version`
- `golang`:
  `go.mod`
- `rust`:
  `Cargo.toml`
- `java`:
  `pom.xml`, `build.gradle`, `build.gradle.kts`
- `ruby`:
  `Gemfile`, `.ruby-version`
- `php`:
  `composer.json`

Reads runtime version with the matching runtime binary when available.
Version lookup times out after 2500 ms. Missing binaries leave the runtime name
as text.

If `@bugabinga/pi-ext-footer` is loaded, emits `footer:segment`:

- id: `runtime`
- zone: `workspace`
- order: `3`

Without footer, writes Pi status text under id `runtime`.

Refreshes on session start and agent end.
UI output is skipped when the session has no UI.

Clears segment/status when no runtime is detected or session shuts down.