Adding more of the graphite workflows primarily the ones specific to

elvis kahoro · elvis kahoro · commit 2511bd205f87 · 2023-02-27T18:49:35.000-05:00
branches
diff --git a/specs/graphite/a no param copy.yaml b/specs/graphite/a no param copy.yaml
@@ -0,0 +1,11 @@
+---
+name: Graphite - Authorize the Graphite CLI
+command: "gt auth"
+tags:
+  - graphite
+description: "Add your auth token to enable Graphite CLI to create and update your PRs on GitHub."
+arguments: []
+source_url: "https://graphite.dev/docs/graphite-cheatsheet"
+author: graphite
+author_url: "https://graphite.dev/"
+shells: []
diff --git a/specs/graphite/gt_auth.yaml b/specs/graphite/gt_auth.yaml
@@ -0,0 +1,11 @@
+---
+name: Graphite - Authorize the Graphite CLI
+command: "gt auth"
+tags:
+  - graphite
+description: "Add your auth token to enable Graphite CLI to create and update your PRs on GitHub."
+arguments: []
+source_url: "https://graphite.dev/docs/command-reference"
+author: graphite
+author_url: "https://graphite.dev/"
+shells: []
diff --git a/specs/graphite/gt_branch_bottom.yaml b/specs/graphite/gt_branch_bottom.yaml
@@ -0,0 +1,11 @@
+---
+name: Graphite - Jump to the bottom of the stack
+command: "gt branch bottom"
+tags:
+  - graphite
+description: "Alias `bb`. Quickly move all the way down (bb) the stack"
+arguments: []
+source_url: "https://graphite.dev/docs/command-reference"
+author: graphite
+author_url: "https://graphite.dev/"
+shells: []
diff --git a/specs/graphite/gt_branch_checkout.yaml b/specs/graphite/gt_branch_checkout.yaml
@@ -3,12 +3,12 @@ name: Graphite - Checkout a branch
 command: "gt bco {{branch_name}}"
 tags:
   - graphite
-description: "Switch to or checkout a branch. Similar to `git checkout <branch_name>`"
+description: "Alias `bco`. Switch to or checkout a branch. Similar to `git checkout <branch_name>`"
 arguments:
   - name: branch_name
     description: The name of the branch that you want to checkout
     default_value: main
-source_url: "https://graphite.dev/docs/graphite-cheatsheet"
+source_url: "https://graphite.dev/docs/command-reference"
 author: graphite
 author_url: "https://graphite.dev/"
 shells: []
diff --git a/specs/graphite/gt_branch_create.yaml b/specs/graphite/gt_branch_create.yaml
@@ -4,7 +4,7 @@ command: "gt branch create"
 tags:
   - graphite
 description: "Alias: `bc`. Create a new branch stacked on top of the current branch and commit staged changes. If no branch name is specified but a commit message is passed, generate a branch name from the commit message."
-source_url: "https://graphite.dev/docs/graphite-cheatsheet"
+source_url: "https://graphite.dev/docs/command-reference"
 author: graphite
 author_url: "https://graphite.dev/"
 shells: []
diff --git a/specs/graphite/gt_branch_delete.yaml b/specs/graphite/gt_branch_delete.yaml
@@ -4,7 +4,7 @@ command: "gt branch delete"
 tags:
   - graphite
 description: "Alias: `bdl`. Delete a branch and its corresponding Graphite metadata."
-source_url: "https://graphite.dev/docs/graphite-cheatsheet"
+source_url: "https://graphite.dev/docs/command-reference"
 author: graphite
 author_url: "https://graphite.dev/"
 shells: []
diff --git a/specs/graphite/gt_branch_down.yaml b/specs/graphite/gt_branch_down.yaml
@@ -3,12 +3,12 @@ name: Graphite - Move down the stack of branches
 command: "gt branch down {{step}}"
 tags:
   - graphite
