FOforgotpwd16·Jan 17, 2026
Some are already doing it with scripts: https://github.com/andisearch/claude-switcher. Install.md is just specialization of this.
In Install.md: A standard for LLM-executable installationandisearch
airun
Shell2026–2026
andisearch / airun
airun
Run AI prompts like programs. Executable markdown with shebang, Unix pipes, and output redirection. Extends Claude Code with cross-cloud provider switching and any-model support — free local or 100+ cloud models.
2Distinct people
3Mentions
0Explicit recommenders
164GitHub stars
What to know before exploring
What it is
Run AI prompts like programs. Executable markdown with shebang, Unix pipes, and output redirection. Extends Claude Code with cross-cloud provider switching and any-model support — free local or 100+ cloud models.
GitHub
Where it is used
No documented product use has been verified yet.
What people are saying
No recommendation phrase was found in the indexed comments.
No classified warning is attached to this page. Read the discussions before treating silence as approval.
Also in these discussions
No other repository is repeatedly linked in the same discussions.
This week on Hacker News
Nov 7–Nov 14 UTC · Direct repository links and separately labeled related project stories. Indexed through 11/14/2026, 3:56:07 PM UTC.
No direct repository links were found in the indexed HN discussions over the past seven days. Older discussions are available below.
Mentions over time
HN mentions by day3 dated mentions
Observed mentions: 2026-01-09 02:29:12 UTC to 2026-01-17 11:05:09 UTC.
Counts come from the repository’s dated source evidence. Index cutoff: 2026-11-02 08:16:59 UTC.
View mention counts and date ranges
| Period | Start (UTC) | End (exclusive, UTC) | Mentions | Submissions | Comments |
|---|---|---|---|---|---|
| Jan 9 | 2026-01-09 00:00:00 UTC | 2026-01-10 00:00:00 UTC | 1 | 1 | 0 |
| Jan 10 | 2026-01-10 00:00:00 UTC | 2026-01-11 00:00:00 UTC | 0 | 0 | 0 |
| Jan 11 | 2026-01-11 00:00:00 UTC | 2026-01-12 00:00:00 UTC | 0 | 0 | 0 |
| Jan 12 | 2026-01-12 00:00:00 UTC | 2026-01-13 00:00:00 UTC | 0 | 0 | 0 |
| Jan 13 | 2026-01-13 00:00:00 UTC | 2026-01-14 00:00:00 UTC | 0 | 0 | 0 |
| Jan 14 | 2026-01-14 00:00:00 UTC | 2026-01-15 00:00:00 UTC | 0 | 0 | 0 |
| Jan 15 | 2026-01-15 00:00:00 UTC | 2026-01-16 00:00:00 UTC | 0 | 0 | 0 |
| Jan 16 | 2026-01-16 00:00:00 UTC | 2026-01-17 00:00:00 UTC | 0 | 0 | 0 |
| Jan 17 | 2026-01-17 00:00:00 UTC | 2026-01-18 00:00:00 UTC | 2 | 0 | 2 |
What Hacker News says
3 sourcesI shared a repo on HN last week that lets you use remote execution with these kinds of script files autonomously - if you want to. It had some interesting negative and positive discussion.
The post mentioned Pete Koomen's install.md idea as an example use case. So now with this launch you can try it with a real intstallation script!
I think it's a really interesting idea worth experimentation and exploration. So it's a positive thing to see Mintlify launch this, and that it's already on Firecrawl.dev's docs!
We can all learn from it.
Show HN discussion of executable markdown here:
https://news.ycombinator.com/item?id=46549444
The claude-run tool lets you execute files like this autonomously if you want to experiment with it.
curl -fsSL https://docs.firecrawl.dev/install.md | claude-run --permission-mode bypassPermissions
Github repo:
Read the rest
https://github.com/andisearch/claude-switcher
This is still a very early-stage idea, but I'm really stoked to see this today. For anyone interested in experimenting with it, it's a good idea to try in a sandboxed environment.
Show HN: Executable Markdown files with Unix pipes
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.
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 (`run_tests.md`):
#!/usr/bin/env claude-run --permission-mode bypassPermissions
Run ./test/run_tests.sh and summarize what passed and failed.
Because stdin/stdout work like any Unix program, you can chain them:
cat data.json | ./analyze.md > results.txt
git log -10 | ./summarize.md
.
Read the rest
/generate.md | ./review.md > final.txt
Or mix them with traditional shell scripts:
for f in logs/\*.txt; do
cat "$f" | ./analyze.md >> summary.txt
done
This replaced a lot of Python glue code for us. Tasks that needed LLM orchestration libraries are now markdown files composed with standard Unix tools. Composable as building blocks, runnable as cron jobs, etc.
One thing we didn't expect is that these are more auditable (and shareable) than shell scripts. Install scripts like `curl -fsSL https://bun.com/install | bash` could become:
`curl -fsSL https://bun.com/install.md | claude-run`
Where install.md says something like "Detect my OS and architecture, download the right binary from GitHub releases, extract to ~/.local/bin, update my shell config." A normal human can actually read and verify that.
The (really cool) executable markdown idea and auditability examples are from Pete Koomen (@koomen on X). As Pete says: "Markdown feels increasingly important in a way I'm not sure most people have wrapped their heads around yet."
We implemented it and added Unix pipe semantics. Currently works with Claude Code - hoping to support other AI coding tools too. You can also route scripts through different cloud providers (AWS Bedrock, etc.) if you want separate billing for automated jobs.
GitHub: https://github.com/andisearch/claude-switcher
What workflows would you use this for?