A GitHub Action that integrates Kilo AI directly into your GitHub workflow.

Mention /kilo or /kc in your comment, and Kilo will execute tasks within your GitHub Actions runner.

Leave the following comment on a GitHub issue. Kilo will read the entire thread, including all comments, and reply with a clear explanation.

/kilo explain this issue

Leave the following comment on a GitHub issue. Kilo will create a new branch, implement the changes, and open a PR with the changes.

/kilo fix this

Leave the following comment on a GitHub PR. Kilo will implement the requested change and commit it to the same PR.

Delete the attachment from S3 when the note is removed /kc

Leave a comment directly on code lines in the PR's "Files" tab. Kilo will automatically detect the file, line numbers, and diff context to provide precise responses.

[Comment on specific lines in Files tab]
/kc add error handling here

When commenting on specific lines, Kilo receives:

• The exact file being reviewed
• The specific lines of code
• The surrounding diff context
• Line number information

This allows for more targeted requests without needing to specify file paths or line numbers manually.

Run the following command in the terminal from your GitHub repo:

kilo github install

This will walk you through installing the KiloConnect GitHub app, creating the workflow, and setting up secrets.

1. Install the KiloConnect GitHub app at https://github.com/apps/kiloconnect. Make sure it is installed on the target repository.

2. Add the following workflow file to .github/workflows/kilo.yml in your repo. Set the appropriate model and required API keys.

   name: kilo
   
   on:
     issue_comment:
       types: [created]
     pull_request_review_comment:
       types: [created]
   
   jobs:
     kilo:
       if: |
         contains(github.event.comment.body, '/kc') ||
         contains(github.event.comment.body, '/kilo')
       runs-on: ubuntu-latest
       permissions:
         id-token: write
         contents: write
         pull-requests: write
         issues: write
       steps:
         - name: Checkout repository
           uses: actions/checkout@v6
           with:
             persist-credentials: false
   
         - name: Run Kilo
           uses: Kilo-Org/kilo/github@latest
           with:
             model: kilo/claude-sonnet-4-20250514
             kilo_api_key: ${{ secrets.KILO_API_KEY }}
             kilo_org_id: ${{ secrets.KILO_ORG_ID }}

3. Store the API keys in secrets. In your organization or project settings, expand Secrets and variables on the left and select Actions. Add KILO_API_KEY and KILO_ORG_ID.

• model (required) - The AI model to use (e.g., kilo/claude-sonnet-4-20250514)
• kilo_api_key (optional) - Kilo API key for gateway authentication
• kilo_org_id (optional) - Kilo organization ID
• agent (optional) - Agent to use. Must be a primary agent.
• share (optional) - Share the Kilo session (defaults to true for public repos)
• prompt (optional) - Custom prompt to override the default prompt
• mentions (optional) - Comma-separated list of trigger phrases (defaults to /kilo,/kc)
• use_github_token (optional) - Use GITHUB_TOKEN directly instead of Kilo App token exchange (defaults to false)
• oidc_base_url (optional) - Base URL for OIDC token exchange API (defaults to https://api.kilo.ai)

You can also use other AI providers by setting their API keys:

- name: Run Kilo
  uses: Kilo-Org/kilo/github@latest
  with:
    model: anthropic/claude-sonnet-4-20250514
  env:
    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

If you encounter issues or have feedback, please create an issue at https://github.com/Kilo-Org/kilo/issues.

This directory contains the composite GitHub Action definition. The actual implementation is in the Kilo CLI (packages/opencode/src/cli/cmd/github.ts).

To test locally, see the main AGENTS.md for development instructions.