repositories / pi-ext

pi-ext

bugabingas pi extensions

owned by bugabinga

extensions/rtk/README.md

Raw

rtk

Rewrites Pi bash tool calls through RTK.

Install / load

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

Requires rtk >= 0.23.0 on PATH. If missing or old, the extension prints one warning and stays idle.

Commands / tools / settings

Pi commands: none.

Pi tools: none.

Pi hooks:

Pi settings: none.

Env vars:

RTK_DISABLED=1

Prefix one command with RTK_DISABLED=1 to bypass rewriting.

UI

The bash tool widget is the command indicator. When RTK applies, Pi shows the rewritten rtk ... command. After session start, Pi checks RTK in the background and warns whether find rewrites are disabled or the compatibility guard can be removed. The first bash call waits for that shared check when it is still running.

Behavior

rtk does one thing:

  1. registers the bash hook without blocking extension load
  2. probes rtk --version after session start, or on the first bash call
  3. warns once and leaves commands unchanged if rtk is missing or too old
  4. probes rtk find -path against a temporary nested marker and warns with the result
  5. ignores non-bash tools
  6. ignores empty, already-rtk, and disabled commands
  7. calls rtk rewrite <command> with a 2s timeout
  8. applies exit 0 and 3 rewrites
  9. rejects every rtk find rewrite while the path probe fails
  10. locally maps missing journalctl, systemctl status, hyprctl clients, and ps filters to rtk summary
  11. leaves other exit 1, exit 2, timeouts, errors, and empty output untouched

No prompt injection. No status widget. No command gating. No output compaction. No shell-specific helpers.

Markdown source
# rtk

Rewrites Pi `bash` tool calls through RTK.

## Install / load

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

Requires `rtk >= 0.23.0` on `PATH`.
If missing or old, the extension prints one warning and stays idle.

## Commands / tools / settings

Pi commands:
none.

Pi tools:
none.

Pi hooks:

- `tool_call`:
  watches builtin `bash` calls and may replace `input.command` with `rtk rewrite` output.

Pi settings:
none.

Env vars:

```text
RTK_DISABLED=1
```

Prefix one command with `RTK_DISABLED=1` to bypass rewriting.

## UI

The bash tool widget is the command indicator.
When RTK applies, Pi shows the rewritten `rtk ...` command.
After session start, Pi checks RTK in the background and warns whether `find` rewrites are disabled or the compatibility guard can be removed.
The first `bash` call waits for that shared check when it is still running.

## Behavior

`rtk` does one thing:

1. registers the `bash` hook without blocking extension load
2. probes `rtk --version` after session start, or on the first `bash` call
3. warns once and leaves commands unchanged if `rtk` is missing or too old
4. probes `rtk find -path` against a temporary nested marker and warns with the result
5. ignores non-bash tools
6. ignores empty, already-`rtk`, and disabled commands
7. calls `rtk rewrite <command>` with a 2s timeout
8. applies exit `0` and `3` rewrites
9. rejects every `rtk find` rewrite while the path probe fails
10. locally maps missing `journalctl`, `systemctl status`, `hyprctl clients`, and `ps` filters to `rtk summary`
11. leaves other exit `1`, exit `2`, timeouts, errors, and empty output untouched

No prompt injection.
No status widget.
No command gating.
No output compaction.
No shell-specific helpers.