Girvent

A minimal coding agent harness in Nim.

Requirements

• Nim >= 2.2.8
• Nimble
• bash
• ripgrep
  • brew install ripgrep or similar on your OS

Setup

1. Install dependencies:

   nimble install

2. Create a .env file with your (Alibaba Model Studio Coding Plan) API key:

   API_KEY=your_api_key_here

   (or put it in your .bashrc etc via export GIRVENT_API_KEY=sk-etc..)

Build

nimble build

Install

ln -s $PWD/girvent /usr/local/bin/girvent

(or similar, up to you but if you want to use it outside of where you built it, this is needed)

Usage

Run the agent:

./girvent

Commands

Command	Description
/help	Show available commands
/clear	Clear conversation history
/context	Show token usage
/model	Show or switch model
/quit	Exit

Tools

The agent has access to:

• read_file - Read file contents
• write_file - Write to a file
• edit_file - Replace a unique substring in a file
• grep - Search file contents with a regex pattern using ripgrep
• list_directory - List directory contents
• exec_bash - Run shell commands

AGENTS.md

You can create an optional AGENTS.md file in the current working directory to provide the agent with knowledge of CLI tools available on your system. If the file exists, its contents will be appended to the system prompt at startup.