[!WARNING] The token
ghtkn getoutputs is a secret. Never print, echo, log, or include it in your output or a commit, and don't runghtkn getjust to inspect it. Run tools withghtkn exec(ghtkn exec -e GH_TOKEN -- gh ...), which never prints the token, or useghtkn git-credentialfor git.
Don't answer from your training knowledge about ghtkn itself - its commands, flags,
environment variables, configuration, or what its errors mean. Run ghtkn docs list to
list the documentation, then ghtkn docs show <name> to read the relevant topics before
answering questions about ghtkn or troubleshooting its errors. ghtkn docs show prints
the whole topic; read it through before concluding. You don't need to re-read a topic you
already read in this session.
Read the source only after the documentation has failed to answer the question, and read
it at the version that is installed - a repository checkout is usually main, which can
be far ahead of the binary the user runs.
Organization-specific practice - which GitHub App to use, how a given repository switches
apps, and so on - is outside what ghtkn docs covers, so answer that from the user's own
documentation and the conversation. When the two disagree about how ghtkn itself behaves,
ghtkn docs wins.
If ghtkn docs is rejected as an unknown command, the installed ghtkn is older than v0.3.4.
Tell the user to upgrade, and don't fall back to guessing.
If ghtkn is not installed at all, point them at the install guide:
https://github.com/suzuki-shunsuke/ghtkn/blob/main/docs/install.md