Stop polluting the LLM context with rtk instructions. When a hook already
rewrites commands transparently, telling the agent to "always prefix with
rtk" is redundant noise. Hooked/plugin agents now get a one-paragraph
"rtk is running + rtk proxy to bypass" note instead:
- Claude (RTK.md), Gemini (GEMINI.md)
- Copilot (copilot-instructions.md) — both VS Code Chat and Copilot CLI
share this file, so both hosts are now slim.
Local `rtk init` keeps the verbose block when no usable hook is present;
rules-file agents (Cline, Windsurf, Codex, Kilo Code, Antigravity) unchanged.
Long term this awareness note should be removed entirely: once hooks are
fully reliable, rtk stays invisible and the context carries zero rtk text.
Verify with real usage of hosts before merge:
- [ ] Gemini CLI: bash-wrapper hook actually rewrites (no fallback if bash absent)
- [ ] Copilot VS Code Chat: hook fires with slim copilot-instructions.md
- [ ] Copilot CLI: hook fires with slim copilot-instructions.md
Adds a "Preview without writing" subsection under Step 1 covering the
--dry-run flag, -v interaction for content preview, that telemetry
consent is skipped, and the --show conflict. Required by CONTRIBUTING.md
section 4 (new features need documentation).
Windows users downloading the pre-built binary had no guidance —
double-clicking rtk.exe flashes a terminal and exits immediately.
- README: add warning under Windows binary link, add full Windows section
with WSL vs native comparison table
- installation.md: add pre-built binaries section with Windows note
- supported-agents.md: add Windows support section (CLAUDE.md fallback)
- troubleshooting.md: add "double-click does nothing" and "hook not working"
entries for Windows users
Prompted by Discord user report (PedroLyra).
Signed-off-by: Patrick szymkowiak <patrick.szymkowiak@innovtech.eu>
Add rtk init --agent kilocode and rtk init --agent antigravity commands.
Kilo Code: installs .kilocode/rules/rtk-rules.md (project-scoped)
Google Antigravity: installs .agents/rules/antigravity-rtk-rules.md (project-scoped)
Both follow the same prompt-level guidance pattern as Cline and Windsurf,
using rules files that instruct the agent to prefix shell commands with rtk.
Creates docs/README.md (interface contract defining 3-tab structure,
required frontmatter, and conventions) and 4 stub pages with valid
frontmatter for docs/guide/, docs/reference/, and docs/architecture/.
These are the prerequisites for the prepare-docs.mjs pipeline (Plan B)
and for Adrien's Phase 1 content work.
No existing files modified.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Florian BRUNIAUX <florian@bruniaux.com>
Adrien Eppling