Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1621 commits
Select commit Hold shift + click to select a range
8771443
feat(rfc-0040): implement version_info() for toolchain version indire…
loonghao Apr 4, 2026
7383fbd
test(rfc-0040): add 49 version_info tests + update RFC checklist
loonghao Apr 4, 2026
8ea99c4
fix: handle JSON output in where command e2e tests
loonghao Apr 4, 2026
18ebc6c
fix(ci): handle skipped/cancelled jobs in CI Success gate
loonghao Apr 4, 2026
3a0e5c3
chore: release v0.8.19
github-actions[bot] Apr 5, 2026
61bb0cb
docs: enhance AI agent ecosystem with 15+ agent support (#749)
loonghao Apr 5, 2026
ba0a5ae
chore(deps): update rust crate zip to v8.5.0
renovate[bot] Apr 5, 2026
585a715
chore(deps): upgrade dependencies
loonghao Apr 5, 2026
a48f0bf
chore: release v0.8.20
github-actions[bot] Apr 5, 2026
0c60d1b
fix(vx-config): fix sha2 GenericArray LowerHex compile error
loonghao Apr 5, 2026
d148868
fix: resolve sha2 LowerHex compile errors and upgrade GitHub Actions
loonghao Apr 6, 2026
238af92
chore: regenerate workspace-hack (cargo-hakari)
github-actions[bot] Apr 6, 2026
4a6a892
chore(deps): update codecov/codecov-action action to v6 (#759)
renovate[bot] Apr 6, 2026
2ad976b
chore(deps): update actions/github-script action to v8 (#758)
renovate[bot] Apr 6, 2026
63cda20
chore(deps): update rust docker tag to v1.94.1 (#752)
renovate[bot] Apr 6, 2026
95f30f4
docs: optimize agent docs for v0.8.20 — add Copilot instructions, exp…
loonghao Apr 6, 2026
b48abe6
feat: propagate explicit version from bundled runtime to parent depen…
loonghao Apr 7, 2026
4891b84
fix: gracefully resolve numeric version hints for pure opaque providers
loonghao Apr 7, 2026
03df231
chore: release v0.8.21
github-actions[bot] Apr 7, 2026
c08347a
chore(deps): update docker/build-push-action action to v7
renovate[bot] Apr 6, 2026
81b54ad
chore(deps): update GitHub Actions and zip dependency
loonghao Apr 7, 2026
55610b3
Merge pull request #757 from loonghao/release-please--branches--main
loonghao Apr 7, 2026
5ce5495
chore(deps): update GitHub artifact actions and paths-filter
loonghao Apr 7, 2026
f1077a1
feat(providers): add tokei provider + triage stale issues
loonghao Apr 7, 2026
d07f795
chore: release v0.8.22
github-actions[bot] Apr 7, 2026
0287fff
fix(providers): fix download URL bugs in git, xmake, and ollama (#777)
loonghao Apr 8, 2026
d820327
chore: release v0.8.23
github-actions[bot] Apr 8, 2026
6c82dc5
chore(cli): remove obsolete switch and plugin commands
loonghao Apr 9, 2026
90f011f
fix(deps): update rust crate hashbrown-986da7b5efc2b80e to 0.17
renovate[bot] Apr 9, 2026
c954070
chore: regenerate workspace-hack (cargo-hakari)
github-actions[bot] Apr 9, 2026
0085259
refactor(providers): simplify providers to use standard templates
loonghao Apr 9, 2026
a484a8b
feat(providers): add cargo-nextest and cargo-deny providers
loonghao Apr 9, 2026
dc2734a
feat(providers): add cargo-audit provider
loonghao Apr 9, 2026
434c8d7
test(providers): add Starlark logic tests for cargo-nextest, cargo-de…
loonghao Apr 9, 2026
7ebf3e7
fix(console): use eprintln for progress output to avoid stdout contam…
loonghao Apr 9, 2026
9f84f52
test(providers): add Starlark logic tests for 32 providers without te…
loonghao Apr 9, 2026
58d88e8
fix(docs): fix broken doctests in vx-console and vx-starlark
loonghao Apr 9, 2026
d1825fb
chore: regenerate workspace-hack (cargo-hakari)
github-actions[bot] Apr 9, 2026
5069772
fix(tests): fix 14 failing tests across multiple crates
loonghao Apr 9, 2026
1cefc75
feat(routing): prefer dedicated provider over cargo install for ecosy…
loonghao Apr 9, 2026
e7ccfb4
feat(ecosystem_aliases): route ecosystem:package to dedicated provide…
loonghao Apr 9, 2026
d89bc38
fix(cleanup): fix compile errors from ecosystem_aliases feature
loonghao Apr 9, 2026
66555ed
fix(providers): fix download URLs for cargo-audit, cargo-nextest, and…
loonghao Apr 9, 2026
48a1a87
fix(cargo-audit): remove unused rust_triple import (lint)
loonghao Apr 9, 2026
cac6461
style: apply rustfmt to all modified Rust files
loonghao Apr 9, 2026
b27e97c
style: apply rustfmt to vx-resolver
loonghao Apr 9, 2026
86186d9
fix(providers): fix cargo-nextest macOS triple and cargo-audit test a…
loonghao Apr 9, 2026
eea4d7e
fix(providers): add fetch_versions_with_tag_prefix to layout mock + f…
loonghao Apr 9, 2026
aaae704
fix(tests): fix cargo-deny Windows URL test and add missing provider …
loonghao Apr 9, 2026
3ffd6af
docs(cleanup): sync provider count from 105 to 111 across all docs
loonghao Apr 9, 2026
ea33834
feat(providers): add kind and k3d providers
loonghao Apr 9, 2026
906d97e
feat(providers): add grpcurl provider + update provider count to 114
loonghao Apr 9, 2026
2d0bf9a
style: apply rustfmt to remaining provider test files
loonghao Apr 9, 2026
7c6b62a
chore: release v0.8.24
github-actions[bot] Apr 9, 2026
ebfc002
chore(deps): update rust crate indexmap to v2.14.0
renovate[bot] Apr 9, 2026
0680db4
chore: regenerate workspace-hack (cargo-hakari)
github-actions[bot] Apr 9, 2026
a8e3f55
chore(deps): update actions/github-script action to v9
renovate[bot] Apr 10, 2026
f208ef5
fix: git Windows exe path, rust bundled store mismatch, lock multi-pl…
loonghao Apr 10, 2026
0effcb8
chore: release v0.8.25
github-actions[bot] Apr 10, 2026
d934ad1
Merge pull request #782 from loonghao/renovate/hashbrown-986da7b5efc2…
loonghao Apr 11, 2026
0cab93c
fix: wire Starlark post_extract hooks into ManifestDrivenRuntime and …
Apr 13, 2026
e47d36b
fix: correct cmake macOS download URL and jq environment key
Apr 13, 2026
108e290
fix: correct download URLs for grpcurl, k3d, kind, and duckdb providers
Apr 13, 2026
4c1b86a
chore: release v0.8.26
github-actions[bot] Apr 13, 2026
2797ede
feat(auto-improve): squash merge auto-improve branch
loonghao Apr 10, 2026
d62adba
fix(installer): fix PortableGit .7z.exe not recognized as archive + s…
loonghao Apr 10, 2026
c6938cf
fix(providers): fix 5 provider bugs from auto-improve branch
loonghao Apr 10, 2026
88874cd
fix(providers): fix 5 more provider bugs (round 2) + add tar.bz2 support
loonghao Apr 10, 2026
5a3d826
chore: regenerate workspace-hack (cargo-hakari)
github-actions[bot] Apr 10, 2026
5909e44
ci: add [skip ci] to workspace-hack auto-commit to prevent CI loop
loonghao Apr 11, 2026
06de260
chore(dev): add pre-push git hook to auto-regenerate workspace-hack
loonghao Apr 11, 2026
83d239b
fix(resolver): stop re-installing system-managed runtimes on every vx…
loonghao Apr 11, 2026
988858c
fix(rust): stop re-installing rust on every vx cargo invocation
loonghao Apr 11, 2026
f198597
test(rust): add platform_install_dir to mock ctx in environment tests
loonghao Apr 11, 2026
b5faab4
test(providers): fix incorrect download URL assertions in grpcurl/k3d…
loonghao Apr 11, 2026
3bcc0ec
fix: resolve CI failures for lefthook, grpcurl, and kustomize providers
loonghao Apr 11, 2026
4a07643
fix(providers): fix binary rename, grpcurl macOS, duckdb macOS, nerdc…
loonghao Apr 11, 2026
925d6d5
fix(installer): apply binary rename fix to RealInstaller.download_wit…
loonghao Apr 11, 2026
19237c4
fix(engine): ctx.install_dir now points to actual install location
loonghao Apr 12, 2026
c80f726
fix: remove platform subdir from install path, fix providers
loonghao Apr 12, 2026
7b65a63
fix(uv): route uvx through uv tool run
loonghao Apr 14, 2026
821e779
fix(runtime): preserve bundled command prefixes
loonghao Apr 14, 2026
7c917ef
fix(provider): correct grpcurl version check
loonghao Apr 14, 2026
099ff92
fix(resolver): resolve bundled runtime fallback executable
loonghao Apr 14, 2026
574c8ff
fix(paths): detect unified runtime store versions
loonghao Apr 14, 2026
a1984e2
fix(provider): use gnu rustup triples on linux
loonghao Apr 14, 2026
5c9684f
fix(tests): resolve latest unit test failures
loonghao Apr 14, 2026
e9ca00d
style: apply rustfmt fixes for CI
loonghao Apr 14, 2026
51dc8f4
fix(runtime): satisfy clippy collapsible-if lint
loonghao Apr 14, 2026
2181458
Merge branch 'main' into release-please--branches--main
Apr 14, 2026
69a0252
chore: regenerate workspace-hack (cargo-hakari) [skip ci]
github-actions[bot] Apr 14, 2026
d8676a2
Merge pull request #791 from loonghao/release-please--branches--main
loonghao Apr 14, 2026
deab703
fix: resolve merge conflict in release manifest
Apr 14, 2026
8fcebce
chore: release v0.8.26
github-actions[bot] Apr 14, 2026
ba69f04
feat: add vx-output-filter crate for compact subprocess output (#802)
loonghao Apr 14, 2026
9c53c07
chore: release v0.8.27
github-actions[bot] Apr 14, 2026
876731f
feat: add FilterLevel enum (Light/Normal/Aggressive) for compact outp…
loonghao Apr 15, 2026
c7f2f77
chore: release v0.8.28
github-actions[bot] Apr 15, 2026
344e043
fix(ci): switch apt mirror to azure.archive.ubuntu.com for cross builds
loonghao Apr 16, 2026
ad35e5c
chore: regenerate workspace-hack (cargo-hakari) [skip ci]
loonghao Apr 16, 2026
cc46de7
feat: change non-TTY default output from JSON to Toon, disable CDN by…
loonghao Apr 16, 2026
c95f733
fix(docker): switch apt mirror to azure.archive.ubuntu.com in Dockerf…
loonghao Apr 16, 2026
da6405d
fix: git uses MinGit ZIP on Windows, rust toolchain defaults to stable
loonghao Apr 16, 2026
6fdb340
test(git): update starlark tests to expect MinGit ZIP instead of Port…
loonghao Apr 16, 2026
1fc4be3
chore: release v0.8.29
github-actions[bot] Apr 16, 2026
1889cf4
refactor: unify progress bars and restructure docs progressively (#812)
loonghao Apr 17, 2026
9f8d931
chore(deps): update rust crate rustls-webpki to v0.103.12 [security]
renovate[bot] Apr 17, 2026
d5d47b9
chore: release v0.8.30
github-actions[bot] Apr 17, 2026
c391912
feat(cli): overhaul vx add/remove with format-preserving edits
loonghao Apr 18, 2026
2eafe04
style: apply rustfmt to project_context test
loonghao Apr 18, 2026
6077ad9
style(console): satisfy stable rustfmt on complete_tool bar messages
loonghao Apr 18, 2026
b20268b
chore: release v0.8.31
github-actions[bot] Apr 18, 2026
4205cd9
chore(deps): batch update Renovate dependencies and actions
loonghao Apr 24, 2026
be63719
feat(providers): add conda provider with micromamba, conda and mamba
Feb 24, 2026
c753951
feat(cli): bridge global install commands to vx package shims
loonghao Apr 25, 2026
2d6f0a8
docs(agent): add cross-language global install contract and fix RFC l…
loonghao Apr 25, 2026
98131e4
feat(cli): enable direct global command shims in vx bin dir
loonghao Apr 25, 2026
f751e69
test(cli): add e2e coverage for where and direct vite shim
loonghao Apr 25, 2026
363d986
test(cli): stabilize shim e2e and add local coverage tests
loonghao Apr 25, 2026
0d7ecf2
Merge pull request #829 from loonghao/codex/feat-global-npm-shims
loonghao Apr 25, 2026
08a335d
chore: release v0.8.32
github-actions[bot] Apr 25, 2026
f042114
perf: add cargo build optimization agent rule
loonghao Apr 26, 2026
af082f7
perf: optimize workspace compilation settings
loonghao Apr 26, 2026
f62621f
chore: regenerate workspace-hack (cargo-hakari) [skip ci]
loonghao Apr 26, 2026
82294c3
docs: update cargo-build-optimization agent rule with implemented opt…
loonghao Apr 26, 2026
159a4c8
chore(deps-dev): bump postcss from 8.5.6 to 8.5.10 in /docs
dependabot[bot] Apr 25, 2026
868ae54
chore(deps): update rust crate libc to v0.2.186
renovate[bot] Apr 24, 2026
b0b5409
chore(deps): update ubuntu docker tag to v26
renovate[bot] Apr 24, 2026
1a797ab
chore(deps): bump rustls-webpki from 0.103.12 to 0.103.13
dependabot[bot] Apr 24, 2026
00d17ec
chore(deps): update googleapis/release-please-action action to v5
renovate[bot] Apr 29, 2026
f37456c
chore: regenerate workspace-hack (cargo-hakari) [skip ci]
github-actions[bot] Apr 29, 2026
3094821
docs: update version to 0.8.32 and provider count to 129
loonghao Apr 29, 2026
19b2509
chore: regenerate workspace-hack (cargo-hakari) [skip ci]
loonghao Apr 29, 2026
82b6a24
docs: update provider count to 129 in AGENTS.md
loonghao Apr 29, 2026
80d1427
docs: update tools overview and quality documentation
loonghao Apr 30, 2026
d91989e
refactor: merge vx-core into vx-runtime-core
loonghao Apr 30, 2026
ea32135
chore: release v0.8.33
github-actions[bot] Apr 30, 2026
208851c
Merge pull request #833 from loonghao/release-please--branches--main
loonghao Apr 30, 2026
f048f10
feat: add age and sops providers, update project analyzer frameworks
loonghao Apr 30, 2026
5f11183
chore: regenerate workspace-hack (cargo-hakari) [skip ci]
loonghao Apr 30, 2026
ea47fd0
docs: update provider count to 131 in AGENTS.md
loonghao Apr 30, 2026
9f8dff3
docs: add age and sops to tools overview and CHANGELOG
loonghao Apr 30, 2026
d63fca6
chore(deps): update googleapis/release-please-action to v5
loonghao Apr 30, 2026
4ac74a6
refactor(provider): conda use provider.star only (remove Rust code)
loonghao Apr 30, 2026
94f1aec
feat(providers): add conda provider with micromamba, conda and mamba
loonghao Apr 30, 2026
025c682
docs: update provider count from 129/131 to 132 across all documentation
loonghao May 1, 2026
499d830
Merge pull request #840 from loonghao/docs-update-20260501
loonghao May 1, 2026
102d59a
docs: update provider count to 132 and add conda/micromamba/mamba to …
loonghao May 2, 2026
eef8af6
Merge pull request #841 from loonghao/docs-update-20260502
loonghao May 2, 2026
79c179d
feat: add worktrunk provider (132 tools total) (#839)
loonghao May 2, 2026
e736c47
docs: update provider count from 132/135 to 136 across all docs
loonghao May 3, 2026
5dc335c
Merge pull request #846 from loonghao/docs-update-20260503
loonghao May 3, 2026
3cad3c9
fix(providers): correct install_layout strip_prefix and download_url
loonghao May 2, 2026
97d0890
fix(all): comprehensive CI fixes and Rust 1.95.0 upgrade (#843)
loonghao May 3, 2026
0dce74b
chore: release v0.8.34
github-actions[bot] May 3, 2026
7259bc6
fix(ci): ensure Release workflow triggers even when release is create…
loonghao May 3, 2026
0dbed26
chore: regenerate workspace-hack (cargo-hakari) [skip ci]
loonghao May 3, 2026
fde7e66
chore(deps): update actions/checkout action to v6
renovate[bot] May 3, 2026
c5f1fb1
chore: release v0.8.35
github-actions[bot] May 3, 2026
fddf63a
docs: update version to v0.8.35 and provider count to 136
loonghao May 4, 2026
394b9af
chore: regenerate workspace-hack (cargo-hakari) [skip ci]
loonghao May 4, 2026
70f2615
Merge pull request #850 from loonghao/docs-update-20260504
loonghao May 4, 2026
4599d8c
feat: add self-update check with non-blocking notification
loonghao May 4, 2026
fcf373a
fix(cli): send update notifications to stderr
loonghao May 4, 2026
75b696b
feat(cli): add update channel support (stable, beta, dev)
loonghao May 4, 2026
0cac2ed
fix(cli): fix formatting issues (run cargo fmt)
loonghao May 4, 2026
20f4cd7
fix(cli): fix Clippy warnings and test compilation errors
loonghao May 4, 2026
58d35be
fix(cli): remove debug print from lib.rs
loonghao May 4, 2026
81e82e0
fix: make env-dependent tests serial to prevent race conditions
loonghao May 4, 2026
e89aefe
chore: regenerate workspace-hack (cargo-hakari) [skip ci]
loonghao May 4, 2026
a4bdd68
chore: release v0.8.36
github-actions[bot] May 4, 2026
ebd928b
docs: update version to v0.8.36 and provider count to 136
loonghao May 5, 2026
e2cea73
chore: regenerate workspace-hack (cargo-hakari) [skip ci]
loonghao May 5, 2026
f973ff0
Merge pull request #854 from loonghao/docs-update-v0.8.36
loonghao May 5, 2026
e74d708
feat: add witr provider (137 providers total)
loonghao May 5, 2026
8afd778
docs: update provider count to 137 (add witr)
loonghao May 5, 2026
4479958
docs: simplify AI agent configs, add vx wt/witr examples
loonghao May 5, 2026
358ca9f
docs: add more tool examples to AGENTS.md
loonghao May 5, 2026
ef0d871
fix: remove unused variables in witr/provider.star
loonghao May 5, 2026
b6683e1
fix(witr): correct version pattern and binary path in provider.star
loonghao May 5, 2026
293a4f5
fix: use system_install for ffmpeg Linux, fix witr install_layout
loonghao May 5, 2026
b37b591
fix(witr): use 'binary' type for direct binaries (Linux/macOS)
loonghao May 5, 2026
dcd08cc
fix(witr): rewrite provider without template to handle direct binarie…
loonghao May 5, 2026
10a7a50
fix: ffmpeg use Gyan.dev mirror, witr only override download_url
loonghao May 5, 2026
6bf7bbd
fix(witr): override install_layout with correct type
loonghao May 5, 2026
b287fe5
fix(witr): correct __type__ key in install_layout (double underscores)
loonghao May 5, 2026
1f8780a
fix(ffmpeg): use system_install only (remove unreliable GitHub downlo…
loonghao May 5, 2026
ac4dc6a
fix(providers): use vx-org/mirrors for ffmpeg and witr downloads
loonghao May 5, 2026
77d741c
fix(ffmpeg): use vx-org/mirrors with BtbN static builds (win64+linux6…
loonghao May 5, 2026
075a973
docs: update provider count 136 -> 137 (add witr) (#859)
loonghao May 7, 2026
19c656d
docs: add complete Supported Tools section to llms-full.txt
loonghao May 8, 2026
4a11abe
docs: update media.md and witr.md with vx-org/mirrors download source…
loonghao May 9, 2026
c60f84d
docs: update provider count from 136 to 137 across documentation (#865)
loonghao May 10, 2026
779b15c
docs: fix syntax errors in other.md and quality.md (#866)
loonghao May 11, 2026
abf8fbc
docs: optimize AGENTS.md as progressive disclosure map (#868)
loonghao May 12, 2026
c0e1470
docs: add critical rules section to AGENTS.md for AI agents (#869)
loonghao May 13, 2026
3c0fac2
docs: fix duplicate Critical Rules sections in AGENTS.md (#870)
loonghao May 14, 2026
080ba61
chore(deps): update rust crate assert_cmd to v2.2.2
renovate[bot] May 11, 2026
e8e85d0
docs: update Rust version requirement to 1.93+ (Edition 2024) in cont…
May 15, 2026
160dcdd
Merge pull request #872 from loonghao/docs-update-20260515
loonghao May 15, 2026
6fecbd6
docs: add latest RFCs (0037, 0039, 0040) to llms-full.txt (#873)
loonghao May 16, 2026
39b4c71
docs: update outdated version numbers in README.md (#874)
loonghao May 17, 2026
843f734
docs: update Rust version to 1.95.0+ and fix RFC count (#875)
loonghao May 18, 2026
585353e
fix: handle rust toolchain versions in path selection
loonghao May 18, 2026
a400f57
fix: correct RFC count (40+ -> 50+) and update Rust version badge (1.…
loonghao May 19, 2026
89b2cf7
chore(deps): update rust crate toon-format to v0.4.6
renovate[bot] May 19, 2026
c9d42ff
chore(deps): update rust crate winnow to v1.0.3
renovate[bot] May 18, 2026
c8c413e
docs: add self-update command documentation with channel support
loonghao May 20, 2026
721a00b
docs: add worktrunk (wt) tool documentation
loonghao May 20, 2026
137941f
Merge pull request #882 from loonghao/docs-update-20260520
loonghao May 20, 2026
9764a63
ci: optimize workflow caching and setup
May 19, 2026
03a28a2
fix(providers): correct mirror tag version fetching
May 19, 2026
bb66208
ci: skip miniforge runtimes in provider e2e
May 19, 2026
e4457a9
fix: skip broken micromamba windows release
May 20, 2026
1a01df2
fix: filter vault releases by platform artifacts
May 20, 2026
34c5030
chore: release v0.8.37
github-actions[bot] May 20, 2026
4a323eb
docs: update version to v0.8.37 in AGENTS.md and README.md
loonghao May 21, 2026
5b41c35
chore: regenerate workspace-hack (cargo-hakari) [skip ci]
loonghao May 21, 2026
149b0ba
Merge pull request #885 from loonghao/docs-update-20260521
loonghao May 21, 2026
33cdcf7
chore(deps): update rust crate either to v1.16.0
renovate[bot] May 20, 2026
b8cf5ac
docs: add missing tools (actrun, ctlptl, gws) to documentation
loonghao May 22, 2026
da73262
Merge pull request #887 from loonghao/docs-update-20260522
loonghao May 22, 2026
bb6b292
fix: avoid msvc repair for unrelated commands
loonghao May 22, 2026
39916d2
test: cover broken msvc companion preparation
loonghao May 22, 2026
c18fa9b
docs: fix dead links in docs build
loonghao May 22, 2026
bb23093
fix(deps): update rust crate toon-format to 0.5
renovate[bot] May 22, 2026
07e4271
chore(deps): update rust crate serde_json to v1.0.150
renovate[bot] May 21, 2026
062aa5d
chore: release v0.8.38
github-actions[bot] May 22, 2026
82c274b
fix(deps): update rust crate starlark_derive to 0.14
renovate[bot] May 22, 2026
b7bb865
chore: release v0.8.39
github-actions[bot] May 22, 2026
bb0d11e
docs: update version to v0.8.39 in AGENTS.md and README.md
loonghao May 24, 2026
f74b193
chore: regenerate workspace-hack (cargo-hakari) [skip ci]
loonghao May 24, 2026
d0c622b
Merge pull request #895 from loonghao/docs-update-20260524
loonghao May 24, 2026
f0a0fb3
feat: track output token savings
loonghao May 24, 2026
970b025
chore: release v0.9.0
github-actions[bot] May 24, 2026
e62080b
fix: harden release-please and add mcpcall
loonghao May 24, 2026
05c35f1
fix: correct metrics calculations
loonghao May 24, 2026
63e190a
fix: repair vx store executable permissions
loonghao May 24, 2026
0b33913
fix: serialize runtime installs
loonghao May 24, 2026
81cf635
test: bound external command runtimes
loonghao May 24, 2026
52cb86c
test: guard tool e2e hangs
loonghao May 24, 2026
5666866
test: stabilize windows tool e2e
loonghao May 24, 2026
ceedd5c
chore: release v0.9.1
github-actions[bot] May 25, 2026
caa7afd
feat: add rust wasm providers
loonghao May 25, 2026
ccb8136
chore: release v0.9.2
github-actions[bot] May 25, 2026
4e5f011
feat: add python 3.7 and wasm runtimes
loonghao May 25, 2026
310bdbf
chore: release v0.9.3
github-actions[bot] May 25, 2026
ef82a93
fix: prepend node_modules/.bin to PATH for npm/npx execution (#906)
loonghao May 25, 2026
23373c8
chore(deps): update rust crate reqwest to v0.13.4
renovate[bot] May 25, 2026
43677ef
chore: regenerate workspace-hack (cargo-hakari) [skip ci]
github-actions[bot] May 25, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
557 changes: 557 additions & 0 deletions .agents/skills/vx-best-practices/SKILL.md

Large diffs are not rendered by default.

209 changes: 209 additions & 0 deletions .agents/skills/vx-commands/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,209 @@
---
name: vx-commands
description: "Complete vx CLI command reference. Use when looking up specific vx command syntax, flags, or output formats. All commands support --json for structured output and --output-format toon for token-optimized output."
---

# VX Command Reference

> **Quick rule**: All vx commands support `--json` for structured output and `--output-format toon` for token-optimized output (saves 40-60% tokens). Set `VX_OUTPUT=json` to default all commands to JSON.

## Structured Output Commands (AI-Optimized)

All commands support `--json` for structured output and `--output-format toon` for token-optimized output (saves 40-60% tokens).

### Project Analysis

```bash
vx analyze --json # Analyze project structure
vx check --json # Verify tool constraints
vx ai context --json # Generate AI-friendly project context
```

**Output fields (analyze)**:
- `ecosystems[]` - Detected ecosystems (nodejs, python, rust, go)
- `dependencies[]` - Project dependencies
- `scripts[]` - Available scripts
- `required_tools[]` - Tools needed

**Output fields (check)**:
- `requirements[]` - Tool requirement status
- `all_satisfied` - Whether all constraints are met
- `missing_tools[]` - Tools that need installation

**Output fields (ai context)**:
- `project` - Project info (name, languages, frameworks)
- `tools[]` - Installed tools with versions
- `scripts[]` - Available scripts
- `constraints[]` - Tool constraints

### Tool Management

```bash
vx list --json # List installed tools
vx versions node --json # List available versions
vx which node --json # Find tool location
vx search <query> --json # Search for tools
```

**Output fields (list)**:
- `runtimes[]` - Available runtimes
- `total` - Total count
- `installed_count` - Installed count

**Output fields (versions)**:
- `versions[]` - Available versions with metadata
- `latest` - Latest version
- `lts` - LTS version (if applicable)

**Output fields (which)**:
- `path` - Executable path
- `version` - Resolved version
- `source` - Source (vx, system, global_package)

### Installation

```bash
vx install node@22 --json # Install tool
vx sync --json # Sync from vx.toml
```

**Output fields (install)**:
- `runtime` - Tool name
- `version` - Installed version
- `path` - Installation path
- `duration_ms` - Installation duration
- `dependencies_installed[]` - Dependencies also installed

**Output fields (sync)**:
- `installed[]` - Successfully installed
- `skipped[]` - Skipped (already installed)
- `failed[]` - Failed installations
- `duration_ms` - Total duration

### AI Integration

```bash
vx ai context # Generate AI-friendly context (Markdown)
vx ai context --json # JSON format
vx ai context --minimal # Minimal output
vx ai session init # Initialize session state
vx ai session status # Show session status
vx ai session cleanup # Clean up session
```

### Environment

```bash
vx env --json # Show environment variables
vx dev --export # Export shell environment
```

## Output Formats

### JSON Format
```bash
vx list --json
# Output: {"runtimes": [...], "total": 50, "installed_count": 5}
```

### TOON Format (Token-Optimized)
```bash
vx list --output-format toon
# Output:
# runtimes[50]{name,installed,description}:
# node,true,Node.js runtime
# python,false,Python runtime
# ...
```

TOON format is recommended for AI agents - it saves 40-60% tokens compared to JSON.

### Environment Variable
```bash
export VX_OUTPUT=json # Default to JSON output
export VX_OUTPUT=toon # Default to TOON output
```

## Command Groups

### Tool Execution
```bash
vx <tool> [args...] # Run any tool
vx npm install # Run npm
vx cargo build # Run cargo
```

### Advanced Execution Syntax
```bash
# Runtime with version
vx node@22 app.js # Use specific Node.js version

# Runtime executable override
vx msvc@14.42::cl main.cpp # Run cl from MSVC runtime

# Package execution (ecosystem:package pattern)
vx npm:vite # Run vite via npm
vx uv:ruff check . # Run ruff via uv
vx npm:typescript@5.0::tsc # Run tsc from specific typescript version

# Package aliases (shortcuts)
vx vite # Same as: vx npm:vite
vx meson # Same as: vx uv:meson

# Multi-runtime composition
vx --with bun@1.1 --with deno node app.js # Multiple runtimes in PATH
```

### Tool Management
```bash
vx install <tool>@<version> # Install tool
vx uninstall <tool> # Uninstall tool
vx list # List tools
vx versions <tool> # Show versions
vx which <tool> # Find tool path
vx switch <tool>@<version> # Switch version
```

### Project Management
```bash
vx init # Initialize vx.toml
vx add <tool> # Add tool to project
vx remove <tool> # Remove tool from project
vx sync # Sync tools from vx.toml
vx lock # Generate vx.lock
vx check # Check constraints
```

### Script Execution
```bash
vx run <script> # Run script from vx.toml
vx run --list # List available scripts
```

### Cache Management
```bash
vx cache dir # Show cache directory
vx cache clean # Clean cache
```

## Global Flags

```bash
--json # JSON output
--output-format <text|json|toon> # Output format
--verbose # Verbose output
--debug # Debug output
--use-system-path # Use system PATH
--cache-mode <mode> # Cache mode (normal, refresh, offline, no-cache)
```

## Exit Codes

- `0` - Success
- `1` - General error
- `2` - Tool not found
- `3` - Installation failed
- `4` - Version not found
- `5` - Network error
- `6` - Permission error
- `7` - Configuration error
Loading