tricks experiment
Experiment with a skill on its own branch and worktree: start, commit, merge or discard
tricks experiment [OPTIONS] <COMMAND>Subcommands
Section titled “Subcommands”| Command | Description |
|---|---|
start |
Start (or pick up) an experiment: branch experiment/<skill>/<name> in .tricks/work/; prints the skill’s path there |
list |
Experiments and their state: unmerged commits, uncommitted changes, links, pull request |
commit |
Commit everything changed in an experiment, on its branch |
merge |
Merge the whole experiment into the current branch, then remove its branch and worktree |
discard |
Throw an experiment away: its worktree and branch (links pinned to it follow the main checkout) |
shell |
Open a shell in an experiment (exit returns) |
tricks experiment start
Section titled “tricks experiment start”Start (or pick up) an experiment: branch experiment/<skill>/<name> in .tricks/work/; prints the skill’s path there
tricks experiment start [OPTIONS] <SKILL@NAME>Arguments
| Argument | Description |
|---|---|
<SKILL@NAME> |
<skill>@<name> |
Options
| Option | Description |
|---|---|
--shell |
Open a shell there (exit returns); or cd "$(tricks experiment start <skill>@<name>)" |
tricks experiment list
Section titled “tricks experiment list”Experiments and their state: unmerged commits, uncommitted changes, links, pull request
tricks experiment list [OPTIONS] [SKILL]Arguments
| Argument | Description |
|---|---|
[SKILL] |
Only this skill’s |
tricks experiment commit
Section titled “tricks experiment commit”Commit everything changed in an experiment, on its branch
tricks experiment commit [OPTIONS] --message <MESSAGE> [SKILL@NAME]Arguments
| Argument | Description |
|---|---|
[SKILL@NAME] |
<skill>@<name> (default: the experiment you are in) |
Options
| Option | Description |
|---|---|
-m, --message <MESSAGE> |
Commit message |
tricks experiment merge
Section titled “tricks experiment merge”Merge the whole experiment into the current branch, then remove its branch and worktree
tricks experiment merge [OPTIONS] [SKILL@NAME]Arguments
| Argument | Description |
|---|---|
[SKILL@NAME] |
<skill>@<name> (default: the experiment you are in) |
Options
| Option | Description |
|---|---|
--pr |
Push it and open (or update) a pull request instead; the worktree stays for review fixes |
--keep |
Keep the branch and worktree after merging |
-m, --message <MESSAGE> |
Merge commit (or pull request title) message |
tricks experiment discard
Section titled “tricks experiment discard”Throw an experiment away: its worktree and branch (links pinned to it follow the main checkout)
tricks experiment discard [OPTIONS] [SKILL@NAME]Arguments
| Argument | Description |
|---|---|
[SKILL@NAME] |
<skill>@<name> (default: the experiment you are in) |
tricks experiment shell
Section titled “tricks experiment shell”Open a shell in an experiment (exit returns)
tricks experiment shell [OPTIONS] [SKILL@NAME]Arguments
| Argument | Description |
|---|---|
[SKILL@NAME] |
<skill>@<name> (default: the experiment you are in) |
Also takes the global options. Group: Work on skills. See experiments.