Connect Integrations
Connect GitHub, Slack, and your Anthropic API key to Ryven.
Ryven needs three integrations to work: GitHub for repository access and pull requests, Slack for triggers and notifications, and an Anthropic API key to power the underlying agent.
The onboarding wizard walks you through each step. You can also configure them later from Settings > Integrations in the dashboard.
GitHub
Ryven uses a GitHub App to access your repositories. This gives it scoped permissions — it can only see the repos you explicitly grant access to.
- Click Install GitHub App in the onboarding wizard (or Settings)
- Select your GitHub organization or account
- Choose which repositories Ryven can access
- Confirm the installation
Once connected, the dashboard shows the list of accessible repositories.
Ryven requests the minimum permissions needed: read/write access to code, pull requests, issues, and checks. It does not request admin access to your organization.
Slack
Connect your Slack workspace so Ryven can receive @ryven mentions and post task updates in threads.
- Click Add to Slack in the onboarding wizard (or Settings)
- Select the Slack workspace to connect
- Authorize the requested permissions
After connecting, you can mention @ryven in any channel where the bot has been invited.
Anthropic API key
Ryven uses Claude (via the Anthropic API) to understand your codebase and write code. You need to provide an API key.
- Get a key from console.anthropic.com
- Paste the key in the onboarding wizard (or Settings > Integrations)
- The key is validated and encrypted before storage
Your API key is encrypted with AES-256-GCM before being stored. It is never returned in API responses — only a masked version (e.g., sk-ant-...***) is displayed.
Personal key override
If your workspace has a shared API key, individual members can override it with their own key from Settings > Profile. When a member triggers a task, their personal key is used if set; otherwise the workspace key is used.
Jira (optional)
Connect Jira to trigger tasks from Jira issues.
- Click Connect Jira in Settings > Integrations
- Authorize access to your Atlassian account
- Select the Jira site and projects to connect
Once connected, Ryven registers webhooks on your Jira project and can be triggered from issue updates.