v2.1.0

Changelog

• 90995ea: feat(agent): add Pi write-confirmation + harden exit-code/SSH/install layers (@AllenMuu)
• 9ce583c: docs(changelog): mark v2.1.0 release (@AllenMuu)

v2.0.2

Changelog

• 212dd6f: feat(agent): add TRAE support for write-confirmation (@AllenMuu)
• fe76030: docs(readme): rewrite README with clearer agent init section (@AllenMuu)
• b4a49ee: docs(changelog): mark v2.0.2 release (@AllenMuu)
• 96f4226: Merge pull request #6 from AllenMuu/develop (@AllenMuu)

v2.0.1

Changelog

• 8cece8d: docs(changelog): mark v2.0.0 release (@AllenMuu)
• 970b59e: docs(readme): align zh README with english version (@AllenMuu)
• 7985044: docs(skill): tighten --yes to request confirmation, not waive it (@AllenMuu)
• f5fa270: feat(cli): add agent init + one-shot installer for per-agent write confirmation (@AllenMuu)
• 4c7cff8: Merge pull request #4 from AllenMuu/develop (@AllenMuu)
• 39558f1: feat(cli): warn on untrusted project config + require --yes for trust (@AllenMuu)
• 11b296b: docs(readme): document config resolution + project-level trust behavior (@AllenMuu)
• 30708b7: docs(changelog): mark v2.0.1 release (@AllenMuu)
• 1c8dbe3: Merge pull request #5 from AllenMuu/develop (@AllenMuu)

v2.0.0

[2.0.0] - 2026-07-27

Breaking

