minicoder

Lightweight CLI agent for automating tasks

⚠️ Alpha version - be an early tester and supporter

$ # What can it do?
Coding, system admin, file management, data processing,
automation, and more. Just describe what you need.

$ # How lightweight?
• Single lightweight binary
• Uses only standard Unix tools (no Docker/containers)
• Runs on most POSIX systems
        
$ # See it in action
        
$ # Download & Install

$ # Option 1: Download pre-built binary (recommended)
$ # Available for Linux, macOS, and BSD
$ # → Download from itch.io

$ # Then install:
$ chmod +x minicoder
$ sudo mv minicoder /usr/local/bin/

$ # Option 2: Build from source
$ git clone https://github.com/andrewchambers/minicoder.git
$ cd minicoder
$ make
$ sudo make install PREFIX=/usr/local
        
$ # Quick Start
$ export OPENROUTER_API_KEY="your-key"  # (or OPENAI_API_KEY)
$ minicoder "Fix the bug in main.c"

$ # Choose a specific model
$ minicoder --model deepseek "Optimize this function"

$ # Focus on specific files
$ minicoder --focus 'src/*.js tests/*.js' "Add unit tests"
        
$ # Examples - Not just for coding!
$ minicoder "Find and delete duplicate files larger than 100MB"
$ minicoder "Convert all HEIC images to JPG preserving metadata"
$ minicoder "Fix compilation errors in this C project"
        
$ # Learn more
$ man minicoder
$ # View online docs