| name | rtk-toggle |
| description | Toggle or inspect the rtk token-filter mode used by /front-agent for the current session. Plugin-scoped; no global hook. |
Skill: rtk-toggle
Trigger: /rtk [mode]
Purpose: Let the user choose whether this plugin's internal Bash calls (tsc, eslint, git, gh, test runners, grep/find/ls) pipe through rtk for token compression.
Modes
| Mode | Behavior |
|---|
off | Raw commands. Default. |
standard | rtk applied to git/gh/tsc/eslint/test/grep/find/ls. |
aggressive | Same as standard plus -u (ultra-compact) flag. |
git-only | rtk applied only to git/gh commands; everything else raw. |
Trigger Routes
- Explicit arg:
/rtk standard, /rtk off, etc. — write the mode and report.
- No arg: launch the AskUserQuestion picker UI and let the user choose.
- Status query:
/rtk status — print the currently resolved mode without changing it.
Resolution Order (read by hooks/rtk-wrap.sh)
FE_COPILOT_RTK env var — hard override, never touched by this skill..fe-copilot-cache/rtk-session.flag — written by this skill and by /front-agent.- Default:
off.
Implementation
When user provides a mode argument
bash hooks/rtk-wrap.sh --set <mode>
Valid modes: off | standard | aggressive | git-only. Reject others with a one-line error.
When user runs /rtk status
bash hooks/rtk-wrap.sh --mode
Report the returned value. If FE_COPILOT_RTK is set, mention that the env var is overriding the flag file.
When user runs /rtk with no arg
Use the AskUserQuestion tool with one question, 4 options (off / standard / aggressive / git-only). After the user answers, persist with bash hooks/rtk-wrap.sh --set <answer>.
Output
Single compact line:
rtk mode: standard (session flag written)
No prose, no emojis, no explanation of how rtk works internally.
Guarantees
- This skill never installs or uninstalls rtk globally.
- It only writes
.fe-copilot-cache/rtk-session.flag scoped to this plugin directory.
- If rtk is not installed, the mode still writes, but
rtk-wrap.sh will silently fall back to raw commands at runtime.
