Muness

A fully open-source, terminal-based micro agent harness built in Go. Highly portable and designed for secure scripting, system administration, and programming on local or remote systems.

Features

• Zero External Dependencies: Implemented strictly using Go's standard library (including custom OpenAI-compatible client and JSON-RPC servers).
• Extremely Portable: Builds into a single self-contained executable. Ideal for copy-and-run deployment on remote servers.
• Interactive Security Model: By default, all system operations (file edits, bash execution) prompt for user consent.
• Path Sandboxing: Validates and restricts file operations within the workspace directory, preventing directory traversal.
• Extensible Integration: Designed to export capabilities to external systems (such as Emacs) via JSON-RPC 2.0.

Getting Started

Prerequisites

• Go 1.18 or higher (tested on 1.26.4).

Building

To build the executable:

go build -o muness

This generates a single muness binary in the current directory.

Running

To run the agent in interactive terminal mode:

./muness --api-url "https://api.openai.com/v1" --api-key "your-key" --model "gpt-4o"

Configuration Options

You can configure the agent using flags or environment variables:

Directory Structure

├── main.go # Entry point & flag parsing
├── go.mod # Go module definition
├── README.md # Project documentation
└── pkg
 ├── agent
 │ └── agent.go # Core REPL and conversation coordinator
 ├── llm
 │ └── client.go # Lightweight OpenAI HTTP client wrapper
 └── tools
 └── tools.go # File manipulation & shell command execution tools