Girvent

A minimal coding agent harness in Nim.

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

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..)

nimble build

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)

Run the agent:

./girvent

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

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.