bd10b002d0
Follow up on #2609 :
...
- Fix documentation, Cursor now uses native rust binary hook
- Fix rtk-rewrite.sh shell script to fail on any exit code except 0 and 3
- Test that "continue": true is also present for "permission": "ask" and sync shell rewrite hook
2026-06-30 22:18:39 +02:00
84616d131d
fix(grep): stabilize argument parsing
2026-06-10 23:38:54 +02:00
67a5958459
doc(init): fix documentation inconsistencies arount rtk init
...
Fixes #213
2026-05-30 18:16:41 +02:00
e3ad973617
fix(copilot-cli): use user-level instruction for -g
...
-g was missing user level instructions which are available for copilot
2026-05-29 09:16:22 +02:00
4b0bbf269b
feat(hook): --global Copilot install + transparent rewrite via modifiedArgs
2026-05-26 19:56:04 +02:00
84b703d7d0
feat(hook): wire Copilot into uninstall, telemetry, and discover
2026-05-25 22:19:58 +02:00
8fb29e2f75
fix(hook): emit Copilot CLI-compatible hook config + strip BOM on Windows
2026-05-25 22:19:57 +02:00
cb1661e68d
feat(init): remove --pi flag, canonicalize Pi install to --agent pi
...
chore: sync the codebase after mergew
2026-05-11 21:46:46 +02:00
1ef5b10f73
Merge branch 'develop' into develop
2026-05-11 20:17:22 +02:00
9d3b99dec8
feat(hermes): add rtk integration
...
Signed-off-by: Kayphoon <109347466+Kayphoon@users.noreply.github.com >
2026-05-12 00:30:39 +08:00
96aeb69842
Merge branch 'develop' into feat/init-dry-run
2026-05-10 00:00:15 +02:00
a4caafad71
chore: docs cleanup
2026-05-06 18:51:39 +02:00
b2a3ad9443
feat: rm rtk awareness injection
2026-05-06 18:44:27 +02:00
d6e27527ea
refactor: handling of uninstallation
2026-05-06 16:38:01 +02:00
492aa76ed3
Merge pull request #1009 from KuSh/broken-pnpm-i
...
fix(pnpm): install don't take a list of packages
2026-05-03 16:46:49 +02:00
2f185a4749
docs(init): document --dry-run in quick-start guide
...
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).
2026-04-26 17:53:44 -04:00
021827c3c9
fix(grep): adjust the command to fall through if the output would already be as small as possible
2026-04-25 20:38:33 -05:00
e3149cb7fb
Merge pull request #1056 from vzwjustin/develop
...
feat(gains): add --reset flag
2026-04-21 19:00:59 +02:00
00c5a36728
Merge pull request #1384 from rtk-ai/coding-practices-v1
...
docs(contributing): coding practices v1
2026-04-21 18:57:48 +02:00
2e401ac38f
fix(docs): add missing docs for exclude commands patterns
2026-04-19 13:59:03 +02:00
176ceb4a7d
Merge pull request #1310 from JBF1991/feat/curl-cmd-no-filter
...
Simplified `rtk curl` Filter
2026-04-18 18:35:39 +02:00
a724375650
docs(contributing): coding practices v1
2026-04-18 17:26:12 +02:00
80bc7fbd61
documentation
2026-04-15 14:45:30 -05:00
4c9b528206
docs: Adrien review — hierarchy, counts, consistency, gaps
...
Hierarchy:
- Move troubleshooting.md and what-rtk-covers.md to guide/resources/
- Add guide/resources/telemetry.md (adapted from docs/TELEMETRY.md,
user-facing: consent, opt-out, GDPR rights — without internal sections)
Content fixes:
- Remove all hardcoded counts (9 ecosystems, 12 agents, 60+, 7 more)
replaced with qualitative language throughout
- Unify DB filename: tracking.db → history.db everywhere
(canonical: src/core/constants.rs HISTORY_DB)
- installation.md: replace bare `cargo install rtk` with warning +
explicit git URL to avoid Rust Type Kit name collision
- supported-agents.md: remove hardcoded agent count
- quick-start.md: remove hardcoded ecosystem list, link to what-rtk-covers
New content:
- gain.md: add --quota section explaining pro/5x/20x tier meanings
- gain.md: add callout linking to discover.md (find missed savings)
- index.md: add "Analyze your usage" section (rtk discover, rtk session)
- configuration.md: clarify ignore_dirs/ignore_files scope, add prose
link to telemetry.md
- what-rtk-covers.md: clarify --ultra-compact vs git -u short flag conflict
Cross-references:
- All internal links updated for new resources/ paths
- index.md: link to troubleshooting, telemetry, what-rtk-covers, analytics
- discover.md: updated relative link to troubleshooting
README:
- Add Core team section (Patrick Szymkowiak, Florian Bruniaux, Adrien Eppling)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-04-14 14:17:58 +02:00
9e96caa0a1
Merge pull request #355 from KuSh/pnpx+dlx
...
feat(discover): handle more npm/npx/pnpm/pnpx patterns
2026-04-13 20:31:12 +02:00
e09a53e5f7
Merge pull request #1181 from rtk-ai/rgpd-telemetry
2026-04-13 09:26:46 +02:00
4093d5c13d
Merge pull request #1094 from rtk-ai/docs/windows-instructions
2026-04-13 09:26:05 +02:00
45938b2a4d
feat(js): distinguish between jest and vitest and don't rewrite npm test commands as we don't know which test framework is used under the hood
...
Signed-off-by: Nicolas Le Cam <niko.lecam@gmail.com >
2026-04-12 22:03:39 +02:00
2e4cc4bb52
fix(telemetry): consent, erasure, auth, docs
2026-04-12 12:59:22 +02:00
9a50efadc3
fix(pnpm): install don't take a list of packages
...
Signed-off-by: Nicolas Le Cam <niko.lecam@gmail.com >
2026-04-11 17:31:10 +02:00
6a5bc847e0
fix(telemetry): RGPD-compliant, consent gate, erasure, privacy controls
...
+ docs update
2026-04-10 16:04:08 +02:00
cce04811c7
Update troubleshooting.md
2026-04-10 14:22:19 +02:00
b73506867e
docs: add Windows setup instructions and troubleshooting
...
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 >
2026-04-09 09:30:58 +02:00
66b90f1ed3
Merge pull request #802 from Yosoyepa/feat/add-new-agents
...
feat(init): add support for kilocode and antigravity agents
2026-04-09 09:28:11 +02:00
644c50f786
Merge pull request #1001 from rtk-ai/feat/telemetry-enrichment
...
feat(telemetry): enrich daily ping with gap detection and quality metrics
2026-04-09 08:57:21 +02:00
3f15b89227
Merge branch 'develop' into develop
2026-04-08 17:54:07 -05:00
514744e27b
docs: remove old docs/AUDIT_GUIDE.md path
...
Upstream moved this to docs/usage/AUDIT_GUIDE.md in deda44fhttps://claude.ai/code/session_015WXbDdxEU3pXPBtheDkXcd
2026-04-08 22:53:27 +00:00
4db7e86c26
docs: add --reset/--yes flags to docs/usage/AUDIT_GUIDE.md
...
Adds reset flag documentation to the upstream file path:
- Quick Reference: reset usage examples with and without --yes
- Command Options: Reset Flag table with --reset and --yes descriptions
- Warning note about irreversibility and non-interactive behaviour
https://claude.ai/code/session_015WXbDdxEU3pXPBtheDkXcd
2026-04-08 22:51:55 +00:00
d0a3797ec5
feat(init): add native support for Kilo Code and Google Antigravity
...
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.
2026-04-08 15:37:29 -05:00
be5c0576d9
fix(docs): update TELEMETRY.md to match code after review fixes
...
- passthrough_top example: "npm ci:8" -> "npm:8" (first word only)
- estimated_savings_usd_30d: $5/Mtok -> $3/Mtok (input pricing)
- Remove needless borrow in build_meta_usage (clippy)
Signed-off-by: Patrick Szymkowiak <patrick@rtk-ai.app >
Signed-off-by: Patrick szymkowiak <patrick.szymkowiak@innovtech.eu >
2026-04-08 17:30:24 +02:00
6e55f8984c
docs: address Adrien's review — structure, missing content, agents
...
Structure:
- Move docs/README.md → .github/docs-pipeline-contract.md (interface
contract is not user-facing content)
- Rewrite docs/guide/index.md as a proper landing page with RTK intro,
flow diagram, and navigation (replaces empty nav stub)
- Move configuration.md → getting-started/configuration.md (sidebar order 4,
after supported-agents per Adrien's suggestion)
Missing content:
- Add docs/guide/analytics/discover.md: rtk discover (missed savings analysis)
and rtk session (adoption tracking across sessions)
- Add uninstall instructions to installation.md (rtk init -g --uninstall,
cargo uninstall, brew uninstall)
- Add global flags section to what-rtk-covers.md (-u/--ultra-compact,
-v/--verbose)
- Add rtk smart command to what-rtk-covers.md Files section
Agents:
- Update supported-agents.md: 10 agents (was 9)
- Add OpenClaw (TypeScript plugin, before_tool_call)
- Add Mistral Vibe (planned, issue #800 )
- Fix GitHub Copilot: VS Code = transparent rewrite via PreToolUse,
Copilot CLI = deny-with-suggestion (upstream limitation)
Signed-off-by: Florian BRUNIAUX <florian@bruniaux.com >
2026-04-06 11:16:24 +02:00
f5e7a41046
Merge branch 'develop' into feat/refac-doc
2026-04-06 10:15:32 +02:00
a94e9493b3
docs: consolidate to user-facing guide, remove duplicates and legacy flat docs
...
- Remove docs/reference/ (10 files): duplicates CONTRIBUTING.md, SECURITY.md,
ARCHITECTURE.md, src/*/README.md (distributed pattern from PR #869 )
- Remove docs/architecture/ (5 files): duplicates ARCHITECTURE.md ADRs and diagrams
- Remove docs/guide/commands/ (12 files): showed rtk <cmd> syntax users never type
(hooks rewrite transparently); content was derived from FEATURES.md
- Remove docs/guide/filters/ (2 files): contributor content, belongs with src/filters/
- Remove docs/guide/analytics/discover.md, economics.md: implementation details
- Remove legacy flat docs/ (6 files): FEATURES.md (FR), TECHNICAL.md, TROUBLESHOOTING.md,
AUDIT_GUIDE.md, tracking.md, filter-workflow.md — all superseded by guide/ rewrites
or codebase distributed docs
- Add docs/guide/what-rtk-covers.md: replaces 12 command pages with one user-facing
overview of 60+ commands by ecosystem, no rtk <cmd> syntax
- Enrich docs/guide/analytics/gain.md: absorb advanced workflows from AUDIT_GUIDE.md
(CI integration, pandas analysis, cron snapshots)
- Adapt docs/guide/getting-started/quick-start.md: remove rtk <cmd> examples,
explain hook transparency instead
- Update docs/README.md: single-tab contract, pointer to codebase for technical docs
- Update docs/guide/index.md: clean navigation matching final structure
- Add Mermaid diagrams to src/filters/README.md: build pipeline + filter lookup
(preserves content from filter-workflow.md in its natural home)
Result: 9 files in docs/guide/ (was 39), zero legacy flat docs, zero duplicates.
Codebase distributed docs (ARCHITECTURE.md, CONTRIBUTING.md, src/*/README.md)
remain the source of truth for technical and contributor content.
Signed-off-by: Florian BRUNIAUX <florian@bruniaux.com >
2026-04-05 21:26:07 +02:00
974db2ff0b
docs(phase-4): complete reference, architecture tabs and remaining commands
...
Guide — 10 new command and analytics pages:
- commands/go.md: go test (NDJSON), golangci-lint
- commands/ruby.md: rspec, rubocop, rake
- commands/dotnet.md: dotnet build/test, binlog, format
- commands/containers.md: docker ps/images/logs/compose, kubectl pods/services/logs
- commands/github-cli.md: gh pr/issue/run, Graphite gt commands
- commands/data.md: json, env, log, curl, wget, aws, psql, summary
- commands/utilities.md: proxy passthrough, global flags, RTK_DISABLED
- filters/creating-filters.md: TOML DSL guide, field reference, inline tests
- analytics/discover.md: rtk discover — missed savings analysis
- analytics/economics.md: rtk cc-economics — dollar savings vs ccusage
Reference tab (9 pages):
- contributing/guide.md: design philosophy, PR process, TOML vs Rust decision
- contributing/security.md: vulnerability reporting, dangerous patterns, dep criteria
- contributing/coding-standards.md: Rust rules, error handling, lazy_static, fallback pattern
- contributing/testing.md: snapshot tests, token accuracy, cross-platform, benchmarks
- internals/command-routing.md: 6-phase lifecycle, exit codes, verbosity, module map
- internals/filter-pipeline.md: 12 filtering strategies, TOML stages, savings by ecosystem
- internals/tracking-system.md: SQLite schema, data flow, token estimation, Tracker API
- internals/hook-engine.md: rewrite registry, compound commands, exit code contract, rtk init
- toml-dsl/specification.md: complete field reference, pipeline order, build compilation
Architecture tab (4 pages):
- diagrams/command-flow.md: end-to-end Mermaid — hook → RTK → LLM
- diagrams/filter-pipeline.md: build pipeline + 8-stage runtime Mermaid
- decisions/why-no-async.md: ADR — single-threaded, <10ms startup constraint
- decisions/proxy-architecture.md: ADR — why CLI proxy over aliases/LD_PRELOAD/hooks-only
All pages carry valid frontmatter (title, description, sidebar.order).
No existing files modified.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
Signed-off-by: Florian BRUNIAUX <florian@bruniaux.com >
2026-04-05 00:18:59 +02:00
25438b29ae
docs(guide): add 11 Phase 1 guide pages — full MVP content
...
Creates the complete user-facing guide for the docs website:
Getting started:
- quick-start.md: 5-minute walkthrough (init, first commands, rtk gain)
- supported-agents.md: Claude Code, Cursor, Copilot, Gemini, Cline, Windsurf,
Codex, OpenCode — integration tiers, install commands, graceful degradation
Commands (adapted from FEATURES.md, English, --help-first format):
- git.md: status/log/diff/show/add/commit/push/pull/branch + gh CLI
- cargo.md: test/nextest/build/check/clippy/install + generic test/err wrappers
- files.md: ls/read/grep/find/diff/wc/smart with before/after examples
- javascript.md: vitest/playwright/tsc/eslint/prettier/next/pnpm/npm/npx/prisma
- python.md: pytest/ruff/mypy/pip/deps
Reference:
- filters/using-filters.md: 8-stage pipeline, lookup priority, TOML DSL reference,
Mermaid diagram (adapted from docs/filter-workflow.md)
- analytics/gain.md: rtk gain flags, daily/weekly/monthly breakdowns, export
formats, token estimation, database management (from docs/AUDIT_GUIDE.md)
- configuration.md: full config.toml reference, env vars, tee system, telemetry
- troubleshooting.md: common issues and fixes (from docs/TROUBLESHOOTING.md)
All pages carry valid frontmatter (title, description, sidebar.order).
No existing files modified.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
Signed-off-by: Florian BRUNIAUX <florian@bruniaux.com >
2026-04-05 00:09:14 +02:00
9c9879c2da
docs: add interface contract and Phase 0 stubs for docs reorganization
...
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 >
2026-04-04 23:54:16 +02:00
e766ab2b2d
docs(telemetry): add dedicated TELEMETRY.md with full field reference
...
Comprehensive telemetry documentation covering:
- Why we collect (roadmap prioritization, filter quality, value measurement)
- How it works (daily ping, background thread, fire-and-forget)
- Every field with example values and purpose
- What is NOT collected (explicit exclusion list)
- Opt-out instructions
- Data handling and privacy guarantees
- Contributor guide for adding new fields
Link added from README.md privacy section.
Signed-off-by: Patrick szymkowiak <patrick.szymkowiak@innovtech.eu >
2026-04-03 14:01:29 +02:00
deda44f736
fix(docs): clean some docs + disclaimer
2026-04-02 21:33:38 +02:00
bae7930119
fix(review): PR #934
2026-03-31 20:43:59 +02:00
14265b48c3
Merge pull request #933 from rtk-ai/maintainers-apply-doc
...
fix(docs): add maintainers docs
2026-03-30 19:56:32 +02:00
Nicolas Le Cam