Bash Agent icon
Bash Agent icon

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.

Bash Agent screenshot 1

Cost / License

  • Free
  • Open Source (MIT)

Application type

Platforms

  • Mac
  • Linux
0likes
0comments
0articles

Features

Properties

  1.  Lightweight
  2.  Minimalistic

Features

  1.  No Tracking
  2.  Ad-free
  3.  AI-Powered
  4.  AI Chatbot
  5.  Chat Bot

 Tags

Bash Agent News & Activities

Highlights All activities

Recent activities

Bash Agent information

  • Developed by

    AU flagkane-mar
  • Licensing

    Open Source (MIT) and Free product.
  • Alternatives

    23 alternatives listed
  • Supported Languages

    • English

AlternativeTo Category

AI Tools & Services

GitHub repository

  •  1 Stars
  •  0 Forks
  •  0 Open Issues
  •   Updated  
View on GitHub

Popular alternatives

View all
Bash Agent was added to AlternativeTo by acting-dipped-tile on and this page was last updated .
No comments or reviews, maybe you want to be first?

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.

Official Links