

Bash Agent
A minimal AI agent loop written entirely in bash in under 100 lines of code. It calls LLMs via OpenRouter, DeepSeek, or OpenAI, runs tools (bash, read, write, edit), and can import skills.
Features
Properties
- Lightweight
- Minimalistic
Features
- No Tracking
- Ad-free
- AI-Powered
- AI Chatbot
- Chat Bot
Tags
Bash Agent News & Activities
Recent activities
- POX updated Bash Agent
- acting-dipped-tile added Bash Agent
acting-dipped-tile added Bash Agent as alternative to SynthTek, OpenClaw, NanoClaw and Manus
Bash Agent information
What is Bash Agent?
Bash Agent is an interactive REPL agent loop written in exactly 76 lines of pure bash. It reads user input, sends it to an LLM via an OpenAI-compatible API endpoint, dispatches any tool calls the model returns (bash, read, write, edit), feeds results back into the conversation history, and loops until the user types exit. There is no package.json, no node_modules, no build step, no configuration file, and no external runtime — it runs on any system with bash 3+, curl, and jq.
The entire state machine (provider detection from environment variables, system prompt construction with optional skill file injection, tool execution with workspace path confinement, conversation history management, and the LLM request loop) is implemented as straight-line bash with a single run() helper for dispatching tool calls. The tool definitions are a JSON array fed directly to the model's tools parameter. A companion 63-line script, skills.sh, lists and imports pi agent skill files, which agent.sh reads and injects into the system prompt by stripping their YAML front matter. Total project footprint: two files, 139 lines, zero dependencies beyond standard POSIX utilities.



