whatisgithub

What is bashagt?

zhihumomo/bashagt — explained in plain English

Analysis updated 2026-05-18

54ShellAudience · developerComplexity · 3/5LicenseSetup · easy

In one sentence

A coding AI agent written entirely in bash, jq, and curl, meant to run on servers, phones, and other places that cannot install Node.js or Python.

Mindmap

mindmap
  root((Bashagt))
    What it does
      Pure bash AI agent
      File and shell tools
      Sub agents
    Tech stack
      Bash
      jq
      curl
    Use cases
      Servers without Node or Python
      Phone based coding
      Self modifying agent
    Audience
      Developers
      Sysadmins

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run an AI coding assistant on a production server that has no Node.js or Python installed.

USE CASE 2

Use an AI agent from a phone through Termux or iSH when a laptop is not available.

USE CASE 3

Ask the agent to read and modify its own bash source code to add a small feature.

USE CASE 4

Expose the agent as an HTTP service with streaming responses for other tools to call.

What is it built with?

Bashjqcurl

How does it compare?

zhihumomo/bashagtnelsonwerd/idea-to-ship-skillstotvs/engpro-advpl-tlpp-skills
Stars545454
LanguageShellShellShell
Setup difficultyeasymoderateeasy
Complexity3/53/53/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Needs bash 4.0+, jq, and curl, Termux additionally needs the coreutils package.

So what is it?

Bashagt is an AI coding agent written entirely in bash, meant to run anywhere bash itself can run. Most AI coding assistants need Node.js or Python installed, which works fine on a developer's own laptop but breaks down on machines that do not have those runtimes, such as locked down production servers or a phone. Bashagt's pitch is that bash, along with the small utilities jq and curl, is already present on nearly every Linux, macOS, WSL, Termux, and iSH system, so an agent built purely on top of those three pieces can run almost anywhere. The project itself is one very large bash script, made up of many functions, that acts as a full conversational coding agent. It can read, write, edit, and delete files, run shell commands, search the web, delegate work to sub agents for tasks like planning or reviewing code, track a to do list, and load extra skills. It keeps a long running memory across sessions, can be exposed as an HTTP service with streaming replies, and supports the Model Context Protocol for connecting to external tools. It also includes a hook system so specific events during a session can trigger custom actions, and a compression system for keeping long conversations from growing out of control. Because it is plain bash, it can also read and edit its own source code, so a user can ask it to add a small feature and it will attempt to implement, verify, and apply the change itself. To get started you only need bash 4.0 or newer, jq, and curl, on Android through Termux you also need the coreutils package. The author describes this as an early preview release, so bugs and missing pieces should be expected, and the project is licensed under Apache 2.0.

Copy-paste prompts

Prompt 1
Install Bashagt with only bash, jq, and curl and start an interactive session.
Prompt 2
Explain how Bashagt's sub agent system splits planning, exploring, and reviewing work.
Prompt 3
Ask Bashagt to add a --version flag to itself and verify the change.
Prompt 4
Set up Bashagt as an HTTP daemon with SSE streaming for another tool to connect to.

Frequently asked questions

What is bashagt?

A coding AI agent written entirely in bash, jq, and curl, meant to run on servers, phones, and other places that cannot install Node.js or Python.

What language is bashagt written in?

Mainly Shell. The stack also includes Bash, jq, curl.

How hard is bashagt to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is bashagt for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.