v2.0.0
v2.0.0
The first major release of the actively maintained fork. Mods is now an AI
agent for your terminal — not just a pipeline tool. It reads and edits
files, runs shell commands, searches the web, and chains tool calls to finish
a task, with a review step that keeps you in control of anything risky.
⚠️ Breaking Changes
- Module renamed from
github.com/charmbracelet/modsto
github.com/panjie/mods. Update yourgo.modand import paths. - Removed flags:
--prompt(-P) and--prompt-args(-p). The-p
short flag is now used for--plan. - Default
--helptrimmed to everyday options; advanced and
configuration-first options moved to the new--help-all.
✨ Highlights
- Plan mode (
--plan/-p): generate a detailed plan for your approval
before Mods touches any files or runs any commands. - Arrow-key navigation in approval prompts — accept, deny, or save a
per-conversation rule without leaving the home row. - Multi-provider reasoning (
--reasoning on|off|auto,-T): unified
reasoning config works across OpenAI, Anthropic, DeepSeek, GLM, Qwen, Kimi,
and MiniMax, with distinct rendering of the model's thinking.
🔌 New Providers
Added four OpenAI-compatible providers with model templates and reasoning
support:
- GLM —
glm-5.2 - Qwen —
qwq-plus,qwen3-plus - Kimi —
kimi-k2 - MiniMax —
MiniMax-M3
Model list refreshed across OpenAI, Anthropic, Google, Cohere, DeepSeek,
OpenRouter, and Ollama.
🔒 Safety & Stability
- Closed critical security gaps in
fs_apply_patch, Google auth, and web
search input handling. - Hardened tool/shell execution safety and concurrency.
- Fixed cache atomic writes, provider stream contracts, and flag parsing.
- Plan output is now preserved across the approval flow.
🛠️ CLI & DX
--help-allgroups every flag by purpose (Model, Session, I/O, MCP,
Tools, Debug, …).- Expanded CLI examples covering image, web search, plan, review, MCP, and
reasoning. - Release archives expanded to Linux and macOS (previously Windows-only).
📚 Documentation
- README rewritten to showcase Mods' agent capabilities, with high-impact
examples for code review, refactoring, debugging, and scaffolding. - Removed stale standalone docs and the legacy
fancinessoption.
Full Changelog: v1.0.1...v2.0.0