matimo-cli 0.1.2__tar.gz → 0.2.0__tar.gz

{matimo_cli-0.1.2 → matimo_cli-0.2.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.2.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.2.0/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.5
+Name: matimo-cli
+Version: 0.2.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.3.0,>=0.2.0
+Requires-Dist: mcp>=1.28.1
+Requires-Dist: pyyaml>=6.0
+Description-Content-Type: text/markdown
+
+# matimo-cli
+
+> 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://docs.matimo.dev)
+
+---
+
+## Installation
+
+```bash
+pip install matimo-cli
+# or with uv
+uv add matimo-cli
+```
+
+---
+
+## Commands
+
+### `matimo install` - Install provider packages
+
+```bash
+matimo install slack github gmail         # install specific providers
+```
+
+### `matimo list` - List available tools
+
+```bash
+matimo list                               # all loaded tools
+```
+
+### `matimo search` - Search for tools
+
+```bash
+matimo search email                       # text search over tool names + descriptions
+matimo search "send message"
+```
+
+### `matimo mcp` - Start MCP server
+
+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)
+matimo mcp --transport http --port 3000   # start as HTTP server
+```
+
+**Claude Desktop `claude_desktop_config.json`:**
+```json
+{
+  "mcpServers": {
+    "matimo": {
+      "command": "matimo",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+### `matimo doctor` - Diagnose your setup
+
+```bash
+matimo doctor                             # check config, installed providers, connectivity
+```
+
+### `matimo review` - Review agent-created tool definitions
+
+Operates on the current directory (or `$MATIMO_TOOL_DIR`), not an arbitrary path argument:
+
+```bash
+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
+
+The CLI reads configuration entirely from environment variables - there is no
+`.matimo.yaml` config file:
+
+```bash
+export MATIMO_LOG_LEVEL=info        # silent | error | warn | info | debug
+export MATIMO_LOG_FORMAT=json       # json | simple
+export MATIMO_APPROVED_PATTERNS="get_*,list_*"  # tools that never ask for approval
+```
+
+---
+
+## Documentation
+
+- [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://docs.matimo.dev/
+- **GitHub:** https://github.com/tallclub/matimo
+

matimo_cli-0.2.0/README.md

@@ -0,0 +1,113 @@
+# matimo-cli
+
+> 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://docs.matimo.dev)
+
+---
+
+## Installation
+
+```bash
+pip install matimo-cli
+# or with uv
+uv add matimo-cli
+```
+
+---
+
+## Commands
+
+### `matimo install` - Install provider packages
+
+```bash
+matimo install slack github gmail         # install specific providers
+```
+
+### `matimo list` - List available tools
+
+```bash
+matimo list                               # all loaded tools
+```
+
+### `matimo search` - Search for tools
+
+```bash
+matimo search email                       # text search over tool names + descriptions
+matimo search "send message"
+```
+
+### `matimo mcp` - Start MCP server
+
+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)
+matimo mcp --transport http --port 3000   # start as HTTP server
+```
+
+**Claude Desktop `claude_desktop_config.json`:**
+```json
+{
+  "mcpServers": {
+    "matimo": {
+      "command": "matimo",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+### `matimo doctor` - Diagnose your setup
+
+```bash
+matimo doctor                             # check config, installed providers, connectivity
+```
+
+### `matimo review` - Review agent-created tool definitions
+
+Operates on the current directory (or `$MATIMO_TOOL_DIR`), not an arbitrary path argument:
+
+```bash
+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
+
+The CLI reads configuration entirely from environment variables - there is no
+`.matimo.yaml` config file:
+
+```bash
+export MATIMO_LOG_LEVEL=info        # silent | error | warn | info | debug
+export MATIMO_LOG_FORMAT=json       # json | simple
+export MATIMO_APPROVED_PATTERNS="get_*,list_*"  # tools that never ask for approval
+```
+
+---
+
+## Documentation
+
+- [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://docs.matimo.dev/
+- **GitHub:** https://github.com/tallclub/matimo
+

{matimo_cli-0.1.2 → matimo_cli-0.2.0}/pyproject.toml

@@ -4,22 +4,22 @@ build-backend = "hatchling.build"
 
 [project]
 name = "matimo-cli"
-version = "0.1.2"
+version = "0.2.0"
 description = "Matimo CLI — tool package manager & MCP server launcher"
 readme = "README.md"
 requires-python = ">=3.11"
 license = { text = "MIT" }
 authors = [{ name = "Matimo" }]
-keywords = ["matimo", "cli", "ai-tools", "mcp"]
+keywords = ["matimo", "cli", "ai-tools", "mcp", "mcp-server", "ai-governance", "policy-engine"]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Programming Language :: Python :: 3",
     "License :: OSI Approved :: MIT License",
 ]
 dependencies = [
-    "matimo-core[mcp]>=0.1.0a14.post1,<0.2.0",
+    "matimo-core[mcp]>=0.2.0,<0.3.0",
     "pyyaml>=6.0",
-    "mcp>=1.0",
+    "mcp>=1.28.1",
 ]
 
 [project.scripts]

{matimo_cli-0.1.2 → matimo_cli-0.2.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.2 → matimo_cli-0.2.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.2/PKG-INFO

@@ -1,132 +0,0 @@
-Metadata-Version: 2.4
-Name: matimo-cli
-Version: 0.1.2
-Summary: Matimo CLI — tool package manager & MCP server launcher
-Author: Matimo
-License: MIT
-Keywords: ai-tools,cli,matimo,mcp
-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.0
-Requires-Dist: pyyaml>=6.0
-Description-Content-Type: text/markdown
-
-# matimo-cli
-
-> 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)
-
----
-
-## Installation
-
-```bash
-pip install matimo-cli
-# or with uv
-uv add matimo-cli
-```
-
----
-
-## Commands
-
-### `matimo install` — Install provider packages
-
-```bash
-matimo install slack github gmail         # install specific providers
-matimo install slack --upgrade            # upgrade an existing provider
-```
-
-### `matimo list` — List available tools
-
-```bash
-matimo list                               # all loaded tools
-matimo list --provider slack             # filter by provider
-matimo list --format json                # JSON output
-```
-
-### `matimo search` — Search for tools
-
-```bash
-matimo search email                       # text search over tool names + descriptions
-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.
-
-```bash
-matimo mcp                                # start on stdio (default)
-matimo mcp --transport http --port 3000   # start as HTTP server
-matimo mcp --name "my-agent"              # set server name
-```
-
-**Claude Desktop `claude_desktop_config.json`:**
-```json
-{
-  "mcpServers": {
-    "matimo": {
-      "command": "matimo",
-      "args": ["mcp"]
-    }
-  }
-}
-```
-
-### `matimo doctor` — Diagnose your setup
-
-```bash
-matimo doctor                             # check config, installed providers, connectivity
-matimo doctor --fix                       # attempt auto-repair
-```
-
-### `matimo review` — Review agent-created tool definitions
-
-```bash
-matimo review ./agent-tools/              # interactive review of draft tools
-```
-
----
-
-## Configuration
-
-The CLI reads Matimo configuration from the environment or a `.matimo.yaml` file in the project root:
-
-```yaml
-# .matimo.yaml
-toolPaths:
-  - ./tools
-  - ./agent-tools
-logLevel: info
-```
-
-Environment variables:
-
-```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)
-```
-
----
-
-## 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)
-
----
-
-## Links
-
-- **PyPI:** https://pypi.org/project/matimo-cli/
-- **Docs:** https://matimo.dev/docs
-- **GitHub:** https://github.com/tallclub/matimo
-

matimo_cli-0.1.2/README.md

@@ -1,116 +0,0 @@
-# matimo-cli
-
-> 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)
-
----
-
-## Installation
-
-```bash
-pip install matimo-cli
-# or with uv
-uv add matimo-cli
-```
-
----
-
-## Commands
-
-### `matimo install` — Install provider packages
-
-```bash
-matimo install slack github gmail         # install specific providers
-matimo install slack --upgrade            # upgrade an existing provider
-```
-
-### `matimo list` — List available tools
-
-```bash
-matimo list                               # all loaded tools
-matimo list --provider slack             # filter by provider
-matimo list --format json                # JSON output
-```
-
-### `matimo search` — Search for tools
-
-```bash
-matimo search email                       # text search over tool names + descriptions
-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.
-
-```bash
-matimo mcp                                # start on stdio (default)
-matimo mcp --transport http --port 3000   # start as HTTP server
-matimo mcp --name "my-agent"              # set server name
-```
-
-**Claude Desktop `claude_desktop_config.json`:**
-```json
-{
-  "mcpServers": {
-    "matimo": {
-      "command": "matimo",
-      "args": ["mcp"]
-    }
-  }
-}
-```
-
-### `matimo doctor` — Diagnose your setup
-
-```bash
-matimo doctor                             # check config, installed providers, connectivity
-matimo doctor --fix                       # attempt auto-repair
-```
-
-### `matimo review` — Review agent-created tool definitions
-
-```bash
-matimo review ./agent-tools/              # interactive review of draft tools
-```
-
----
-
-## Configuration
-
-The CLI reads Matimo configuration from the environment or a `.matimo.yaml` file in the project root:
-
-```yaml
-# .matimo.yaml
-toolPaths:
-  - ./tools
-  - ./agent-tools
-logLevel: info
-```
-
-Environment variables:
-
-```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)
-```
-
----
-
-## 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)
-
----
-
-## Links
-
-- **PyPI:** https://pypi.org/project/matimo-cli/
-- **Docs:** https://matimo.dev/docs
-- **GitHub:** https://github.com/tallclub/matimo
-