minicoder(1) General Commands Manual minicoder(1)

minicoder - AI-powered assistant for automating tasks on your machine.

minicoder [options] <request>

minicoder is a local AI-powered assistant that helps with coding, system administration, data analysis, and other tasks. It works iteratively, executing commands through a controlled shell environment while maintaining focus on specific files.

The assistant can read files, execute shell commands, track changes, and perform complex multi-step tasks autonomously until the task is complete or the iteration limit is reached.

--debug

Show debug output including the prompts sent to the AI model.

--max-iterations NUM

Set the maximum number of iterations the assistant will perform (default: 50).

--model MODEL

Specify which AI model to use. Overrides the MINICODER_MODEL environment variable. If neither is specified, the first available model from the configuration is used.

--files FILES

Files or glob patterns to include initially (space-separated).

--help, -h

Display help message and exit.

OPENROUTER_API_KEY

API key for OpenRouter service. When set, enables a selection of the latest models from various providers.

OPENAI_API_KEY

API key for OpenAI services. When set without OPENROUTER_API_KEY, enables a selection of the latest OpenAI models.

MINICODER_MODEL

Specify the default model to use. This overrides the default model selection but can still be overridden by the --model command line option.

~/.config/minicoder/models.json

User configuration file for AI models (optional).

/etc/minicoder/models.json

System-wide configuration file for AI models (optional).

minicoder can be configured to use different AI models and endpoints through configuration files. If no configuration file exists, the tool will use default models based on available API keys (OPENROUTER_API_KEY or OPENAI_API_KEY).

For detailed information about configuring models, including file format, available parameters, and examples, see minicoder-model-config(5).

0

Task completed successfully.

1

Task failed, was aborted, or an error occurred.

Request help with a coding task:

$ minicoder "Fix the memory leak in util.c"

Use a specific model with debug output:

$ minicoder --model gemini --debug "Add error handling to the parser"

Include specific files for the task:

$ minicoder --files "src/.c src/.h" "Refactor the authentication module"

Use a specific model with reasoning capabilities:

$ minicoder --model o3 "Optimize the database queries"

minicoder-model-config(5)

Maintained by the minicoder project contributors.

1980-01-01