Skip to content

v0.7.0

Choose a tag to compare

@github-actions github-actions released this 27 Sep 18:43
· 6 commits to main since this release

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, shell

merge 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 during tricks 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 … (-v for all of them, -q or --json for none).
  • unlink and untry without a skill (or with --all), and experiment discard when it would lose work, ask for confirmation (--yes to 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> and vendor -b <branch> switch the source repo to a branch first.
  • search --sort relevance|installs|stars|updated|name, --min-installs, --min-stars, and --facets to see how matches spread over categories, catalogs, owners, licences and trust.
  • "User scope" replaces "user level" throughout; --global is 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