Device authorization
Link GitHub to vidbyte-cli
vidbyte-cli github link signs a GitHub account in through GitHub's device flow so the bug finder can clone your repositories. It is included in the released CLI (0.3.4), and it does not read repositories or pull requests as context.
Configure a GitHub OAuth App
Create a GitHub OAuth App with device flow enabled, then make its client ID available as VIDBYTE_GITHUB_CLIENT_ID. Without it, github link stops before contacting GitHub.
Set the OAuth app client ID
export VIDBYTE_GITHUB_CLIENT_ID="your-oauth-app-client-id"Set the OAuth app client ID
$env:VIDBYTE_GITHUB_CLIENT_ID = "your-oauth-app-client-id"Client ID only — The link reads only the client ID. It never asks for the app's client secret.
GitHub enforces access — GitHub still enforces account access and the scope you granted.
Link the account
Run it in an interactive terminal. Linking uses no Vidbyte API key or balance: the CLI talks only to GitHub and stores the token in the system keyring, one link per CLI profile.
Start device authorization
Shows a one-time code and GitHub's verification link. The command takes no options such as
--nameor--scope.Link GitHub
bashvidbyte-cli github linkApprove in your browser
Enter the code on GitHub and approve. The CLI checks the token with GitHub, stores it for the current profile, and prints the linked login;
--format jsonadds the granted scope.Keep a second account under another profile
Each CLI profile holds one GitHub link, and linking again replaces it. Use the root
--profileoption to keep a second account.Second account
bashvidbyte-cli --profile work github link
Reading repositories and pull requests
No released or main CLI reads a repository or pull request as context. The connections login and connections read commands, with their --via auto, --via direct, and --via native options, were designed but never released.
Save the context as a file
Copy what the agent should know, such as a pull request's description and changed files, into a
.mdor.txtfile.Pass the file to an agent
The Suggestion Agent reads each
--filespath as context; it accepts.txt,.md, and.jsonfiles, and you can repeat the option. This works in the released CLI (0.3.4).Context from a file
bashvidbyte-cli agents suggest run --goal "Ship the billing page this week" --files context.md
Remove the link
No command removes the link yet.
To cut the link's access, revoke your OAuth App on GitHub under Settings > Applications > Authorized OAuth Apps.