GitHub Integration
Connect your GitHub repositories to Sekuire for source analysis and cloud builds.
Commands
- sekuire github install - Install the Sekuire GitHub App
- sekuire github installations - List GitHub App installations
- sekuire github connect - Connect a repository to an agent
install
Install the Sekuire GitHub App to enable source analysis and cloud builds.
sekuire github install [OPTIONS]
Options
| Option | Description |
|---|---|
--backend <URL> | Backend API URL (default: https://api.sekuire.ai) |
What the GitHub App Enables
- Source code analysis for security scanning
- Automatic capability detection from your code
- Push-triggered analysis updates
- Cloud builds with Kaniko
Example
Terminal
$ sekuire github install
Sekuire GitHub App Installation
--------------------------------
The Sekuire GitHub App enables:
- Source code analysis for security scanning
- Automatic capability detection
- Push-triggered analysis updates
Opening browser to install 'sekuire'...
After installation, the app will have access to selected repositories.
You can then connect repos to agents with:
sekuire github connect <repo-url>
info
The browser will open to the GitHub App installation page. Select your organization or personal account, then choose which repositories to grant access.
installations
List GitHub App installations for your organization.
sekuire github installations [OPTIONS]
Options
| Option | Description |
|---|---|
--backend <URL> | Backend API URL (default: https://api.sekuire.ai) |
note
You must be logged in with sekuire login first.
Example
Terminal
$ sekuire github installations
GitHub App Installations
------------------------
ACCOUNT TYPE INSTALLED
-----------------------------------------------------------------
acme-corp Organization 2026-01-15
john-doe User 2026-01-20
2 installation(s) found
connect
Connect a GitHub repository to an agent for source analysis and builds.
sekuire github connect <REPO_URL> [OPTIONS]
Options
| Option | Description |
|---|---|
--agent <ID> | Agent sekuire_id (defaults to current project) |
--backend <URL> | Backend API URL (default: https://api.sekuire.ai) |
Prerequisites
- You must be logged in with
sekuire login - The agent must be published to the registry
- The GitHub App must be installed with access to the repository
Example
Terminal
# From agent project directory
$ sekuire github connect https://github.com/acme/my-agent
Connecting Repository to Agent
-------------------------------
Agent: 72ad085ff800d898...
Repository: https://github.com/acme/my-agent
Repository connected successfully!
Source analysis has been triggered.
Check status with: sekuire analysis
Specifying Agent ID
Terminal
# Connect to a specific agent
$ sekuire github connect https://github.com/acme/my-agent --agent 72ad085ff800d898
Complete Workflow
Follow these steps to connect a repository and trigger cloud builds:
Terminal
# 1. Install the GitHub App (opens browser)
$ sekuire github install
# 2. Verify installation
$ sekuire github installations
# 3. Login and publish your agent
$ sekuire login
$ sekuire push
# 4. Connect repository
$ sekuire github connect https://github.com/acme/my-agent
# 5. Trigger a build
$ sekuire builds create --tag v1.0.0
App Permissions
The Sekuire GitHub App requests the following permissions:
| Permission | Access | Purpose |
|---|---|---|
| Repository contents | Read | Clone code for analysis and builds |
| Metadata | Read | List repositories |
| Webhooks | Read/Write | Trigger analysis on push |
info
The app only accesses repositories you explicitly grant access to during installation.
Troubleshooting
"Not logged in" error
$ sekuire login
"GitHub App not installed"
- Run
sekuire github install - Select the account/org that owns the repository
- Grant access to the specific repository
Repository not appearing
- Check that you granted access to the repo during app installation
- Visit GitHub Settings > Applications > Sekuire to modify access
- Re-run
sekuire github connect