GitHub authorization
Local recording, playback and live sharing work without a GitHub account. Authorize only to upload recordings to GitHub Gists.
termbacktime auth --open
Enter the displayed device code on GitHub. The CLI saves your token locally with permissions limited to your user. Tokens never pass through this website.
The CLI fetches the public GitHub app ID from the website API once and caches it in
~/termbacktime/termbacktime.json. Later logins reuse that value. After switching websites or
OAuth apps, run termbacktime auth --refresh-client-id --open to fetch it again. Removing the
config also clears the cached ID and your saved token.
To supply an existing token securely, use termbacktime auth --token-stdin. Revoke locally with
termbacktime auth --logout.