Files
better-claude-config/CHANGELOG.md
T
the_og 38e9cf2b26
CI / Lint (ruff) (pull_request) Successful in 13s
CI / Tests (py3.10 / ubuntu-latest) (pull_request) Successful in 12s
CI / Tests (py3.12 / ubuntu-latest) (pull_request) Successful in 11s
CI / Tests (py3.13 / ubuntu-latest) (pull_request) Successful in 11s
CI / Catalog signature (pull_request) Successful in 7s
CI / Tests (py3.12 / windows-latest) (pull_request) Successful in 1m11s
docs: add CHANGELOG.md (Keep a Changelog); Unreleased → 1.4.0
Starts a per-release changelog. The Unreleased section captures everything
merged since v1.3.0 (ssh-mcp v2 support, sidecar detect/edit, version pin,
permission pre-flight, hot-reload, light theme, visible update checker,
move-to-env, cross-client phase 1) with the ssh-mcp-is-breaking-upstream /
BCC-is-additive distinction called out. Past releases backfilled from tags.
2026-08-13 15:27:01 +00:00

4.4 KiB

Changelog

All notable changes to BetterClaudeConfig are recorded here. The format is based on Keep a Changelog, and this project follows Semantic Versioning: breaking changes bump the major, new features bump the minor, fixes bump the patch.

When you open a PR, add a line under [Unreleased]. At release time, that section is renamed to the new version + date and a fresh [Unreleased] is started.

[Unreleased] — targeting 1.4.0

⚠️ Using the ssh-mcp server? Upstream ssh-mcp shipped a breaking v2: it removed the --password, --sudoPassword, --suPassword and --disableSudo command-line flags, and it now reads a config.toml sidecar file that overrides your command-line arguments. A config written for v1 crashes on v2's startup. This release adds tools to detect and fix that. BetterClaudeConfig itself has no breaking changes — your existing configs keep working; nothing is changed without your click.

Added

  • ssh-mcp v2 flag migration. Detects the credential flags v2 removed and one-click-moves each into the environment variable ssh-mcp now reads (--password → SSH_MCP_PASSWORD; --sudoPassword / --suPassword → SSH_MCP_SUDO_PASSWORD). Also flags --maxChars=none, whose meaning changed between versions.
  • Sidecar-config awareness. When a server reads a separate config file (ssh-mcp's config.toml), BCC shows where that file actually lives on your platform and warns when your command-line args are inert because the file takes precedence — including when a file sits at the wrong, documented-but- unused path.
  • In-app sidecar editor. Edit that external config from inside BCC — pick-lists for known fields, a raw-text fallback — written atomically with a timestamped backup and locked to 0600. No dropping to a terminal.
  • Live hot-reload. External changes to a sidecar (or to your Claude config) now surface without restarting BCC.
  • Version pinning for npx servers. Spots servers launched with -y / @latest that resolve a fresh version every run, shows the version currently resolved, and offers a one-click Pin to this version — with a drift note when a pin has fallen behind.
  • Permission pre-flight. Warns when a credential-bearing config is readable by other users on the machine and offers a one-click fix to 0600/0700.
  • Light theme + system-following (the dark theme is preserved exactly).
  • "Move to environment variable." Convert a plaintext secret in a config into a ${VAR} reference in place — offered only on clients that actually expand references, so it can't silently break a Claude Desktop config.
  • Cross-client foundation. Claude Desktop and Claude Code now flow through a single adapter — groundwork for supporting more clients.

Changed

  • The update checker is now visible — a persistent banner plus a Help-menu item — instead of being buried in the About dialog.
  • Config writes share one atomic-write path; the temp file is created 0600, so a secret is never briefly world-readable mid-write.

Fixed

  • Loading a config with a non-object server value no longer crashes, and named server sets survive an external-change merge.
  • Project profiles that share a directory basename are disambiguated, so you can't accidentally edit the wrong .mcp.json.

Internal / maintainer

  • Signed-catalog core and a maintainer-only Catalog Console (review + sign), with hardening of the review gate and a split of the signing keys. No user-facing catalog browser ships yet.

[1.3.0] — 2026-07-12

Named server sets, Claude Code project .mcp.json discovery, structural schema lint, and UX polish (Ctrl+S to save, enable-all / disable-all).

[1.2.1] — 2026-07-12

First shipped binaries: app-icon fix, a batch of audit fixes, and Windows process-tree cleanup on spawn-tests.

[1.2.0] — 2026-07-08

Server log viewer, duplicate-name conflict handling, a Restart-Claude button, stale-file protection, an About dialog, and a notify-only update checker.

[1.1.0] — 2026-07-04

Backup / restore UI and secret masking.

[1.0.1] — 2026-06-29

[1.0.0] — 2026-06-29

Initial releases: the core mcpServers editor with the lenient paste/repair pipeline that tolerates malformed JSON.