add GH action .yml file and setup steps

Author: sayansisodiya

.github/workflows/review.yml

@@ -0,0 +1,29 @@
+name: Amp Code Review
+
+on:
+  pull_request:
+    types: [opened, reopened, ready_for_review]
+
+jobs:
+  review:
+    runs-on: ubuntu-latest
+    
+    # Ensure only one review runs per PR
+    concurrency:
+      group: pr-${{ github.event.pull_request.number }}
+      cancel-in-progress: true
+    
+    permissions:
+      pull-requests: write
+      checks: write
+      contents: read
+    
+    steps:
+      - name: Run Amp Code Review
+        uses: docker://ghcr.io/sourcegraph/cra-github:latest
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          AMP_SERVER_URL: ${{ vars.AMP_SERVER_URL }}
+          AMP_API_KEY: ${{ secrets.AMP_API_KEY }}
+        with:
+          args: node /app/dist/bin/review-action.js

Dockerfile

@@ -32,4 +32,9 @@ COPY config.yml ./
 
 EXPOSE 5053
 
+# Ensure container runs from /app regardless of external --workdir overrides
+ENTRYPOINT ["sh", "-c", "cd /app && exec \"$@\"", "--"]
+
+# Default: start webhook server for Docker deployments  
+# Note: GitHub Actions overrides this CMD with review-action.js
 CMD ["node", "dist/server.js"]

README.md

@@ -15,6 +15,37 @@ A GitHub App for automated code reviews using Hono.js and Amp.
 
 ## Quick Start
 
+### GitHub Actions (Recommended)
+
+The simplest way to add code reviews to any repository:
+
+1. **Copy the workflow file** to your repo:
+   ```bash
+   mkdir -p .github/workflows
+   # Copy review.yml from this repo to .github/workflows/
+   ```
+
+2. **Configure repository settings**:
+   - Go to your repo → Settings → Secrets and variables → Actions
+   - Add **Variable**: `AMP_SERVER_URL` = `https://ampcode.com`
+   - Add **Secret**: `AMP_API_KEY` = your Amp API key
+
+3. **Create a pull request** - reviews will run automatically!
+
+### Docker Image (For Actions)
+
+To build and publish the Docker image:
+
+```bash
+# Build for GitHub Actions (linux/amd64)
+podman build --platform linux/amd64 -t ghcr.io/your-username/cra-github:latest .
+
+# Push to GitHub Container Registry  
+podman push ghcr.io/your-username/cra-github:latest
+```
+
+Update the workflow file to use your image: `docker://ghcr.io/your-username/cra-github:latest`
+
 ### Local Development
 
 1. **Clone and Install**

src/bin/review-action.ts

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+
+import { readFileSync } from 'fs';
+import { processReview } from '../github/process-review.js';
+import { GitHubPullRequestEvent } from '../github/types.js';
+
+async function main() {
+  try {
+    // GitHub Actions provides the event payload via GITHUB_EVENT_PATH
+    const eventPath = process.env.GITHUB_EVENT_PATH;
+    if (!eventPath) {
+      throw new Error('GITHUB_EVENT_PATH environment variable not set');
+    }
+
+    // Read and parse the GitHub event payload
+    const eventData = JSON.parse(readFileSync(eventPath, 'utf8'));
+    
+    // Validate this is a pull request event
+    if (!eventData.pull_request) {
+      console.log('Not a pull request event, skipping review');
+      return;
+    }
+
+    const payload = eventData as GitHubPullRequestEvent;
+    
+    // Generate a job ID for this review run
+    const jobId = `action-${Date.now()}-${payload.pull_request.number}`;
+    
+    console.log(`Starting review for PR #${payload.pull_request.number}`);
+    console.log(`Repository: ${payload.repository.full_name}`);
+    console.log(`Action: ${payload.action}`);
+    
+    // Call the existing review logic
+    // Note: installationId is not used when using GITHUB_TOKEN auth
+    await processReview(jobId, 0, payload);
+    
+    console.log('Review completed successfully');
+    
+  } catch (error) {
+    console.error('Review failed:', error);
+    process.exit(1);
+  }
+}
+
+main();

src/github/client.ts

@@ -36,6 +36,17 @@ export class GitHubClient {
     return new GitHubClient(config);
   }
 
+  static forToken(config: Config, token: string): GitHubClient {
+    const configWithToken = {
+      ...config,
+      github: {
+        ...config.github,
+        token
+      }
+    };
+    return new GitHubClient(configWithToken);
+  }
+
   private async getAuthHeaders(): Promise<Record<string, string>> {
     const headers = {
       'Accept': 'application/vnd.github.v3+json',

src/github/process-review.ts

@@ -9,7 +9,12 @@ export async function processReview(
   payload: GitHubPullRequestEvent
 ): Promise<void> {
   const config = await getConfig();
-  const githubClient = GitHubClient.forInstallation(config, installationId);
+  
+  // Use GITHUB_TOKEN from Actions environment if available, otherwise use GitHub App
+  const githubToken = process.env.GITHUB_TOKEN;
+  const githubClient = githubToken 
+    ? GitHubClient.forToken(config, githubToken)
+    : GitHubClient.forInstallation(config, installationId);
 
   try {
     // Extract PR information