# RTK Usage

`rtk` is installed at `/home/aaron/.cargo/bin/rtk`. Use it by default for noisy shell commands so agent sessions spend fewer tokens on low-value output.

Prefer `rtk` for:

- directory and file discovery: `rtk ls`, `rtk tree`, `rtk find`
- search output: `rtk grep`
- tests and builds with noisy output: `rtk test`, `rtk npm test`, `rtk tsc`, `rtk lint`
- dependency and environment summaries: `rtk deps`, `rtk env`
- logs, JSON, diffs, and command summaries: `rtk log`, `rtk json`, `rtk diff`, `rtk summary`

Use raw shell commands instead when exact, unfiltered, streaming, or interactive output matters. Examples: `sed -n` for precise line ranges, `tail -f` for live logs, `virsh console`, prompts, password entry, TTY tools, and commands whose full output is the thing being inspected.

Examples:

```bash
rtk ls -la
rtk tree -L 2
rtk grep "READY_COMMAND" tools/vm
rtk npm test
rtk deps
```

Useful checks:

```bash
rtk --version
rtk gain
rtk init --codex --show
```
