Mink

Mink is a lightweight AI coding agent for local workflows. It supports interactive CLI usage and Telegram Bot mode.

The design goal is simple: keep the core small, fast, and easy to extend. Instead of hiding everything behind a heavy framework, Mink focuses on a minimal runtime, straightforward configuration, and a few practical extension points such as skills, external tools, and background jobs.

Install

go install github.com/abcdlsj/mink@latest

You can also download a binary from Releases.

Quick Start

1. Create a config file:

mkdir -p ~/.mink
cp config.example.toml ~/.mink/config.toml

2. Edit ~/.mink/config.toml and set at least your model and API key.

3. Start Mink:

mink

See config.example.toml for a full example.

Commands

mink                # start interactive mode
mink tg             # start Telegram Bot mode
mink version        # show version

Override config from flags:

mink -p openai -m gpt-4o -k <api_key>

Deploy (Telegram Bot)

Linux (systemd):

cp deploy/mink.service ~/.config/systemd/user/
systemctl --user enable --now mink

macOS (launchd):

cp deploy/com.mink.agent.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.mink.agent.plist

Paths

• ~/.mink/config.toml — main config
• ~/.mink/skills/ — custom skills
• ~/.mink/ext/ — external executable tools
• ~/.mink/SOUL.md — extra behavior guidance

License

MIT