A GitHub Action that integrates altimate-code directly into your GitHub workflow.

Mention /altimate-code in your comment, and altimate-code will execute tasks within your GitHub Actions runner.

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

/altimate-code explain this issue

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

/altimate-code fix this

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

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

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

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

When commenting on specific lines, altimate-code 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:

altimate-code github install

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

1. Install the GitHub app https://github.com/apps/altimate-code-agent. Make sure it is installed on the target repository.

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

   name: altimate-code
   
   on:
     issue_comment:
       types: [created]
     pull_request_review_comment:
       types: [created]
   
   jobs:
     altimate-code:
       if: |
         contains(github.event.comment.body, '/oc') ||
         contains(github.event.comment.body, '/altimate-code')
       runs-on: ubuntu-latest
       permissions:
         id-token: write
       steps:
          - name: Checkout repository
            uses: actions/checkout@v6
            with:
              fetch-depth: 1
              persist-credentials: false
   
          - name: Run altimate-code
           uses: AltimateAI/altimate-code/github@latest
           env:
             ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
             GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           with:
             model: anthropic/claude-sonnet-4-20250514
             use_github_token: true

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

This is an early release. If you encounter issues or have feedback, please create an issue at https://github.com/AltimateAI/altimate-code/issues.

To test locally:

1. Navigate to a test repo (e.g. hello-world):

   cd hello-world

2. Run:

   MODEL=anthropic/claude-sonnet-4-20250514 \
     ANTHROPIC_API_KEY=sk-ant-api03-1234567890 \
     GITHUB_RUN_ID=dummy \
     MOCK_TOKEN=github_pat_1234567890 \
     MOCK_EVENT='{"eventName":"issue_comment",...}' \
     bun /path/to/altimate-code/github/index.ts

   • MODEL: The model used by altimate-code. Same as the MODEL defined in the GitHub workflow.
   • ANTHROPIC_API_KEY: Your model provider API key. Same as the keys defined in the GitHub workflow.
   • GITHUB_RUN_ID: Dummy value to emulate GitHub action environment.
   • MOCK_TOKEN: A GitHub personal access token. This token is used to verify you have admin or write access to the test repo. Generate a token here.
   • MOCK_EVENT: Mock GitHub event payload (see templates below).
   • /path/to/altimate-code: Path to your cloned altimate-code repo. bun /path/to/altimate-code/github/index.ts runs your local version of altimate-code.

MOCK_EVENT='{"eventName":"issue_comment","repo":{"owner":"sst","repo":"hello-world"},"actor":"fwang","payload":{"issue":{"number":4},"comment":{"id":1,"body":"hey altimate-code, summarize thread"}}}'

Replace:

• "owner":"sst" with repo owner
• "repo":"hello-world" with repo name
• "actor":"fwang" with the GitHub username of commenter
• "number":4 with the GitHub issue id
• "body":"hey altimate-code, summarize thread" with comment body

MOCK_EVENT='{"eventName":"issue_comment","repo":{"owner":"sst","repo":"hello-world"},"actor":"fwang","payload":{"issue":{"number":4},"comment":{"id":1,"body":"hey altimate-code, what is in my image ![Image](https://github.com/user-attachments/assets/xxxxxxxx)"}}}'

Replace the image URL https://github.com/user-attachments/assets/xxxxxxxx with a valid GitHub attachment (you can generate one by commenting with an image in any issue).

MOCK_EVENT='{"eventName":"issue_comment","repo":{"owner":"sst","repo":"hello-world"},"actor":"fwang","payload":{"issue":{"number":4,"pull_request":{}},"comment":{"id":1,"body":"hey altimate-code, summarize thread"}}}'

MOCK_EVENT='{"eventName":"pull_request_review_comment","repo":{"owner":"sst","repo":"hello-world"},"actor":"fwang","payload":{"pull_request":{"number":7},"comment":{"id":1,"body":"hey altimate-code, add error handling","path":"src/components/Button.tsx","diff_hunk":"@@ -45,8 +45,11 @@\n- const handleClick = () => {\n-   console.log('clicked')\n+ const handleClick = useCallback(() => {\n+   console.log('clicked')\n+   doSomething()\n+ }, [doSomething])","line":47,"original_line":45,"position":10,"commit_id":"abc123","original_commit_id":"def456"}}}'