-description: "Quickly move down a stack of branches. By default, takes a step argument of 1, but can add a step value (ex. gt branch up 2) to skip a certain number of branches."
+description: "Alias `bd`. Quickly move down a stack of branches. By default, takes a step argument of 1, but can add a step value (ex. gt branch up 2) to skip a certain number of branches."
 arguments:
   - name: step
     description: The number of branches to pass when traversing the stack of branches.
     default_value: 1
-source_url: "https://graphite.dev/docs/graphite-cheatsheet"
+source_url: "https://graphite.dev/docs/command-reference"
 author: graphite
 author_url: "https://graphite.dev/"
 shells: []
diff --git a/specs/graphite/gt_branch_edit.yaml b/specs/graphite/gt_branch_edit.yaml
@@ -4,7 +4,7 @@ command: "gt branch edit"
 tags:
   - graphite
 description: "Alias: `be`. Run an interactive rebase on the current branch's commits and restack upstack branches."
-source_url: "https://graphite.dev/docs/graphite-cheatsheet"
+source_url: "https://graphite.dev/docs/command-reference"
 author: graphite
 author_url: "https://graphite.dev/"
 shells: []
diff --git a/specs/graphite/gt_branch_fold.yaml b/specs/graphite/gt_branch_fold.yaml
@@ -4,7 +4,7 @@ command: "gt branch fold"
 tags:
   - graphite
 description: "Alias: `bf`. Fold a branch's changes into its parent, update dependencies of descendants of the new combined branch, and restack."
-source_url: "https://graphite.dev/docs/graphite-cheatsheet"
+source_url: "https://graphite.dev/docs/command-reference"
 author: graphite
 author_url: "https://graphite.dev/"
 shells: []
diff --git a/specs/graphite/gt_branch_info.yaml b/specs/graphite/gt_branch_info.yaml
@@ -0,0 +1,10 @@
+---
+name: Graphite - Displays information about the current branch
+command: "gt branch info"
+tags:
+  - graphite
+description: "Alias: `bi`. Display information about the current branch."
+source_url: "https://graphite.dev/docs/command-reference"
+author: graphite
+author_url: "https://graphite.dev/"
+shells: []
diff --git a/specs/graphite/gt_branch_list.yaml b/specs/graphite/gt_branch_list.yaml
@@ -4,7 +4,7 @@ command: "gt ls"
 tags:
   - graphite
 description: "Log all stacks tracked by Graphite, arranged to show dependencies. Similar to showing the commit log."
-source_url: "https://graphite.dev/docs/graphite-cheatsheet"
+source_url: "https://graphite.dev/docs/command-reference"
 author: graphite
 author_url: "https://graphite.dev/"
 shells: []
diff --git a/specs/graphite/gt_branch_new_with_commit_message.yaml b/specs/graphite/gt_branch_new_with_commit_message.yaml
@@ -8,7 +8,7 @@ arguments:
   - name: commit_message
     description: The message to assign to this commit.
     default_value: ~
-source_url: "https://graphite.dev/docs/graphite-cheatsheet"
+source_url: "https://graphite.dev/docs/command-reference"
 author: graphite
 author_url: "https://graphite.dev/"
 shells: []
diff --git a/specs/graphite/gt_branch_rename.yaml b/specs/graphite/gt_branch_rename.yaml
@@ -4,7 +4,7 @@ command: "gt branch rename"
 tags:
   - graphite
 description: "Alias: `brn`. Rename a branch and update metadata referencing it. Note that this removes any associated GitHub pull request."
-source_url: "https://graphite.dev/docs/graphite-cheatsheet"
+source_url: "https://graphite.dev/docs/command-reference"
 author: graphite
 author_url: "https://graphite.dev/"
 shells: []
diff --git a/specs/graphite/gt_branch_restack.yaml b/specs/graphite/gt_branch_restack.yaml
@@ -3,8 +3,8 @@ name: Graphite - Restacks the current branch to its parent
 command: "gt branch restack"
 tags:
   - graphite
