some python scripts that are sometimes helpful to me

run a script#

only general requirement is uv

chmod +x <script-name>
./<script-name> <...>

scripts#

• check-files-for-bad-links
• find-longest-bsky-thread
• kill-processes
• update-lights
• update-readme

check-files-for-bad-links#

Check files for bad links.

Usage:

./check-files-for-bad-links *.md

Details:

• uses httpx to check links
• uses anyio to run the checks concurrently
• pass include globs to scan (e.g. *.md)
• pass exclude globs to skip (e.g. *.md)
• pass ignore-url prefixes to ignore (e.g. http://localhost or https://localhost)
• pass concurrency to run the checks concurrently (default is 50)

find-longest-bsky-thread#

Find the longest reply thread from a Bluesky post.

Usage:

./find-longest-bsky-thread https://bsky.app/profile/nerditry.bsky.social/post/3lnofix5nlc23

Details:

• uses atproto to fetch the thread
• uses jinja2 to render the thread

kill-processes#

AI-powered TUI for killing processes.

Usage:

./kill-processes

Details:

• uses textual for the TUI
• uses marvin (built on pydantic-ai) to annotate processes

update-lights#

Make some change to my phillips hue network of lights via agent + MCP server.

Usage:

./update-lights -m "turn on sahara in the living room and nightlight in the kitchen"

Details:

• uses a marvin (built on pydantic-ai) agent
• the agent spins up a fastmcp MCP server that talks to my phue bridge
• set HUE_BRIDGE_IP and HUE_BRIDGE_USERNAME in .env or otherwise in environment
• uses OPENAI_API_KEY by default, but you can set AI_MODEL in .env or otherwise in environment to use a different model

update-readme#

Update the README.md file with a list of all the scripts in the current directory.

Usage:

./update-readme