v0.5.0

Installation

# Run directly
uvx climax-mcp

# Install globally
uv tool install climax-mcp

# Or with pip
pip install climax-mcp

• Tool-call approval dialogs — Tools can declare a risk level (read, write, destructive), and CLImax shows a native confirmation dialog before running the risky ones. Uses osascript on macOS, zenity/kdialog on Linux, and a PowerShell MessageBox on Windows, falling back to a /dev/tty prompt so it survives MCP's occupied stdin. Add confirm_message for a templated prompt ("Delete {path}?"), and a resolve block to turn opaque IDs into human-readable context before asking.

• climax --version — Prints the installed version and exits, accepted at the top level, via -V, and on every subcommand.

• climax test-dialog — Shows a synthetic approval dialog so you can confirm your system displays one before relying on it.

• Paginated discovery — climax_search accepts offset and returns total_matches and has_more, so agents can page through large tool sets instead of truncating.

• Bundled gh and aws configs — 47 GitHub CLI tools and 76 AWS CLI v2 tools, risk-annotated out of the box. Reference by bare name: climax gh.

• Supply-chain cooldown — Dependency resolution ignores distributions uploaded in the last 7 days.

• Approval dialogs are on by default. The default policy is approval.global: write, so every tool marked risk: write or risk: destructive now prompts before running — 46 write and 6 destructive tools across the bundled configs. To restore 0.4.0 behavior, pass a policy file with approval.global: none.

• Headless environments deny by default. With no GUI and no TTY, the default approval.headless: deny refuses the call rather than running it unprompted. If CLImax runs unattended (CI, containers, a remote MCP client with no display), write and destructive tools will now fail closed. Pass --headless-approve, or set approval.headless: approve, to auto-approve instead. This is the most likely upgrade break for existing automated setups.

• mcp is constrained to >=1.7,<2. mcp 2.0 replaced the low-level Server decorator API with constructor-based handler registration, which CLImax cannot run against. 0.4.x installs could resolve mcp 2.0.0 and crash on startup with AttributeError: 'Server' object has no attribute 'list_tools' (#18). If you hit that, upgrading fixes it; incompatible versions now fail with an actionable error naming the required range.

See CHANGELOG.md for the full list.

Full Changelog: v0.5.0.dev2...v0.5.0

v0.5.0-rc1

Installation

# Run directly
uvx climax-mcp

# Install globally
uv tool install climax-mcp

# Or with pip
pip install climax-mcp

Note: This is a pre-release version for testing. Install this specific version with:

uvx climax-mcp==0.5.0-rc1
uv tool install climax-mcp==0.5.0-rc1
pip install climax-mcp==0.5.0-rc1

Changes

• release: 0.5.0 (#20)
• test: silence un-awaited coroutine and class-fixture warnings (#21)
• Merge pull request #19 from get2knowio/fix/mcp2-crash-and-lint-pin
• chore(devcontainer): pin base image to ubuntu-24.04 and add feature lock
• ci: pin ruff and clear the resulting lint backlog
• fix: constrain mcp to <2 so installs don't resolve the incompatible 2.x API
• Bump tiktoken from 0.12.0 to 0.13.0 (#13)
• Bump mcp from 1.26.0 to 1.28.1 (#12)
• Bump pydantic from 2.12.5 to 2.13.4 (#10)
• Bump pytest-asyncio from 1.3.0 to 1.4.0 (#11)
• Bump pytest from 9.0.2 to 9.1.1 (#9)
• Bump astral-sh/setup-uv from 5 to 7 (#8)
• Bump actions/checkout from 4 to 7 (#7)
• Bump softprops/action-gh-release from 2 to 3 (#6)
• chore: enforce 7-day supply-chain cooldown on dependencies (#5)

Full Changelog: v0.5.0.dev2...v0.5.0-rc1

v0.5.0.dev2

Installation

# Run directly
uvx climax-mcp

# Install globally
uv tool install climax-mcp

# Or with pip
pip install climax-mcp

Previously, approval dialogs only fired when an explicit --policy file
was provided. Now a default policy is created automatically with
write-level approval enabled, so tools like gh_repo_edit prompt for
confirmation out of the box. The --headless approve flag remains
available to opt out for CI/automation.

Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com

Full Changelog: v0.5.0.dev1...v0.5.0.dev2

v0.5.0.dev1

Installation

# Run directly
uvx climax-mcp

# Install globally
uv tool install climax-mcp

# Or with pip
pip install climax-mcp

The default limit of 10 caused MCP clients to only see the first 10 tools
from large configs (e.g. gh.yaml's 47 tools). Bumps default limit to 50,
adds offset parameter for true pagination, and includes total_matches/
returned/has_more metadata so agents know when results are truncated.

Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com

Full Changelog: v0.5.0.dev0...v0.5.0.dev1

v0.5.0.dev0

Installation

# Run directly
uvx climax-mcp

# Install globally
uv tool install climax-mcp

# Or with pip
pip install climax-mcp

Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com

Full Changelog: v0.4.0...v0.5.0.dev0

v0.4.0

Installation

# Run directly
uvx climax-mcp

# Install globally
uv tool install climax-mcp

# Or with pip
pip install climax-mcp

• Bump version from 0.4.0rc4 to 0.4.0
• Add CHANGELOG entry for 0.4.0 (HTTP transports, Rich request logging, positional bundled configs)
• Suppress stderr in tool responses on successful exit to avoid noisy CLI warnings confusing agents
• Update README intro, installation section, and replace internal milestone reference
• Update tests for new stderr behavior

Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com

Full Changelog: v0.3.1...v0.4.0

v0.4.0-rc4

Installation

# Run directly
uvx climax-mcp

# Install globally
uv tool install climax-mcp

# Or with pip
pip install climax-mcp

Note: This is a pre-release version for testing. Install this specific version with:

uvx climax-mcp==0.4.0-rc4
uv tool install climax-mcp==0.4.0-rc4
pip install climax-mcp==0.4.0-rc4

Changes

• Make bundled configs first-class positional args, add --config for files

Full Changelog: v0.4.0-rc3...v0.4.0-rc4

v0.4.0-rc3

Installation

# Run directly
uvx climax-mcp

# Install globally
uv tool install climax-mcp

# Or with pip
pip install climax-mcp

Note: This is a pre-release version for testing. Install this specific version with:

uvx climax-mcp==0.4.0-rc3
uv tool install climax-mcp==0.4.0-rc3
pip install climax-mcp==0.4.0-rc3

Changes

• Document HTTP transports in README

Full Changelog: v0.4.0-rc2...v0.4.0-rc3

v0.4.0-rc2

Installation

# Run directly
uvx climax-mcp

# Install globally
uv tool install climax-mcp

# Or with pip
pip install climax-mcp

Note: This is a pre-release version for testing. Install this specific version with:

uvx climax-mcp==0.4.0-rc2
uv tool install climax-mcp==0.4.0-rc2
pip install climax-mcp==0.4.0-rc2

Changes

• Add Rich-formatted request logging for HTTP transports

Full Changelog: v0.4.0-rc1...v0.4.0-rc2

v0.4.0-rc1

Installation

# Run directly
uvx climax-mcp

# Install globally
uv tool install climax-mcp

# Or with pip
pip install climax-mcp

Note: This is a pre-release version for testing. Install this specific version with:

uvx climax-mcp==0.4.0-rc1
uv tool install climax-mcp==0.4.0-rc1
pip install climax-mcp==0.4.0-rc1

Changes

• Add HTTP-based MCP server transports (SSE and Streamable HTTP)
• Fix all ruff lint errors

Full Changelog: v0.3.1...v0.4.0-rc1