{"repo":"chr15m/runprompt","free":true,"listed":false,"github":"https://github.com/chr15m/runprompt","clone":"git clone https://github.com/chr15m/runprompt.git","description":"Run LLM prompts from your shell","language":"Python","stars":443,"topics":["ai-agents","ai-development","anthropic","bash","bash-script","dotprompt","llm","ollama","openai","openrouter"],"license":"MIT","category":"ai-agents","readme_excerpt":"runprompt Run LLM .prompt files from your shell with a single-file Python script. A .prompt file contains the prompt and metadata (model, schema, config) in a single file. You can use it to run LLM prompts and get structured responses right in your shell. You can use it to automate AI workflows or build your own harness. Make prompts first-class artifacts. Check them into your repo and run them from the command line instead of making ad-hoc requests to AI chatbots. Quick start Examples Tools Template syntax Configuration Providers Caching Spec compliance Quick start Download the single-file script: Or you can run it directly without installing using uvx : Or install it via pip or uv to use it as a library: Create hello.prompt : Run it: (You can get an Anthropic key from here: see below for other keys.) Examples In addition to the following, see the tests folder for more example .prompt files. Basic prompt with stdin The special {{STDIN}} variable always contains the raw stdin as a string. Both {{STDIN}} and {{ARGS}} are always available; if input is JSON it's also parsed into individual variables. Inline prompts Run a template directly from the command line without creating a .prompt file using -p or --prompt : Command line arguments Pass arguments directly on the command line: The special {{ARGS}} variable contains all arguments after the prompt file, joined with spaces. The {{INPUT}} variable contains STDIN if provided, otherwise ARGS. Structured JSON output Extract structu","default_branch":null,"files":null,"tree":[],"storefront":"/r/chr15m","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/chr15m/runprompt/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}