Introduction

Run AI prompts like programs with executable markdown, Unix pipes, and cross-cloud provider switching

Andi 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.

# Run Claude Code interactively: any model or provider
ai                                        # Regular Claude subscription (Pro, Max)
ai --aws --opus --team --resume           # Resume chats on AWS w/ Opus 4.6 + Agent Teams
ai --ollama --bypass --model qwen3-coder  # Ollama local model with bypassPermissions set
ai --vercel --model openai/gpt-5.2-codex  # Vercel AI Gateway with 100+ models

# Run prompts like programs
ai --azure --haiku script.md

# Script automation
cat data.json | ./analyze.md > results.txt

Quickstart

Get started in 5 minutes with your first executable AI script

Installation

Detailed installation guide for all platforms

Executable Markdown

Create markdown files that run as AI programs

Provider Switching

Switch between AWS, Azure, Vertex, Ollama, and more

Overview

Switch between your Claude Code subscription and different clouds + models: AWS Bedrock, Google Vertex, Azure, Vercel + Anthropic API. Supports free local models (Ollama, LM Studio) and 100+ alternate cloud models via Vercel AI Gateway or Ollama Cloud. Swap and resume conversations mid-task to avoid rate limits and keep working.

Key Features

Executable Markdown

Create markdown files with #!/usr/bin/env ai shebang for script automation. Run them directly like any executable program.

#!/usr/bin/env ai
Analyze my codebase and summarize the architecture.

Make it executable and run:

chmod +x task.md
./task.md

Unix Pipe Support

Pipe data into scripts, redirect output, chain in pipelines — standard Unix semantics for AI automation.

cat data.json | ./analyze.md > results.txt    # Pipe in, redirect out
git log -10 | ./summarize.md                  # Feed git history to AI
./generate.md | ./review.md > final.txt       # Chain scripts together

Cross-Cloud Provider Switching

Use Claude on AWS, Vertex, Azure, Anthropic API + switch mid-conversation to bypass rate limits. Also supports local models and Vercel AI Gateway.

ai --aws                          # AWS Bedrock
ai --vertex                       # Google Vertex AI
ai --ollama                       # Ollama (local, free)
ai --vercel                       # Vercel AI Gateway

Model Tiers

Simple tier selection across all providers: --opus/--high, --sonnet/--mid, --haiku/--low

ai --opus task.md                 # Opus 4.6 (most capable)
ai --sonnet task.md               # Sonnet 4.6
ai --haiku task.md                # Haiku 4.5 (fastest)

Session Continuity

--resume picks up your previous chats with any model/provider. Switch providers mid-conversation when you hit rate limits.

# Hit rate limit on Claude Pro
claude
# "Rate limit exceeded. Try again in 4 hours."

# Continue immediately with AWS
ai --aws --resume

Script Variables

Declare variables with defaults in YAML front-matter. Users override them from the CLI without editing the script.

#!/usr/bin/env -S ai --haiku
---
vars:
  topic: "machine learning"
  style: casual
  length: short
---
Write a {{length}} summary of {{topic}} in a {{style}} tone.

./summarize.md                          # uses defaults
./summarize.md --topic "AI safety"      # overrides one variable

What it Does

• Executable markdown with #!/usr/bin/env ai shebang for script automation
• Unix pipe support: pipe data into scripts, redirect output, chain in pipelines
• Cross-cloud provider switching: use Claude on AWS, Vertex, Azure, Anthropic API + switch mid-conversation to bypass rate limits. Also supports local models and Vercel AI Gateway
• Model tiers: --opus/--high, --sonnet/--mid, --haiku/--low
• Session continuity: --resume picks up your previous chats with any model/provider
• Non-destructive: plain claude always works untouched as before

From Andi AI Search. Star the GitHub repo if it helps!

Supported Platforms

• macOS 13.0+
• Linux (Ubuntu 20.04+, Debian 10+)
• Windows 10+ via WSL

Providers

Provider	Flag	Type	Notes
Ollama	--ollama / --ol	Local	Free, no API costs, cloud option
LM Studio	--lmstudio / --lm	Local	MLX models (fast on Apple Silicon)
AWS Bedrock	--aws	Cloud	Requires AWS credentials
Google Vertex AI	--vertex	Cloud	Requires GCP project
Anthropic API	--apikey	Cloud	Direct API access
Microsoft Azure	--azure	Cloud	Azure Foundry
Vercel AI Gateway	--vercel	Cloud	Any model: OpenAI, xAI, Google, Meta, more
Claude Pro	--pro	Subscription	Default if logged in

Next Steps

Get Started

Follow the quickstart guide to run your first executable AI script

Install

Complete installation instructions and configuration