---
title: "@henryqw/pi-rtk-test"
seo:
  description: "Route direct Pi pnpm test calls through RTK."
---

<div class="not-prose my-6 flex flex-wrap items-center gap-3"><a href="https://www.npmjs.com/package/@henryqw/pi-rtk-test" aria-label="View @henryqw/pi-rtk-test version v0.5.3 on npm"><img alt="Version v0.5.3" height="20" src="https://img.shields.io/static/v1?cacheSeconds=7200&amp;color=1d4ed8&amp;label=version&amp;labelColor=6a7282&amp;style=flat-square&amp;message=v0.5.3" width="96"></a><div class="ml-auto flex flex-wrap items-center justify-end gap-3"><a href="https://www.npmjs.com/package/@henryqw/pi-rtk-test" aria-label="View @henryqw/pi-rtk-test on npm"><img alt="Monthly npm downloads" height="20" src="https://img.shields.io/npm/dm/%40henryqw%2Fpi-rtk-test?cacheSeconds=7200&amp;color=1d4ed8&amp;label=downloads&amp;labelColor=6a7282&amp;style=flat-square" width="144"></a><a href="https://github.com/HenryQW/pi-harness/blob/main/extensions/pi-rtk-test/LICENSE" aria-label="View the MIT license for @henryqw/pi-rtk-test"><img alt="MIT license" height="20" src="https://img.shields.io/npm/l/%40henryqw%2Fpi-rtk-test?cacheSeconds=7200&amp;color=1d4ed8&amp;label=license&amp;labelColor=6a7282&amp;style=flat-square" width="78"></a></div></div>

Keep long `pnpm test` output out of Pi's model context. Supported direct Bash calls use RTK, which reports failures and a short result instead of the full log.

## Install

```bash
pi install npm:@henryqw/pi-rtk-test
```

Install Rust Token Killer (`rtk`) on Pi's `PATH`. This extension does not install or update RTK.

```bash
brew install rtk
rtk --version
```

## Use

Keep your commands unchanged. Pi rewrites these direct Bash calls before execution:

| Pi command | Bash command |
| --- | --- |
| `pnpm test` | `rtk test pnpm test` |
| `pnpm test -- marker` | `rtk test pnpm test -- marker` |

Only leading and trailing whitespace is removed. RTK runs tests and controls output and exit status; this extension never captures output or examines results.

## Limits and recovery

Only bare `pnpm test` with optional test arguments is supported. These forms stay unchanged:

- `pnpm run test` and `pnpm run-script test`
- Global or workspace options, such as `pnpm --filter pkg test`
- Quoted or indirect programs: `"pnpm" test`, `env pnpm test`
- `pnpm test:watch` and unrelated commands
- Newlines, carriage returns, `;`, `|`, `&`, `<`, `>`, backticks, and `$(`
- Commands starting with `rtk`

Use `rtk test ...` explicitly for unsupported forms, for example `rtk test pnpm run test`.

At load, `rtk test --help` runs once with a two-second timeout. A thrown error, nonzero exit, kill signal, or timeout blocks supported calls without a startup warning. Other calls stay unchanged. The block message says:

```text
RTK is unavailable. Install RTK and verify `rtk test --help`.
```

Repair RTK, then reload the extension or restart Pi to repeat the probe.
