mini-code-cli 0.0.8.0

Minimal Coding CLI

A minimal coding agent cli

No bloat, no dependencies, no tracking, no telemetry...

Purpose: A no bloat, minimal coding cli, to enjoy experimenting and researching...

Getting started:

Installation (from pypi)

pip3 install mini-code-cli

Run agent:

1. Basic usage: (get local LLM running (e.g. via SGLang or Vllm))

mini-code #run the agent using `localhost:30000/v1` model

2. Custom API based model:

export MINI_CODE_API_KEY="sk-YOUR_API_KEY"
mini-code --url "https://api.deepseek.com" --model "deepseek-v4-flash"

Auto-mode, Agent.md, Shell Enabled mode and a specific allowed dir:

mini-code --enable-shell --auto-mode --agent-md "./skill.md" --allowed-dir "./" --ask-permission --system-prompt "Your awesome new system prompt..."

• auto-mode: the agent will continue querying the LLM and executing tools, until no more tool calls are possible
• agent.md: this will read an agent.md file with the specified name (e.g. ./skill.md)
• shell-enabled: Be careful: This will allow the agent to execute shell commands. Specifically, there is no permission checks.
• allowed-dir: this specifies which dirs the agent can read and write from, that does not stop the shell comands!
• ask-permission: asks user permission before every tool call.
• system-prompt: you can override the default prompt by using a string. (Not Agent.md is always appended after the system prompt.)

3. Try a prompt:

Write an agent.md file for me that helps an LLM write efficient triton kernels, given a reference implementation.

4. Get help:

mini-code --help

(C) Nikolai Rozanov, 2026 - Present