• SELECT 默认安全 cap 1000:不带 LIMIT 的 SELECT 现在默认只返回 1000 行,meta.truncated=true 标记截断。需全表用 --no-limit;调默认值用 config default_limit 或 env MYSQL_CLI_DEFAULT_LIMIT;显式精确行数用 --limit N。动机:实测裸跑 4.4 万行表 = ~900 万 token(45 个 200K context 窗口),会当场撑爆 agent 会话。
• SELECT 的 JSON 信封省略 rows_affected(对 SELECT 恒为 0);改用 meta.truncated/meta.limit。DML/DDL 信封不变。
• skill 安装迁移至 vercel-labs/skills 生态:mysql-cli init、mysql-cli skill install/list/version/check 及 scripts/install-skills.sh 全部移除。改用 npx skills add AllenMuu/mysql-cli 安装 skill(支持 75+ agent,交互式选 agent/scope/install method)。无 Node 环境可手动复制仓库 skills/ 目录。skill 版本真相源从二进制内嵌迁移至仓库 skills/*/SKILL.md frontmatter。

Added

• --format jsonl:每行一个 JSON 对象,比 json 紧凑,适合 agent。
• --no-limit flag。
• config default_limit / env MYSQL_CLI_DEFAULT_LIMIT。
• Project-level config:config init/trust/path/show 子命令(trust store + 向上项目发现)。
• Grouped help output with agent-oriented notes.
• .well-known/agent-skills/index.json:vercel-labs/skills 首选发现机制,声明 3 个 skill。

Changed

• Skill 内容统一为英文;3 个 skill 版本对齐到 2.0.0。
• 内部:移除 internal/agents、internal/skillscheck、bundle.go(//go:embed skills)—— skill 安装委托 vercel-labs/skills 生态,二进制不再内嵌 skill。

v1.2.0

Changelog

• c54374e: ci: bump release workflow node-version 20 -> 24 (Node 20 deprecated on runners) (@AllenMuu)
• 6207a79: feat(cli): add --version flag and version subcommand (ldflags-injected) (@AllenMuu)

v1.1.0

Changelog

• 3bd1b85: docs(readme): add version badge (auto latest release) (@AllenMuu)
• 08ebca0: docs(readme): split quick start into human and AI agent sections (@AllenMuu)
• 3184ed6: docs(spec): add npx install + init multi-agent design (@AllenMuu)
• 2e335d2: docs(plan): add Plan 1 implementation plan for init + agents (Go side) (@AllenMuu)
• e1ff1df: docs(plan): remove unused os import hack from Task 6 init test (@AllenMuu)
• 7053f30: feat(agents): add skill merge primitives (SkillBody/MergeInstructionFile/makeMDC) (@AllenMuu)
• 5713370: style(agents): gofmt merge primitives (trailing newlines) (@AllenMuu)
• 06867db: feat(agents): add agent detection (Detect) mirroring install-skills.sh (@AllenMuu)
• e9e3e0b: feat(agents): add native installers for claude and cursor (@AllenMuu)
• 8adbab2: fix(agents): return copySkillTree RemoveAll error; strengthen cursor DryRun/guard tests (@AllenMuu)
• 3be3e32: feat(agents): add merge installers for codex/opencode/copilot/windsurf/aider (@AllenMuu)
• 66ee2c0: feat(agents): add Install dispatcher and Run selection (auto/all/list) (@AllenMuu)
• a4adf7d: test(agents): assert Detected flag in SelAll and comma-list modes (@AllenMuu)
• e68e748: feat(cli): add mysql-cli init command to install skills into detected agents (@AllenMuu)
• 7e2a533: style(cli): gofmt errors_test.go (pre-existing trailing blank line) (@AllenMuu)
• b74c74d: docs: deprecate install-skills.sh in favor of mysql-cli init (@AllenMuu)
• 6c1cf89: fix(agents): JSON field name->name per spec; skipped status when no paths written; writeMerged ReadFile error handling (@AllenMuu)
• 7e14065: feat: mysql-cli init command + internal/agents package (Plan 1) (@AllenMuu)
• e13e977: docs(plan): add Plan 2 implementation plan for npx distribution (@AllenMuu)
• 652c89c: feat(npm): add @allenmuu/mysql-cli wrapper (postinstall downloader + tests) (@AllenMuu)
• 48de4ed: feat(npm): add bin/mysql-cli.js shim (install command + binary exec) (@AllenMuu)
• 6799b40: fix(npm): use node --test (default discovery) - node --test test/ is broken on Node 20+ (@AllenMuu)
• 3e6bca8: ci: add goreleaser config for cross-platform binary releases (@AllenMuu)
• 3239390: ci: add release workflow (goreleaser on tag, npm publish gated by NPM_PUBLISH) (@AllenMuu)
• 64ea17f: docs(readme): add npx one-line install as recommended option (@AllenMuu)
• de6fc89: fix(npm): add download timeout; reorder extraction checks; clean up archive on failure (@AllenMuu)
• 8b15817: feat: npx distribution for mysql-cli (@allenmuu/mysql-cli + GoReleaser) (Plan 2) (@AllenMuu)

v1.0.0

First release of mysql-cli.

What it is

A Go CLI that lets any shell-capable AI agent query MySQL — no MCP runtime required. A drop-in replacement for designcomputer/mysql_mcp_server: all read/write capabilities re-exposed as plain subcommands, with JSON by default and stable exit codes.

Highlights

• Agent-first — JSON envelope {success,data,error:{code,message}} + numeric exit codes (2–10), designed to be parsed by agents
• Tiered safety model — read-only by default; DML needs --write, DDL needs --write --ddl, destructive ops need --yes; identifier allowlist + multi-statement rejection, all checked before a DB connection is opened
• AI agent skills — 3 skills (mysql-shared / mysql-query / mysql-schema) with a shared auto-load pattern (mirrors larksuite/cli)
• Multi-agent installer — ./scripts/install-skills.sh supports 7 agents: Claude Code, Cursor, Codex CLI, OpenCode, GitHub Copilot, Windsurf, Aider
• Embedded skills — //go:embed bundles skills into the binary; mysql-cli skill install installs with zero external deps; mysql-cli skill check reports version drift
• CI — skill-format-check + installer tests (38 assertions covering all 7 agents)

Install

go install github.com/AllenMuu/mysql-cli/cmd/mysql-cli@latest

Install skills for your agent

./scripts/install-skills.sh              # auto-detect
./scripts/install-skills.sh --agent all  # all 7 agents

See the README for full docs.