-description: "Alias: `brn`. Ensure the current branch is based on its parent, rebasing if necessary."
-source_url: "https://graphite.dev/docs/graphite-cheatsheet"
+description: "Alias: `br`. Ensure the current branch is based on its parent, rebasing if necessary."
+source_url: "https://graphite.dev/docs/command-reference"
 author: graphite
 author_url: "https://graphite.dev/"
 shells: []
diff --git a/specs/graphite/gt_branch_split.yaml b/specs/graphite/gt_branch_split.yaml
@@ -0,0 +1,11 @@
+---
+name: Graphite - Splits the current branch into multiple branches
+command: "gt branch split"
+tags:
+  - graphite
+description: "Alias: `bsp`. Split the current branch into multiple branches."
+arguments: []
+source_url: "https://graphite.dev/docs/command-reference"
+author: graphite
+author_url: "https://graphite.dev/"
+shells: []
diff --git a/specs/graphite/gt_branch_squash.yaml b/specs/graphite/gt_branch_squash.yaml
@@ -0,0 +1,11 @@
+---
+name: Graphite - Squash the commits on the current branch into one
+command: "gt branch squash"
+tags:
+  - graphite
+description: "Alias `bsq`. Squash all commits in the current branch and restack upstack branches."
+arguments: []
+source_url: "https://graphite.dev/docs/command-reference"
+author: graphite
+author_url: "https://graphite.dev/"
+shells: []
diff --git a/specs/graphite/gt_branch_submit.yaml b/specs/graphite/gt_branch_submit.yaml
@@ -0,0 +1,11 @@
+---
+name: Graphite - Pushes (force) the current branch to GitHub
+command: "gt branch submit"
+tags:
+  - graphite
+description: "Alias: `bs`. Idempotently force push the current branch to GitHub, creating or updating a pull request."
+arguments: []
+source_url: "https://graphite.dev/docs/command-reference"
+author: graphite
+author_url: "https://graphite.dev/"
+shells: []
diff --git a/specs/graphite/gt_branch_top.yaml b/specs/graphite/gt_branch_top.yaml
@@ -0,0 +1,11 @@
+---
+name: Graphite - Pushes (force) the current branch to GitHub
+command: "gt branch top"
+tags:
+  - graphite
+description: "Alias: `bt`.  Switch to the tip branch of the current stack. Prompts if ambiguous."
+arguments: []
+source_url: "https://graphite.dev/docs/command-reference"
+author: graphite
+author_url: "https://graphite.dev/"
+shells: []
diff --git a/specs/graphite/gt_branch_track.yaml b/specs/graphite/gt_branch_track.yaml
@@ -0,0 +1,11 @@
+---
+name: Graphite - Starts tracking the current branch
+command: "gt branch track"
+tags:
+  - graphite
+description: "Alias: `btr`. Start tracking the current branch (by default) with Graphite by selecting its parent. This command can also be used to fix corrupted Graphite metadata."
+arguments: []
+source_url: "https://graphite.dev/docs/command-reference"
+author: graphite
+author_url: "https://graphite.dev/"
+shells: []
diff --git a/specs/graphite/gt_branch_untrack.yaml b/specs/graphite/gt_branch_untrack.yaml
@@ -0,0 +1,11 @@
+---
+name: Graphite - Stops tracking the current branch and all its children
+command: "gt branch untrack"
+tags:
+  - graphite
+description: "Alias: `but`. Stop tracking a branch with Graphite. If the branch has children, they will also be untracked."
+arguments: []
+source_url: "https://graphite.dev/docs/command-reference"
+author: graphite
+author_url: "https://graphite.dev/"
+shells: []
diff --git a/specs/graphite/gt_branch_up.yaml b/specs/graphite/gt_branch_up.yaml
@@ -3,12 +3,12 @@ name: Graphite - Move up the stack of branches
 command: "gt branch up {{step}}"
 tags:
   - graphite
