Repository navigation
v0.7.0
Experiments
tricks experiment replaces edit, use and merge. An experiment is one skill on its own branch, experiment/<skill>/<name>, checked out in .tricks/work/.
tricks experiment start changelog-writer@terse # prints the skill's path in the worktree
tricks link changelog-writer@terse --to ~/code/my-app # this project's agents load it, live
tricks experiment commit changelog-writer@terse -m "Terser output"
tricks experiment merge changelog-writer@terse # or --pr; also: list, discard, shellmerge is a normal git merge --no-ff of the whole branch, then removes the branch and worktree (--keep to keep them). --pr pushes the branch and opens a pull request; run it again to push review fixes. use, tricks.work.toml, draft/<skill> and skill-only merges (--whole-branch) are gone.
What a link deploys
link <skill>: the skill in your main checkout as it is, whatever branch is checked out, uncommitted edits included. Links no longer stay on the committed version duringtricks update.link <skill>@<experiment|branch>: that branch's checkout, live. A branch that isn't checked out anywhere gets a worktree in.tricks/work/, removed with its last link.link <skill>@<tag|commit>: a frozen snapshot in the store.
Also
- Git commands that change your repositories are printed on stderr as
$ git …(-vfor all of them,-qor--jsonfor none). unlinkanduntrywithout a skill (or with--all), andexperiment discardwhen it would lose work, ask for confirmation (--yesto skip).- Agents are detected on first run and written to your user config. At user scope a skill goes into the fewest agent directories that reach all of them, so no agent loads it twice.
create -b <branch>andvendor -b <branch>switch the source repo to a branch first.search --sort relevance|installs|stars|updated|name,--min-installs,--min-stars, and--facetsto see how matches spread over categories, catalogs, owners, licences and trust.- "User scope" replaces "user level" throughout;
--globalis unchanged. - VS Code extension: Start, Commit, Merge and Discard Experiment, and Open Experiment Folder.
Docs: https://new-tricks.github.io/tricks/concepts/experiments/
Full Changelog: v0.6.0...v0.7.0