I wanted to run markdown files like shell scripts. So I built an open source tool that lets you use a shebang to pipe them through Claude Code with full stdin/stdout support.
https://task.md:
#!/usr/bin/env claude-run
Analyze this codebase and summarize the architecture.
Then:
chmod +x task.md
./task.md
These aren't just prompts. Claude Code has tool use, so a markdown file can run shell commands, write scripts, read files, make API calls. The prompt orchestrates everything.
A script that runs your tests and reports results (`https://run_tests.md`):
Comment too long. Click here to view the full text.