-description: "Quickly move up a stack of branches. By default, takes a step argument of 1, but can add a step value (ex. gt branch up 2) to skip a certain number of branches."
+description: "Alias `bu`. Quickly move up a stack of branches. By default, takes a step argument of 1, but can add a step value (ex. gt branch up 2) to skip a certain number of branches."
 arguments:
   - name: step
     description: The number of branches to pass when traversing the stack of branches.
     default_value: 1
-source_url: "https://graphite.dev/docs/graphite-cheatsheet"
+source_url: "https://graphite.dev/docs/command-reference"
 author: graphite
 author_url: "https://graphite.dev/"
 shells: []
diff --git a/specs/graphite/gt_changelog.yaml b/specs/graphite/gt_changelog.yaml
@@ -0,0 +1,11 @@
+---
+name: Graphite - Shows the Graphite changelog
+command: "gt changelog"
+tags:
+  - graphite
+description: "Show the Graphite CLI changelog."
+arguments: []
+source_url: "https://graphite.dev/docs/command-reference"
+author: graphite
+author_url: "https://graphite.dev/"
+shells: []
diff --git a/specs/graphite/gt_commit_amend.yaml b/specs/graphite/gt_commit_amend.yaml
@@ -0,0 +1,11 @@
+---
+name: Graphite - Amend the most recent commit and restack upstack branches
+command: "gt commit amend"
+tags:
+  - graphite
+description: "Alias `ca`. Amend the most recent commit and restack upstack branches."
+arguments: []
+source_url: "https://graphite.dev/docs/command-reference"
+author: graphite
+author_url: "https://graphite.dev/"
+shells: []
diff --git a/specs/graphite/gt_commit_create.yaml b/specs/graphite/gt_commit_create.yaml
@@ -0,0 +1,11 @@
+---
+name: Graphite - Create a new commit and restack upstack branches
+command: "gt commit create"
+tags:
+  - graphite
+description: "Alias `cc`. Create a new commit and restack upstack branches."
+arguments: []
+source_url: "https://graphite.dev/docs/command-reference"
+author: graphite
+author_url: "https://graphite.dev/"
+shells: []
diff --git a/specs/graphite/gt_completion.yaml b/specs/graphite/gt_completion.yaml
@@ -0,0 +1,11 @@
+---
+name: Graphite - Set up bash or zsh tab completion.
+command: "gt completion"
+tags:
+  - graphite
+description: "Set up bash or zsh tab completion."
+arguments: []
+source_url: "https://graphite.dev/docs/command-reference"
+author: graphite
+author_url: "https://graphite.dev/"
+shells: []
diff --git a/specs/graphite/gt_continue.yaml b/specs/graphite/gt_continue.yaml
@@ -0,0 +1,11 @@
+---
+name: Graphite - Continues the most recent Graphite command halted by a merge conflict
+command: "gt continue"
+tags:
+  - graphite
+description: "Alias `cont`. Continues the most recent Graphite command halted by a merge conflict."
+arguments: []
+source_url: "https://graphite.dev/docs/command-reference"
+author: graphite
+author_url: "https://graphite.dev/"
+shells: []
diff --git a/specs/graphite/gt_dash.yaml b/specs/graphite/gt_dash.yaml
@@ -0,0 +1,11 @@
+---
+name: Graphite - Open the web dashboard
+command: "gt dash"
+tags:
+  - graphite
+description: "Open the web dashboard."
+arguments: []
+source_url: "https://graphite.dev/docs/command-reference"
+author: graphite
+author_url: "https://graphite.dev/"
+shells: []
diff --git a/specs/graphite/gt_dash_pr.yaml b/specs/graphite/gt_dash_pr.yaml
@@ -0,0 +1,11 @@
+---
+name: Graphite - Open the web dashboard
+command: "gt dash pr"
+tags:
+  - graphite
+description: "Alias: `dp` `dpr`. Opens the PR page for the current branch."
+arguments: []
+source_url: "https://graphite.dev/docs/command-reference"
+author: graphite
+author_url: "https://graphite.dev/"
+shells: []
diff --git a/specs/graphite/gt_docs.yaml b/specs/graphite/gt_docs.yaml
@@ -0,0 +1,11 @@
+---
+name: Graphite - Show the Graphite CLI docs
+command: "gt docs"
+tags:
+  - graphite
+description: "Show the Graphite CLI docs."
+arguments: []
+source_url: "https://graphite.dev/docs/command-reference"
+author: graphite
+author_url: "https://graphite.dev/"
+shells: []
diff --git a/specs/graphite/gt_downstack_edit.yaml b/specs/graphite/gt_downstack_edit.yaml
@@ -0,0 +1,14 @@
+---
+name: Graphite - Edit the branches
+command: "gt downstack edit"
+tags:
+  - graphite
+description: "Alias `dse`. Edit the order of the branches between trunk and the current branch, restacking all of their descendants."
+arguments:
+  - name: branch_name
+    description: The name of the branch that you want to fetch from remote
+    default_value: main
+source_url: "https://graphite.dev/docs/command-reference"
+author: graphite
+author_url: "https://graphite.dev/"
+shells: []
diff --git a/specs/graphite/gt_downstack_get.yaml b/specs/graphite/gt_downstack_get.yaml
@@ -1,14 +1,14 @@
 ---
 name: Graphite - Get downstack from remote
