Antigravity Local Shell Agent 🪐

A premium, high-speed, local developer agent CLI similar to Claude Code or Gemini CLI. It runs entirely on your local machine using Bun and Ollama with the glm-4.7-flash model.

It is equipped with tools to execute shell commands, read/write files, and recursively search codebases, protected by an interactive approval gate.

Features

• ⚡ Extremely Fast: Driven by Bun's high-performance runtime and optimized spawning APIs.
• 🛡️ Interactive Safety Gate: Modifying actions (shell execution, writing files) prompt you for permission:
  • y (yes): Run this command this time.
  • n (no): Deny the action (sends error back to LLM so it can retry or try another way).
  • a (always): Auto-approve all actions for the rest of the CLI session.
  • q (quit): Exit the CLI immediately.
• 💬 Live Streaming: Text reasoning is streamed to your terminal character-by-character.
• 📁 System Tools:
  • execute_command: Run any CLI command on your system.
  • read_file: Read entire files or specific line ranges.
  • write_file: Create or edit files.
  • list_dir: View workspace files.
  • search_grep: Find code/text patterns recursively across files.

Setup & Running

Prerequisites

1. Ollama installed and running.
2. The glm-4.7-flash model downloaded in Ollama:

   ollama pull glm-4.7-flash

3. Bun installed on your machine.

Quick Run (NPM/Bunx)

Run the agent instantly without installing locally using bunx or npx:

# Using bunx (Recommended)
bunx @codebam/ollama-shell-agent

# Using npx (runs under local Bun installation)
npx @codebam/ollama-shell-agent

Specifying a Model

By default, the agent uses glm-4.7-flash:latest. You can dynamically specify any other model that supports tool calls (e.g., gemma4, llama3-groq-tool-use):

# Using the model flag
bunx @codebam/ollama-shell-agent --model gemma4
# Or using the shorthand
bunx @codebam/ollama-shell-agent -m gemma4

Alternatively, configure the OLLAMA_MODEL environment variable:

export OLLAMA_MODEL=gemma4
bunx @codebam/ollama-shell-agent

Launching Locally (Development)

To run or develop locally:

bun start

Or:

bun run src/index.ts

Special Commands inside the CLI

• clear: Clears conversation history and terminal screen.
• exit or quit: Terminate the agent cleanly.

Compiling to a Standalone Binary

You can compile this agent into a single, lightning-fast native binary that you can add to your system path:

bun build --compile src/index.ts --outfile ollama-shell-agent

Then move it to your path:

sudo mv ollama-shell-agent /usr/local/bin/

Now you can call it from anywhere simply by typing ollama-shell-agent!