feat(docs): add docs_gen module for auto-generating option tables

.github/workflows/update-readme.yml → .github/workflows/markdown-code-runner.yml

@@ -1,4 +1,4 @@
-name: Update README.md
+name: Update docs
 
 on:
   push:
@@ -7,7 +7,7 @@ on:
   pull_request:
 
 jobs:
-  update_readme:
+  update_docs:
     runs-on: macos-latest
     steps:
       - name: Check out repository
@@ -22,26 +22,27 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v6
 
-      - name: Run markdown-code-runner
+      - name: Run update_docs.py
         env:
           TERM: dumb
           NO_COLOR: 1
           TERMINAL_WIDTH: 90
         run: |
-          uvx --with . markdown-code-runner README.md
-          sed -i '' 's/[[:space:]]*$//' README.md
+          uv sync
+          uv run python docs/update_docs.py
+          find . -name "*.md" -exec sed -i '' 's/[[:space:]]*$//' {} \;
 
-      - name: Commit updated README.md
+      - name: Commit updated docs
         id: commit
         run: |
-          git add README.md
+          git add -A
           git config --local user.email "github-actions[bot]@users.noreply.github.com"
           git config --local user.name "github-actions[bot]"
           if git diff --quiet && git diff --staged --quiet; then
-            echo "No changes in README.md, skipping commit."
+            echo "No changes in docs, skipping commit."
             echo "commit_status=skipped" >> $GITHUB_ENV
           else
-            git commit -m "Update README.md"
+            git commit -m "Update auto-generated docs"
             echo "commit_status=committed" >> $GITHUB_ENV
           fi
 

agent_cli/agents/transcribe.py

@@ -415,6 +415,7 @@ def transcribe(  # noqa: PLR0912
         None,
         "--extra-instructions",
         help="Additional instructions for the LLM to process the transcription.",
+        rich_help_panel="LLM Configuration",
     ),
     from_file: Path | None = opts.FROM_FILE,
     last_recording: int = opts.LAST_RECORDING,