-command: "gt dsg {{branch_name}}"
+command: "gt downstack get {{branch_name}}"
 tags:
   - graphite
-description: "A popular command for getting a stack locally that's been created/manipulated by someone else. Oftentimes followed up with gt bdl to delete irrelevant branches locally."
+description: "Alias `dsg`. Get branches from trunk to the specified branch from remote, prompting the user to resolve conflicts."
 arguments:
   - name: branch_name
     description: The name of the branch that you want to fetch from remote
     default_value: main
-source_url: "https://graphite.dev/docs/graphite-cheatsheet"
+source_url: "https://graphite.dev/docs/command-reference"
 author: graphite
 author_url: "https://graphite.dev/"
 shells: []
diff --git a/specs/graphite/gt_downstack_restack.yaml b/specs/graphite/gt_downstack_restack.yaml
@@ -0,0 +1,11 @@
+---
+name: Graphite - Rebase the parent branches
+command: "gt downstack restack"
+tags:
+  - graphite
+description: "Alias `dsr`. From trunk to the current branch, ensure each is based on its parent, rebasing if necessary."
+arguments: []
+source_url: "https://graphite.dev/docs/command-reference"
+author: graphite
+author_url: "https://graphite.dev/"
+shells: []
diff --git a/specs/graphite/gt_downstack_submit.yaml b/specs/graphite/gt_downstack_submit.yaml
@@ -0,0 +1,11 @@
+---
+name: Graphite - Push the parent branches to GitHub
+command: "gt downstack submit"
+tags:
+  - graphite
+description: "Alias `dss`.  Idempotently force push all branches from trunk to the current branch to GitHub, creating or updating distinct pull requests for each."
+arguments: []
+source_url: "https://graphite.dev/docs/command-reference"
+author: graphite
+author_url: "https://graphite.dev/"
+shells: []
diff --git a/specs/graphite/gt_downstack_test.yaml b/specs/graphite/gt_downstack_test.yaml
diff --git a/specs/graphite/gt_downstack_track.yaml b/specs/graphite/gt_downstack_track.yaml
diff --git a/specs/graphite/gt_stack_bottom.yaml b/specs/graphite/gt_stack_bottom.yaml
diff --git a/specs/graphite/gt_stack_submit.yaml b/specs/graphite/gt_stack_submit.yaml
diff --git a/specs/graphite/gt_stack_up.yaml b/specs/graphite/gt_stack_up.yaml
diff --git a/specs/graphite/gt_synchronize_with_remote.yaml b/specs/graphite/gt_synchronize_with_remote.yaml
diff --git a/specs/graphite/gt_troubleshoot_graphite_cli.yaml b/specs/graphite/gt_troubleshoot_graphite_cli.yaml
