mistivia

mistivia / basher

Public

Simple AI agent that just use `bash`

agentic agentic-ai agents ai-agents
25
0
69% credibility
Found Feb 27, 2026 at 19 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

Basher is an AI agent that automates coding tasks by generating and running bash scripts to interact with project files using an OpenAI-compatible language model.

How It Works

1
🔍 Discover Basher

You hear about Basher, a smart helper that tackles coding chores by reading, editing, and testing your project files.

2
📝 Describe your task

Write a clear note about the coding job you want done, like fixing a bug or adding a feature.

3
🔗 Connect the AI brain

Link a thinking service so Basher can understand and plan smart actions for your project.

4
🚀 Start the helper

Give Basher your task note and launch it – feel the excitement as it begins working on your code.

5
👀 Watch it work

See Basher explore your files, make careful changes, run checks, and adjust until everything is right.

✅ Task complete

Your coding project is now updated and verified, saving you hours of manual work.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 19 to 25 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is basher?

Basher is a simple agent that turns an OpenAI-compatible LLM into a CLI coding assistant, using bash scripts as its only tool for tasks like finding, reading, or editing files. Feed it a prompt like "finish the coding task in TASK.md," set your API key, and it loops: plans steps, runs scripts with fd, rg, and ed, shows output, then asks what next—until it outputs finish. Python-based, it needs a sandbox and handles context compression for long runs.

Why is it gaining traction?

This simple agent framework skips complex tool-calling for pure bash execution, making every move transparent and debuggable in your terminal. Developers hook on the minimalism—no VMs or custom agents, just LLM-driven scripts with built-in timeouts and verification prompts. It shines as a simple agentic AI example, teaching safe practices like "read before write" via a detailed system prompt.

Who should use this?

Ops engineers automating bash-heavy scripts, backend devs prototyping CLI tools, or indie hackers building simple agent workflows in sandboxes. Perfect for those tired of bloated agents, wanting a simple agent in n8n-style loops without Python dependencies beyond openai.

Verdict

With 18 stars and a 0.7% credibility score, Basher is raw and untested—great docs but run it in a VM only. Tinkerers get a fun, opinionated bash agent; skip for production.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.