updates

Author: ngmisl

.github/workflows/update-llms.yml

@@ -6,6 +6,8 @@ on:
   pull_request:
     branches: [ main, master ]
   workflow_dispatch:  # Allow manual triggering
+  repository_dispatch:  # Allow external triggers
+    types: [update-llms]
 
 permissions:
   contents: write
@@ -23,18 +25,31 @@ jobs:
         uses: actions/setup-python@v4
         with:
           python-version: '3.12'
+          cache: 'pip'
 
       - name: Install uv
         run: |
           curl -LsSf https://astral.sh/uv/install.sh | sh
           echo "$HOME/.cargo/bin" >> $GITHUB_PATH
 
-      - name: Install dependencies
+      - name: Create venv and install dependencies
         run: |
-          uv pip install .
+          uv venv
+          . .venv/bin/activate
+          uv pip install git+https://github.com/ngmisl/llmstxt.git
 
-      - name: Generate llms.txt
-        run: python llms.py
+      - name: Clone target repository
+        if: github.event_name == 'repository_dispatch'
+        run: |
+          git clone ${{ github.event.client_payload.repository }} target_repo
+          cd target_repo
+          python -m llmstxt
+
+      - name: Generate llms.txt for current repository
+        if: github.event_name != 'repository_dispatch'
+        run: |
+          . .venv/bin/activate
+          python -m llmstxt
 
       - name: Check for changes
         id: changes
@@ -47,11 +62,15 @@ jobs:
             echo "changes=true" >> $GITHUB_OUTPUT
           fi
 
-      - name: Commit and push if changed
+      - name: Create Pull Request
         if: steps.changes.outputs.changes == 'true'
-        run: |
-          git config --local user.email "github-actions[bot]@users.noreply.github.com"
-          git config --local user.name "github-actions[bot]"
-          git add llms.txt
-          git commit -m "chore: update llms.txt [skip ci]"
-          git push
+        uses: peter-evans/create-pull-request@v5
+        with:
+          commit-message: "chore: update llms.txt"
+          title: "chore: update llms.txt"
+          body: |
+            This PR updates the llms.txt file with the latest code compression.
+            
+            Changes were automatically generated by [llmstxt](https://github.com/ngmisl/llmstxt).
+          branch: update-llms
+          delete-branch: true

README.md

@@ -61,26 +61,37 @@ The script will:
 
 ### GitHub Actions Integration
 
-This tool can automatically generate and update `llms.txt` in your repository using GitHub Actions. To set it up:
+There are two ways to use this tool with GitHub Actions:
 
-1. Copy the workflow file:
+1. **For Your Own Repository**
    ```bash
+   # Create a workflow file
    mkdir -p .github/workflows
    curl -o .github/workflows/update-llms.yml https://raw.githubusercontent.com/ngmisl/llmstxt/main/.github/workflows/update-llms.yml
    ```
 
-2. Commit and push the workflow file:
+   The workflow will:
+   - Run automatically on pushes to main/master
+   - Create a PR with updated llms.txt when changes are detected
+   - Can be manually triggered from the Actions tab
+
+2. **For Remote Repositories**
+   You can trigger the action for any repository using the GitHub API:
+
    ```bash
-   git add .github/workflows/update-llms.yml
-   git commit -m "chore: add llmstxt workflow"
-   git push
+   curl -X POST \
+     -H "Authorization: token $GITHUB_TOKEN" \
+     -H "Accept: application/vnd.github.v3+json" \
+     https://api.github.com/repos/ngmisl/llmstxt/dispatches \
+     -d '{"event_type": "update-llms", "client_payload": {"repository": "https://github.com/user/repo.git"}}'
    ```
 
-The workflow will:
-- Run automatically on pushes to main/master
-- Generate/update llms.txt
-- Commit and push changes if needed
-- Can be manually triggered from the Actions tab
+   This will:
+   - Clone the target repository
+   - Generate llms.txt
+   - Create a PR with the changes
+
+The workflow uses GitHub's PR system to ensure changes are reviewed before being merged.
 
 ## Output Format