flash

A couple weeks ago I was writing more bash than I care to admit and the "language"(if you can call it that) is quite useful.

I decided to build an agent harness in it. flash is a lightweight AI agent framework in roughly 300 lines of bash. It uses Ollama to query a llm and lets the model use shell tools to complete tasks.

How it works

Flash uses a two-model architecture:

Tools are just shell scripts

Every tool is a standalone .sh file in tools/:

Why?

Most agent harnesses are big and cumbersome. I wanted to run something that would be quick and easy to use locally. flash lives in my local file system uses a local model. It's a bash script that is self modifying and almost any consume grade laptop could rrun.

The whole thing fits in a Docker image based on Alpine with just bash, curl, and jq.