Feature: Append a compact RTK/recovery hint after hook-rewritten commands
Nobody has claimed this yet.
Assessment
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Newbie friendliness
- 68/100
Research direction
Start by tracing the central hook/output path where commands are rewritten and existing never_worse or recovery-hint behavior is handled. Confirm the hint appears only for rewritten commands, provides a raw-output fallback, and does not appear or claim reduction when the original command is run without RTK.
Written by the indexing model from the issue text.
Description
Problem
RTK hooks rewrite commands silently. When output is reduced, the agent may not realize that RTK was involved and may assume the original command itself returned incomplete output.
Proposal
When a hook actually rewrites a command through RTK, append one short line at the end of the output indicating:
- RTK reduced the shell output
- how to rerun the original command without RTK
Example:
[rtk: output reduced — rerun without RTK: <original/bypass command>]
The hint should only be added for hook-rewritten commands and should stay as small as possible to preserve token savings.
This could be implemented centrally in the hook/output path so individual filters do not need custom logic.
Acceptance criteria
- Hint is only shown when the hook rewrites a command
- Agent gets a clear way to recover the raw output
- Raw fallback does not claim output was reduced
- Existing
never_worse/ recovery-hint behavior is preserved
- Dominant language
- Rust
- Stars
- 81.1k
- Forks
- 5.1k
- Avg merge
- 4d 11h
- Merged PRs (30d)
- 40
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from rtk-ai/rtk
-
area:cli bug filter-quality good first issue priority:medium
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
-
bug core output-formatting
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
-
uv_cmd discards print_with_hint's return value, so the tee hint is not counted and savings read 100% Openanalytics bug python
Difficulty 2/5 1-3 hours Newbie friendliness 86/100
-
area:cli bug good first issue platform:windows priority:medium resolved-pending-close
Difficulty 1/5 Under an hour Newbie friendliness 92/100
-
area:cli bug good first issue priority:high
Difficulty 1/5 Under an hour Newbie friendliness 92/100
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 86/100
kwakseongjae/auto-hwp#319 ·
-
Difficulty 1/5 Under an hour Newbie friendliness 72/100
bevyengine/bevy#25861 ·
-
comp-datalake
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
ClickHouse/ClickHouse#121222 ·
-
enhancement remote
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
A-linter
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
oxc-project/oxc#26863 ·