Update README documentation when tools are added, removed, or modified. Use when the user adds a new script to py/, removes a script, or asks to update/regenerate docs. Updates py/README.md with per-tool documentation and README.md with an alphabetical table of contents.
Update the two README files in this repo to reflect the current set of tools.
py/README.md — detailed per-tool documentationREADME.md — project overview with a TOC linking to all toolspy/*.py script to extract: name, docstring, PEP 723 metadata, Click options/arguments, and key features.py/README.md and README.md.py/README.md following the existing format (see below).py/README.md alphabetically by script name.README.md with alphabetical links to each tool's section in py/README.md.Keep the existing header and intro, then one section per tool in this format:
## scriptname.py
One-line description from the script's docstring.
\`\`\`bash
# Example usage commands using the remote uv run URL pattern:
uv run https://raw.githubusercontent.com/garyj/tools/refs/heads/master/py/scriptname.py [args]
\`\`\`
**Key Features:**
- Feature bullet points derived from the script's capabilities
Use the remote uv run URL pattern for all example commands. Derive examples from the script's Click options and arguments.
Keep the existing header line, then add an alphabetical tool listing:
# Tools
Python, shell, and other tools for day to day tasks, mostly developed with LLMs.
## Python tools
| Tool | Description |
|------|-------------|
| [scriptname.py](py/README.md#scriptnamepy) | One-line description |