Pure-bash LLM 代理内核

Core Dependencies

Bashagt has only three dependencies — installable with a single package manager command on any mainstream platform:

Additionally, Termux (Android) requires the coreutils package (for realpath/nl and other GNU tools). See platform-specific instructions below.

---

Install dependencies

brew install bash jq curl

Homebrew-installed bash lives at `/opt/homebrew/bin/bash` (Apple Silicon) or `/usr/local/bin/bash` (Intel). Bashagt uses `#!/usr/bin/env bash`, so as long as the Homebrew path appears before `/bin` in `/etc/paths`, the new version will be used automatically.

Install core dependencies

pkg install bash jq curl git coreutils

Installation: Platform Guides

Installation is uniform across all platforms — three steps:

1. Get the script   →   2. Install dependencies   →   3. ./bashagt --install

--install automatically: creates the ~/.bashagt/ directory tree, generates a default config file, registers bash/zsh hotkeys, and adds bashagt to your PATH.

---

🐧 Linux / Unix (General)

Applies to all mainstream Linux distributions (Debian/Ubuntu, RHEL/CentOS, Arch, Alpine, openSUSE, etc.) and traditional Unix.

Step 1: Install dependencies

```bash

Install Homebrew (if not already installed)

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Verify bash version (Termux installs bash 5.x by default)

bash --version

| Extra package | Purpose |
|--------------|---------|
| `coreutils` | Provides `realpath`, `nl`, and other GNU tools that Bashagt depends on. **Required.** |
| `termux-api` | Android API bridge (optional). Enables Bashagt to control phone hardware via Termux-API tools — see "Termux-API Integration" below. |

**Step 3: Install Bashagt**

> **Storage access**: Termux can only access the shared internal storage directory `~/storage/shared/` by default. To access external SD cards or other locations, run `termux-setup-storage` to grant storage permissions.

---

##### 🔧 Mounting External Storage

To work with external SD cards or USB storage devices in Termux:

🚀 Quick Start

📋 Use Cases

---

🔧 Usage Examples

Live Demo

Say you want Bashagt to show token usage stats for the current session. You just say:

bashagt> Add a /stats slash command that shows token usage and API call count for this session

Bashagt will navigate its own source to find where slash commands are registered (_slash_dispatch), locate the statistics variables (TURN_TOKENS_IN, TURN_TOKENS_OUT…), and insert the new command implementation. It'll even run bash -n for a syntax check when done.

---

Configure API Key

After installation, edit ~/.bashagt/settings.json with your API details:

{
  "api_url": "https://api.deepseek.com/anthropic",
  "api_key": "sk-your-api-key-here",
  "model": "deepseek-chat",
  "max_tokens": 8192,
  "thinking_budget": 16384
}

Compatible backends: Bashagt uses the Anthropic Messages API protocol. The default points to DeepSeek. You can also switch to: - Anthropic official: "api_url": "https://api.anthropic.com", "model": "claude-sonnet-4-20250514" - Other OpenAI-compatible endpoints: such as Ollama, vLLM, LiteLLM, or other locally-deployed models

Recommended — secure approach: Use environment variables instead of storing the API key in a config file:

export BASHAGT_API_KEY="sk-your-api-key-here"

Environment variables take priority over config files (4-tier config: defaults → settings.json → project settings.json → environment variables).

---

🔒 Air-Gapped / Offline Environments

The most extreme scenario: a machine physically isolated from the internet, but with an internal LLM API available (e.g., Ollama or vLLM):

```bash

Configure the internal API endpoint

export BASHAGT_API_URL="http://192.168.1.100:11434/api/chat" export BASHAGT_API_KEY="ollama"

Config generation

cat schema.json | bashagt --oneshot --stream ```

⚙️ Configuration

Bashagt uses a 4-tier configuration priority (later overrides earlier):

Defaults  →  ~/.bashagt/settings.json  →  Project .bashagt/settings.json  →  Environment variables

---

🌐 As a Backend API Service

You want to embed LLM conversation capabilities in your app, without pulling in a massive Python/Node dependency chain:

```bash

Daemon API

```bash

Update package index (iSH uses the Alpine package manager)

apk update apk add bash jq curl git coreutils

🏭 Production Troubleshooting

A sudden 502 in production. You SSH in, facing gigabytes of logs and config files changed who-knows-when:

$ ssh production-server
$ cd /var/log/app
$ bashagt

bashagt> What are the top 5 errors in the nginx error log from the last hour?
bashagt> Check /etc/nginx/nginx.conf for anything that could cause a 502
bashagt> Compare the three configs under /etc/nginx/sites-enabled/ — find the inconsistencies

No special tools needed — the server already has bash. The entire investigation happens in one terminal session.

---