Jason Cao
07/16/2025, 7:23 PMgt
It just fails silently and returns nothingPylon
07/16/2025, 7:23 PMgt feedback --with-debug-context <any message>Jason Cao
07/16/2025, 7:24 PMgt auth.
My OS is MacOS Sequoia, the lastest version, with the lastest updated dev command line tools from mac.Jason Cao
07/16/2025, 7:24 PMPylon
07/16/2025, 7:24 PMwhich gtJason Cao
07/16/2025, 7:29 PMPylon
07/16/2025, 7:29 PMecho $PATH ?Jason Cao
07/16/2025, 7:30 PM/opt/homebrew/opt/libpq/bin:/opt/homebrew/opt/libpq/bin:/Users/jasoncao/.nvm/versions/node/v22.11.0/bin:/Users/jasoncao/Downloads/google-cloud-sdk/bin:/Users/jasoncao/Library/pnpm:/opt/miniconda3/bin:/opt/miniconda3/condabin:/home/jasoncao/miniconda/bin:/opt/homebrew/bin:/opt/homebrew/sbin:/usr/local/bin:/System/Cryptexes/App/usr/bin:/usr/bin:/bin:/usr/sbin:/sbin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/local/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/appleinternal/bin:/Users/jasoncao/.cargo/binJason Cao
07/16/2025, 7:32 PMgt by itself, i can see a lot of basic "get started" stuff and whatnot, but that's the only working command. The rest don't produce any outputs or errors.Pylon
07/16/2025, 7:33 PMgt --version and then echo $? to get the return codeJason Cao
07/16/2025, 7:34 PMgt --version gives me nothing:Jason Cao
07/16/2025, 7:34 PMJason Cao
07/16/2025, 7:34 PMecho gives return code 1Jason Cao
07/16/2025, 7:34 PMJason Cao
07/16/2025, 7:34 PMJason Cao
07/16/2025, 7:34 PMJason Cao
07/16/2025, 7:35 PMJason Cao
07/16/2025, 7:36 PMgt gives:
(base) jasoncao@Jasons-Mac-Studio monorepo % gt
Graphite (gt) simplifies the entire code authoring & reviewing lifecycle
for GitHub. It enables stacking PRs on top of each other to keep you
unblocked & your changes small, focused, and reviewable.
USAGE
$ gt <command> [flags]
AUTHENTICATING
Authenticating gt with Graphite enables submitting PRs and stacks:
1. Open https://app.graphite.dev/settings/cli
2. Create a new auth token
3. Paste the generated gt auth --token <token> command into the terminal
TERMS
stack: A sequence of pull requests, each building off of its parent.
ex: main <- PR "add API" <- PR "update frontend" <- PR "docs"
trunk: The branch that stacks are merged into.
ex: main
downstack: The PRs below the given PR in a stack, i.e. its ancestors.
upstack: The PRs above the given PR in a stack, i.e. its descendants.
CORE COMMANDS
gt init: Initializes your Git repo to work with Graphite
gt create: Creates a new branch and commit your changes
gt submit: Submits the current branch & all downstack
branches to Graphite
gt submit --stack: Submits your current stack to Graphite
gt modify: Amends your current branch with new changes and
rebases all PRs above it
gt restack: Rebases every PR in a stack to have the latest
changes
gt sync: Pulls the latest trunk branch, rebases all open
PRs/stacks on top of the latest changes, and
prompts to delete any stale/old/merged branches
gt checkout: Interactively checks out any of your branches
gt log: Prints a graphical representation of your current
stack
gt up: Checks out the branch directly upstack
gt down: Checks out the branch directly downstack
gt demo: Walks you through examples to learn the Graphite
workflow via an interactive tutorial
Run gt --help --all for a full command reference.
Pass the --help flag to any command for specific help
(ex: gt submit --help)
CORE WORKFLOW
Run gt guide workflow to quickly learn how to:
- create a new PR
- stack a PR on top of an existing PR
- respond to peer feedback from anywhere in your stack
- sync the latest changes from main
- merge your stack to your main branch
LEARN MORE
Learn about custom aliases with gt aliases --help.
Learn to customize gt with gt config --help.
More documentation: https://graphite.dev/docs
Our cheatsheet: https://graphite.dev/docs/cheatsheet
Tutorial videos: https://www.youtube.com/@withgraphite
Troubleshooting: https://graphite.dev/docs/troubleshooting
FEEDBACK
We'd love to hear your feedback! Join our Slack community at:
https://community.graphite.dev
or email us at: cli@graphite.dev.
You can also submit feedback directly via gt feedback, which
has the ability to attach logs if you're experiencing issues.Jason Cao
07/16/2025, 7:36 PMPylon
07/16/2025, 7:40 PMgt aliased:
which -a gt and type gtJason Cao
07/16/2025, 7:41 PMJason Cao
07/16/2025, 7:41 PMJason Cao
07/16/2025, 7:41 PMJason Cao
07/16/2025, 7:41 PMJason Cao
07/16/2025, 7:42 PMPylon
07/16/2025, 7:43 PMecho $? giving an exit code 1, indicative of a generic error/failureJason Cao
07/16/2025, 7:43 PMJason Cao
07/16/2025, 7:43 PMJason Cao
07/16/2025, 7:43 PMPylon
07/16/2025, 7:46 PMgt --version 2> error.log | less error.logJason Cao
07/16/2025, 7:47 PMJason Cao
07/16/2025, 7:47 PMJason Cao
07/16/2025, 7:48 PMPylon
07/16/2025, 7:49 PMbrew install withgraphite/tap/graphite you should be on the latest stable version 1.6.6Pylon
07/16/2025, 7:49 PMbrew reinstall withgraphite/tap/graphiteJason Cao
07/16/2025, 7:53 PMJason Cao
07/16/2025, 7:53 PMPylon
07/16/2025, 7:54 PMbrew uninstall graphite && brew untap withgraphite/tap && brew install withgraphite/tap/graphiteJason Cao
07/16/2025, 7:54 PMbrew reinstall withgraphite/tap/graphite
==> Fetching withgraphite/tap/graphite
==> Downloading https://github.com/withgraphite/homebrew-tap/releases/download/v1.6.6/gt-macos-arm64
Already downloaded: /Users/jasoncao/Library/Caches/Homebrew/downloads/d6da34647dfb633f0eaeba4eab7b0186aa6515ecec56350343661164fe72fc9d--gt-macos-arm64
==> Reinstalling withgraphite/tap/graphite
🍺 /opt/homebrew/Cellar/graphite/1.6.6: 4 files, 56.7MB, built in 0 seconds
==> Running `brew cleanup graphite`...
Disable this behaviour by setting HOMEBREW_NO_INSTALL_CLEANUP.
Hide these hints with HOMEBREW_NO_ENV_HINTS (see `man brew`).Jason Cao
07/16/2025, 7:54 PM(base) jasoncao@Jasons-Mac-Studio monorepo % brew uninstall graphite && brew untap withgraphite/tap && brew install withgraphite/tap/graphite
Uninstalling /opt/homebrew/Cellar/graphite/1.6.6... (4 files, 56.7MB)
Untapping withgraphite/tap...
Untapped 3 formulae (36 files, 36.1MB).
==> Tapping withgraphite/tap
Cloning into '/opt/homebrew/Library/Taps/withgraphite/homebrew-tap'...
remote: Enumerating objects: 3248, done.
remote: Counting objects: 100% (143/143), done.
remote: Compressing objects: 100% (68/68), done.
remote: Total 3248 (delta 100), reused 112 (delta 75), pack-reused 3105 (from 2)
Receiving objects: 100% (3248/3248), 33.83 MiB | 28.68 MiB/s, done.
Resolving deltas: 100% (1242/1242), done.
Tapped 3 formulae (35 files, 36.1MB).
==> Fetching withgraphite/tap/graphite
==> Downloading https://github.com/withgraphite/homebrew-tap/releases/download/v1.6.6/gt-macos-arm64
Already downloaded: /Users/jasoncao/Library/Caches/Homebrew/downloads/d6da34647dfb633f0eaeba4eab7b0186aa6515ecec56350343661164fe72fc9d--gt-macos-arm64
==> Installing graphite from withgraphite/tap
🍺 /opt/homebrew/Cellar/graphite/1.6.6: 4 files, 56.7MB, built in 0 seconds
==> Running `brew cleanup graphite`...
Disable this behaviour by setting HOMEBREW_NO_INSTALL_CLEANUP.
Hide these hints with HOMEBREW_NO_ENV_HINTS (see `man brew`).Jason Cao
07/16/2025, 7:55 PMJason Cao
07/16/2025, 7:55 PMJason Cao
07/16/2025, 7:56 PMPylon
07/16/2025, 7:57 PM1.6.6 has been out for a while. I've been able to install it in my own MacOS instance.)Pylon
07/16/2025, 7:57 PMfile "$(which gt)"Jason Cao
07/16/2025, 7:57 PMPylon
07/16/2025, 7:59 PMPylon
07/16/2025, 7:59 PMJason Cao
07/16/2025, 8:01 PMPylon
07/16/2025, 8:04 PMPylon
07/16/2025, 8:11 PMzsh -df to disable the customizations etc. and then try gt --version && echo $? in thereJason Cao
07/16/2025, 8:13 PMJason Cao
07/16/2025, 8:13 PMJason Cao
07/16/2025, 8:14 PMJason Cao
07/16/2025, 8:14 PMJason Cao
07/16/2025, 8:14 PMJason Cao
07/16/2025, 8:14 PMPylon
07/16/2025, 8:17 PM~/.config/graphite, unless you have $XDG_CONFIG_HOME set.Jason Cao
07/16/2025, 8:19 PMXDG_CONFIG_HOMEJason Cao
07/16/2025, 8:20 PMJason Cao
07/16/2025, 8:20 PMJason Cao
07/16/2025, 8:22 PMPylon
07/16/2025, 8:27 PMgt feedback --with-debug-context "debug logs for no stdout CLI" && echo $?Jason Cao
07/16/2025, 8:31 PMJason Cao
07/16/2025, 8:31 PMgt as a standalone command works just fine, but nothing else does.Pylon
07/16/2025, 8:37 PMJason Cao
07/16/2025, 8:39 PMPylon
07/17/2025, 2:12 PMgt has been logging anything. You can attach the logs.json file it generates here.
cat ~/.local/share/graphite/debug/* > logs.jsonPylon
07/17/2025, 2:14 PMAbout This Mac info accessed here: