matimo-cli 0.1.3__tar.gz → 0.4.0__tar.gz

{matimo_cli-0.1.3 → matimo_cli-0.4.0}/.gitignore

@@ -58,7 +58,6 @@ temp/
 
 # Personal scratch notes / working docs — not part of the shipped repo
 .local-notes/
-typescript/examples/mcp/matimo-tools/.matimo-approvals.json
 typescript/examples/mcp/matimo-tools/fetch-weather/definition.yaml
 typescript/examples/mcp/matimo-tools/npm_downloads/definition.yaml
 typescript/examples/mcp/matimo-tools/skills/ecosystem-health/SKILL.md
@@ -68,3 +67,6 @@ typescript/packages/cli/.matimo/certs/server.crt
 typescript/packages/cli/.matimo/certs/server.key
 typescript/examples/mcp/.matimo/certs/server.crt
 typescript/examples/mcp/.matimo/certs/server.key
+
+# HITL approval manifests are per-machine state (HMAC-signed approvals); never commit one
+**/.matimo-approvals.json

matimo_cli-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ROAIQ TECHNOLOGIES PRIVATE LIMITED
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{matimo_cli-0.1.3 → matimo_cli-0.4.0}/PKG-INFO

@@ -1,16 +1,17 @@
 Metadata-Version: 2.5
 Name: matimo-cli
-Version: 0.1.3
+Version: 0.4.0
 Summary: Matimo CLI — tool package manager & MCP server launcher
 Author: Matimo
 License: MIT
+License-File: LICENSE
 Keywords: ai-governance,ai-tools,cli,matimo,mcp,mcp-server,policy-engine
 Classifier: Development Status :: 3 - Alpha
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.11
-Requires-Dist: matimo-core[mcp]<0.2.0,>=0.1.0a14.post1
-Requires-Dist: mcp>=1.28.1
+Requires-Dist: matimo-core[mcp]<0.5.0,>=0.4.0
+Requires-Dist: mcp>=2.0
 Requires-Dist: pyyaml>=6.0
 Description-Content-Type: text/markdown
 
@@ -19,7 +20,7 @@ Description-Content-Type: text/markdown
 > Command-line interface for [Matimo](https://matimo.dev) - tool package manager & MCP server launcher.
 
 [![PyPI](https://img.shields.io/pypi/v/matimo-cli)](https://pypi.org/project/matimo-cli/)
-[![Docs](https://img.shields.io/badge/docs-matimo.dev-blue)](https://matimo.dev/docs)
+[![Docs](https://img.shields.io/badge/docs-matimo.dev-blue)](https://docs.matimo.dev)
 
 ---
 
@@ -56,7 +57,7 @@ matimo search "send message"
 
 ### `matimo mcp` - Start MCP server
 
-Serve all loaded tools over the [Model Context Protocol](https://matimo.dev/docs/MCP) so Claude Desktop, Cursor, or any MCP client can access them.
+Serve all loaded tools over the [Model Context Protocol](https://docs.matimo.dev/MCP) so Claude Desktop, Cursor, or any MCP client can access them.
 
 ```bash
 matimo mcp                                # start on stdio (default)
@@ -86,11 +87,18 @@ matimo doctor                             # check config, installed providers, c
 Operates on the current directory (or `$MATIMO_TOOL_DIR`), not an arbitrary path argument:
 
 ```bash
-matimo review list                        # list draft tools awaiting approval
+matimo review list                        # list approved tools and HITL-pending ones
 matimo review approve my_tool             # approve a pending tool
 matimo review reject my_tool              # reject/revoke a tool
 ```
 
+`review` works on one directory that holds both the agent-created tools (`<dir>/<tool>/definition.yaml`) and the approval manifest (`<dir>/.matimo-approvals.json`): the current directory, or `MATIMO_TOOL_DIR`. For your app to see a CLI approval:
+
+- set `approvalDir` (`approval_dir`) in the app to that same directory, and
+- use the same `MATIMO_APPROVAL_SECRET` in the CLI and the app (`approve` refuses to run without it).
+
+`approve` sets `status: approved` in the YAML and signs it; reload the app's tools afterwards. `list` shows the tools the manifest records as approved, and those held as pending by HITL quarantine on reload. Inside a running agent, `matimo_approve_tool` does the same job with the app's own manifest.
+
 ---
 
 ## Configuration
@@ -101,22 +109,22 @@ The CLI reads configuration entirely from environment variables - there is no
 ```bash
 export MATIMO_LOG_LEVEL=info        # silent | error | warn | info | debug
 export MATIMO_LOG_FORMAT=json       # json | simple
-export MATIMO_AUTO_APPROVE=true     # auto-approve tool approval prompts (CI/CD)
+export MATIMO_APPROVED_PATTERNS="get_*,list_*"  # tools that never ask for approval
 ```
 
 ---
 
 ## Documentation
 
-- [CLI Guide](https://matimo.dev/docs/user-guide/)
-- [MCP Guide](https://matimo.dev/docs/MCP)
-- [Getting Started](https://matimo.dev/docs/getting-started/QUICK_START)
+- [CLI Guide](https://github.com/tallclub/matimo/blob/main/python/packages/cli/README.md)
+- [MCP Guide](https://docs.matimo.dev/MCP)
+- [Getting Started](https://docs.matimo.dev/getting-started/QUICK_START)
 
 ---
 
 ## Links
 
 - **PyPI:** https://pypi.org/project/matimo-cli/
-- **Docs:** https://matimo.dev/docs
+- **Docs:** https://docs.matimo.dev/
 - **GitHub:** https://github.com/tallclub/matimo
 

{matimo_cli-0.1.3 → matimo_cli-0.4.0}/README.md

@@ -3,7 +3,7 @@
 > Command-line interface for [Matimo](https://matimo.dev) - tool package manager & MCP server launcher.
 
 [![PyPI](https://img.shields.io/pypi/v/matimo-cli)](https://pypi.org/project/matimo-cli/)
-[![Docs](https://img.shields.io/badge/docs-matimo.dev-blue)](https://matimo.dev/docs)
+[![Docs](https://img.shields.io/badge/docs-matimo.dev-blue)](https://docs.matimo.dev)
 
 ---
 
@@ -40,7 +40,7 @@ matimo search "send message"
 
 ### `matimo mcp` - Start MCP server
 
-Serve all loaded tools over the [Model Context Protocol](https://matimo.dev/docs/MCP) so Claude Desktop, Cursor, or any MCP client can access them.
+Serve all loaded tools over the [Model Context Protocol](https://docs.matimo.dev/MCP) so Claude Desktop, Cursor, or any MCP client can access them.
 
 ```bash
 matimo mcp                                # start on stdio (default)
@@ -70,11 +70,18 @@ matimo doctor                             # check config, installed providers, c
 Operates on the current directory (or `$MATIMO_TOOL_DIR`), not an arbitrary path argument:
 
 ```bash
-matimo review list                        # list draft tools awaiting approval
+matimo review list                        # list approved tools and HITL-pending ones
 matimo review approve my_tool             # approve a pending tool
 matimo review reject my_tool              # reject/revoke a tool
 ```
 
+`review` works on one directory that holds both the agent-created tools (`<dir>/<tool>/definition.yaml`) and the approval manifest (`<dir>/.matimo-approvals.json`): the current directory, or `MATIMO_TOOL_DIR`. For your app to see a CLI approval:
+
+- set `approvalDir` (`approval_dir`) in the app to that same directory, and
+- use the same `MATIMO_APPROVAL_SECRET` in the CLI and the app (`approve` refuses to run without it).
+
+`approve` sets `status: approved` in the YAML and signs it; reload the app's tools afterwards. `list` shows the tools the manifest records as approved, and those held as pending by HITL quarantine on reload. Inside a running agent, `matimo_approve_tool` does the same job with the app's own manifest.
+
 ---
 
 ## Configuration
@@ -85,22 +92,22 @@ The CLI reads configuration entirely from environment variables - there is no
 ```bash
 export MATIMO_LOG_LEVEL=info        # silent | error | warn | info | debug
 export MATIMO_LOG_FORMAT=json       # json | simple
-export MATIMO_AUTO_APPROVE=true     # auto-approve tool approval prompts (CI/CD)
+export MATIMO_APPROVED_PATTERNS="get_*,list_*"  # tools that never ask for approval
 ```
 
 ---
 
 ## Documentation
 
-- [CLI Guide](https://matimo.dev/docs/user-guide/)
-- [MCP Guide](https://matimo.dev/docs/MCP)
-- [Getting Started](https://matimo.dev/docs/getting-started/QUICK_START)
+- [CLI Guide](https://github.com/tallclub/matimo/blob/main/python/packages/cli/README.md)
+- [MCP Guide](https://docs.matimo.dev/MCP)
+- [Getting Started](https://docs.matimo.dev/getting-started/QUICK_START)
 
 ---
 
 ## Links
 
 - **PyPI:** https://pypi.org/project/matimo-cli/
-- **Docs:** https://matimo.dev/docs
+- **Docs:** https://docs.matimo.dev/
 - **GitHub:** https://github.com/tallclub/matimo
 

{matimo_cli-0.1.3 → matimo_cli-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "matimo-cli"
-version = "0.1.3"
+version = "0.4.0"
 description = "Matimo CLI — tool package manager & MCP server launcher"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -17,9 +17,9 @@ classifiers = [
     "License :: OSI Approved :: MIT License",
 ]
 dependencies = [
-    "matimo-core[mcp]>=0.1.0a14.post1,<0.2.0",
+    "matimo-core[mcp]>=0.4.0,<0.5.0",
     "pyyaml>=6.0",
-    "mcp>=1.28.1",
+    "mcp>=2.0",
 ]
 
 [project.scripts]

{matimo_cli-0.1.3 → matimo_cli-0.4.0}/src/matimo_cli/cli.py

@@ -16,6 +16,8 @@ Usage::
 from __future__ import annotations
 
 import sys
+from importlib.metadata import PackageNotFoundError
+from importlib.metadata import version as _pkg_version
 
 from matimo_cli.commands.doctor import doctor_command
 from matimo_cli.commands.install import install_command
@@ -24,7 +26,10 @@ from matimo_cli.commands.mcp import mcp_command
 from matimo_cli.commands.review import review_command
 from matimo_cli.commands.search import search_command
 
-_VERSION = "0.1.0"  # also update in setup.py and pyproject.toml
+try:
+    _VERSION = _pkg_version("matimo-cli")
+except PackageNotFoundError:  # running from a source tree without install metadata
+    _VERSION = "unknown"
 
 _HELP = f"""\
 🔨 Matimo CLI — Tool Package Manager  (v{_VERSION})
@@ -57,8 +62,17 @@ Documentation: https://github.com/tallclub/matimo#readme
 """
 
 
+def _ensure_utf8_output() -> None:
+    """Avoid UnicodeEncodeError on consoles with a legacy code page (e.g. cp1252 on Windows)."""
+    for stream in (sys.stdout, sys.stderr):
+        reconfigure = getattr(stream, "reconfigure", None)
+        if reconfigure is not None:
+            reconfigure(encoding="utf-8", errors="replace")
+
+
 def main(cli_args: list[str] | None = None) -> None:
     """Main CLI handler — parses commands and routes to handlers."""
+    _ensure_utf8_output()
     args = cli_args if cli_args is not None else sys.argv[1:]
     command = args[0] if args else None
     params = args[1:] if args else []

{matimo_cli-0.1.3 → matimo_cli-0.4.0}/src/matimo_cli/commands/install.py

@@ -13,7 +13,7 @@ def install_command(tool_names: list[str]) -> None:
     if not tool_names:
         print("❌ Error: Please specify at least one tool to install", file=sys.stderr)
         print("\nUsage: matimo install [tool1] [tool2] …")
-        print("Example: matimo install slack gmail stripe")
+        print("Example: matimo install slack gmail github")
         sys.exit(1)
 
     packages = [f"matimo-{name}" for name in tool_names]

{matimo_cli-0.1.3 → matimo_cli-0.4.0}/src/matimo_cli/commands/mcp.py

@@ -21,6 +21,7 @@ class McpArgs:
     vault_path: str | None = None
     aws_secret_id: str | None = None
     token: str | None = None
+    host: str = "127.0.0.1"
     tool_paths: list[str] | None = None
     skill_paths: list[str] | None = None
     https: bool = False
@@ -50,6 +51,8 @@ def _parse_args(params: list[str]) -> McpArgs:
                     print('❌ --transport must be "stdio" or "http"', file=sys.stderr)
                     sys.exit(1)
                 args.transport = val
+            case "--host":
+                args.host = require_value("--host")
             case "--port" | "-p":
                 val = require_value("--port")
                 try:
@@ -179,6 +182,7 @@ async def _mcp_command_async(params: list[str]) -> None:
     options = MCPServerOptions(
         transport=args.transport,
         port=args.port,
+        host=args.host,
         tools=args.tools,
         exclude_tools=args.exclude_tools,
         secret_resolver=_build_resolver_config(args),