01
Authorize GitHub in Code Agent
Open Code Agent, click Connect GitHub, approve the OAuth request, and select the repository plus the primary branch (usually main). Worken stores the connection so any task can reference this repo.
GitHub Integration
Use the GitHub channel to let a virt inspect repositories, make commits, and open pull requests under your supervision. This keeps code work inside the same Worken surface where you manage conversations.
Preconditions
- Maintainer access to the repository (organization or personal)
- Virt with clear engineering instructions
- GitHub OAuth token with
repoandworkflowscopes
Steps
02
Describe the first task
Fill the First message field with context, goals, and constraints. Add environment variables (API keys, URLs, feature flags) in the same screen so the virt can run tests locally within the Worken sandbox.
03
Review activity and merge
After the virt starts working, monitor the History tab to see edited files, commands, and PR links. Request worken approval for sensitive repositories or add an extra reviewer before merging.
WARNING
Limit the OAuth token to the smallest scope and rotate it if you suspect exposure. Revoking the token in GitHub immediately disables the channel until you re-authorize inside Worken.
Practical Example
Example
Practical Example
An e-commerce team links shop-checkout, asks the virt to “optimize bundle splitting and add pagination to order history,” and provides staging API keys via environment variables. The virt opens a pull request with test results, while workens review and merge the changes.