Waveloom

Waveloom is an open-source Go-based terminal coding agent created by Menfre01. It is designed to autonomously inspect repositories, generate code, and execute development tasks directly from the command line while maintaining explicit control over file modifications and shell execution. During day-to-day use, Waveloom presents an interactive Terminal User Interface (TUI) featuring automatic terminal background theme detection and structured agent loops aligned with ACP-style execution. Developers submit natural language tasks, and Waveloom iterates through planning and execution steps, generating diff previews for file edits and writes inside approval dialogs prior to applying modifications. What sets Waveloom apart is its built-in operating-system-level sandbox isolation layer, leveraging Bubblewrap (`bwrap`) on Linux and `seatbelt` on macOS alongside binary decision permissions. It also supports cross-platform operations including Windows with Git Bash integration and includes modular agent skills and an internal evaluation framework (`eval/llmedit`). Waveloom is open source and hosted on GitHub under active community development. It uses environment-based configuration via `.env` files and an interactive setup wizard to configure underlying LLM endpoints and credentials.

Tags: ai agent, cli, coding agent, OpenSource, terminal

Visit Waveloom

Key features

  • OS-Level Sandboxing — Runs shell operations in isolated execution environments using Bubblewrap (bwrap) on Linux and seatbelt on macOS. - Interactive TUI with Approval Previews — Displays real-time file diffs and command previews directly inside TUI approval modals before changes touch disk. - Turn-and-Step Agent Loop — Implements an iterative reasoning and tool execution loop modeled on modern agent architectures. - Configurable Agent Skills — Provides modular skills support for workflows like issue tracking, triage labeling, and domain-specific layouts. - Cross-Platform Compatibility — Supports Linux, macOS, and Windows environments, including native Git Bash integration for shell tooling. - Interactive Setup Wizard — Simplifies initial onboarding through interactive setup prompts and standard .env configuration.

Use cases

Use Case: Sandboxed Terminal Refactoring A developer needs an agent to perform multi-file code refactoring and test executions without risking accidental system changes. Waveloom isolates shell execution via bwrap or seatbelt while providing clear visual diff previews in the TUI approval dialog before committing any writes to disk.

Use Case: Cross-Platform Task Automation Engineers operating across diverse OS environments (Linux, macOS, or Windows via Git Bash) can run Waveloom to automate repetitive codebase changes, dependency upgrades, or test suite fixes using standard command-line tooling.

Use Case: LLM Code Editing Evaluation Developers evaluating model performance on tool calling and source code generation can leverage Waveloom's internal eval/llmedit suite to test editing fidelity and execution loops across different task benchmarks.

Who it is for

Waveloom is built for software engineers, DevOps practitioners, and Go developers who prefer a TUI-driven workflow and demand strong OS-level sandboxing for terminal-based AI agents. It is not intended for non-technical users or developers seeking IDE-embedded extension panels without terminal interaction.

Install guide

Installation Clone the repository and build the binary using the Go toolchain (standard build method for Go CLI repositories): bash git clone https://github.com/Menfre01/waveloom.git cd waveloom go build -o waveloom ./cmd

First Run Initialize your environment file from the provided template and run the setup wizard: bash cp .env.example .env # Add your LLM API keys and model configurations to .env ./waveloom

Example Session Run Waveloom directly in your project root to initiate an interactive coding session: bash ./waveloom "Inspect pkg/tui, fix failing tests, and prompt for confirmation before modifying files"

Part of CLI Coding Agents

Categories: AI Coding Agents, Code Assistants, Developer Tools

Related CLI agents

  • Gemini CLI — Gemini CLI is an open-source terminal coding agent maintained under the Google Gemini organization (google-gemini/gemini-cli). It provides a command-line and…
  • Open Interpreter — Open Interpreter is an open-source terminal coding agent maintained by Killian Lucas and the Open Interpreter community. It is designed…
  • Crush — Crush is an open-source terminal coding agent created by Charm (Charmbracelet), the team behind popular Go terminal UI libraries like…
  • Codel — Codel is an open-source, self-hosted autonomous software engineering agent created by semanser. It combines an execution backend, an interactive web…
  • San — San is an open-source terminal coding agent developed by the genai-io organization on GitHub. Built natively in Go, San is…
  • amux — amux is an open-source agent harness and session multiplexer developed by Mixpeek. Built in Rust, it is designed to manage,…
  • AI Tools
  • Categories
  • Industries
  • CLI Coding Agents
  • MCP Servers
  • MCP Categories