lightnow-cli 1.6.1__tar.gz → 1.7.0__tar.gz

lightnow_cli-1.7.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.7.0"
+}

{lightnow_cli-1.6.1 → lightnow_cli-1.7.0}/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to the LightNow CLI are documented here.
 
 This project follows semantic versioning.
 
+## [1.7.0](https://github.com/lightnow-ai/lightnow-cli/compare/v1.6.1...v1.7.0) (2026-11-13)
+
+
+### Features
+
+* support LibreChat local proxy configuration ([#47](https://github.com/lightnow-ai/lightnow-cli/issues/47)) ([fffb3ca](https://github.com/lightnow-ai/lightnow-cli/commit/fffb3ca2ac8c87f08e9938bfcb54e3952fcb23f7))
+
 ## [1.6.1](https://github.com/lightnow-ai/lightnow-cli/compare/v1.6.0...v1.6.1) (2026-11-09)
 
 

lightnow_cli-1.7.0/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.5
+Name: lightnow-cli
+Version: 1.7.0
+Summary: Official LightNow CLI for MCP registry discovery, client config sync, and local MCP runner workflows
+Project-URL: Homepage, https://github.com/lightnow-ai/lightnow-cli
+Project-URL: Repository, https://github.com/lightnow-ai/lightnow-cli
+Author: LightNow Team
+License: Apache-2.0
+License-File: LICENSE
+Keywords: cli,lightnow,mcp,model-context-protocol,registry
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: filelock>=3.16.1
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: jsonschema>=4.17.0
+Requires-Dist: packaging>=24.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyjwt>=2.8.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: truststore>=0.10.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: build>=1.2.0; extra == 'dev'
+Requires-Dist: flake8>=6.0.0; extra == 'dev'
+Requires-Dist: isort>=5.12.0; extra == 'dev'
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest-mock>=3.10.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: responses>=0.23.0; extra == 'dev'
+Requires-Dist: twine>=5.0.0; extra == 'dev'
+Requires-Dist: types-jsonschema>=4.25.0; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0.12; extra == 'dev'
+Provides-Extra: keyring
+Requires-Dist: keyring>=25.6.0; extra == 'keyring'
+Description-Content-Type: text/markdown
+
+# LightNow CLI
+
+[![PyPI](https://img.shields.io/pypi/v/lightnow-cli.svg)](https://pypi.org/project/lightnow-cli/)
+
+Find MCP servers and connect your AI assistants to the tools you manage in LightNow.
+
+The CLI signs you in and configures your clients. [LightNow Proxy](https://github.com/lightnow-ai/lightnow-proxy)
+runs their connections to the servers in your Runtime profiles.
+
+## Get started
+
+You need a [LightNow account](https://lightnow.ai/), an AI client and a Runtime
+profile with the server connections you want to use.
+
+### 1. Install the CLI and proxy
+
+With Homebrew:
+
+```sh
+brew tap lightnow-ai/tap
+brew install lightnow-cli lightnow-proxy
+```
+
+Or with [uv](https://docs.astral.sh/uv/getting-started/installation/) and Python 3.11 or later:
+
+```sh
+uv tool install lightnow-cli
+uv tool install lightnow-proxy
+```
+
+[pipx](https://pipx.pypa.io/stable/installation/) is also supported.
+
+### 2. Sign in and connect a client
+
+If your client already has MCP servers, [review the import options](https://docs.lightnow.ai/how-to/import-existing-mcp-config)
+before syncing.
+
+```sh
+lightnow login
+lightnow sync --client codex --profile default --local-proxy
+```
+
+Replace `default` with your profile's name. Restart the client and check its MCP
+tools list. The CLI supports Codex, Claude Code, Claude Desktop, Cursor, VS Code,
+Antigravity, Gemini CLI and LibreChat.
+
+See [Connect AI assistants](https://docs.lightnow.ai/getting-started/sync-mcp-clients)
+for each client's setup and configuration paths.
+
+For LibreChat, run the CLI and proxy on its backend and select its configuration:
+
+```sh
+lightnow sync --client librechat --profile default --local-proxy --config-path /path/to/librechat.yaml
+```
+
+LibreChat users with access to this connection share the backend account's
+LightNow permissions. Reload LibreChat after changing its configuration.
+
+### 3. Check the connection
+
+```sh
+lightnow status
+lightnow config-status --client codex
+lightnow-proxy --config ~/.lightnow/lightnow-proxy/codex.yaml --health
+```
+
+For help, see [Troubleshoot the connection](https://docs.lightnow.ai/how-to/debug-local-proxy).
+
+## Useful commands
+
+| Task | Command |
+| --- | --- |
+| Find servers | `lightnow search sonarqube` |
+| View your favorites | `lightnow favorites` |
+| Use organization-managed client settings | `lightnow sync --client codex --from-settings` |
+| Check for updates | `lightnow update --check` |
+| Update the CLI and proxy | `lightnow update` |
+
+Use `lightnow --help` or `lightnow <command> --help` for available options.
+For profiles, organization connections and other workflows, see the
+[CLI reference](https://docs.lightnow.ai/reference/cli).
+
+## Contributing
+
+See [development setup](docs/development.md), [contributing](CONTRIBUTING.md),
+[release process](docs/release.md) and [security policy](SECURITY.md).
+
+## License
+
+[Apache License 2.0](LICENSE).

lightnow_cli-1.7.0/README.md

@@ -0,0 +1,90 @@
+# LightNow CLI
+
+[![PyPI](https://img.shields.io/pypi/v/lightnow-cli.svg)](https://pypi.org/project/lightnow-cli/)
+
+Find MCP servers and connect your AI assistants to the tools you manage in LightNow.
+
+The CLI signs you in and configures your clients. [LightNow Proxy](https://github.com/lightnow-ai/lightnow-proxy)
+runs their connections to the servers in your Runtime profiles.
+
+## Get started
+
+You need a [LightNow account](https://lightnow.ai/), an AI client and a Runtime
+profile with the server connections you want to use.
+
+### 1. Install the CLI and proxy
+
+With Homebrew:
+
+```sh
+brew tap lightnow-ai/tap
+brew install lightnow-cli lightnow-proxy
+```
+
+Or with [uv](https://docs.astral.sh/uv/getting-started/installation/) and Python 3.11 or later:
+
+```sh
+uv tool install lightnow-cli
+uv tool install lightnow-proxy
+```
+
+[pipx](https://pipx.pypa.io/stable/installation/) is also supported.
+
+### 2. Sign in and connect a client
+
+If your client already has MCP servers, [review the import options](https://docs.lightnow.ai/how-to/import-existing-mcp-config)
+before syncing.
+
+```sh
+lightnow login
+lightnow sync --client codex --profile default --local-proxy
+```
+
+Replace `default` with your profile's name. Restart the client and check its MCP
+tools list. The CLI supports Codex, Claude Code, Claude Desktop, Cursor, VS Code,
+Antigravity, Gemini CLI and LibreChat.
+
+See [Connect AI assistants](https://docs.lightnow.ai/getting-started/sync-mcp-clients)
+for each client's setup and configuration paths.
+
+For LibreChat, run the CLI and proxy on its backend and select its configuration:
+
+```sh
+lightnow sync --client librechat --profile default --local-proxy --config-path /path/to/librechat.yaml
+```
+
+LibreChat users with access to this connection share the backend account's
+LightNow permissions. Reload LibreChat after changing its configuration.
+
+### 3. Check the connection
+
+```sh
+lightnow status
+lightnow config-status --client codex
+lightnow-proxy --config ~/.lightnow/lightnow-proxy/codex.yaml --health
+```
+
+For help, see [Troubleshoot the connection](https://docs.lightnow.ai/how-to/debug-local-proxy).
+
+## Useful commands
+
+| Task | Command |
+| --- | --- |
+| Find servers | `lightnow search sonarqube` |
+| View your favorites | `lightnow favorites` |
+| Use organization-managed client settings | `lightnow sync --client codex --from-settings` |
+| Check for updates | `lightnow update --check` |
+| Update the CLI and proxy | `lightnow update` |
+
+Use `lightnow --help` or `lightnow <command> --help` for available options.
+For profiles, organization connections and other workflows, see the
+[CLI reference](https://docs.lightnow.ai/reference/cli).
+
+## Contributing
+
+See [development setup](docs/development.md), [contributing](CONTRIBUTING.md),
+[release process](docs/release.md) and [security policy](SECURITY.md).
+
+## License
+
+[Apache License 2.0](LICENSE).

{lightnow_cli-1.6.1 → lightnow_cli-1.7.0}/lightnow_cli/__init__.py

@@ -1,3 +1,3 @@
 """LightNow CLI - A command-line tool for managing MCP servers."""
 
-__version__ = "1.6.1"  # x-release-please-version
+__version__ = "1.7.0"  # x-release-please-version

{lightnow_cli-1.6.1 → lightnow_cli-1.7.0}/lightnow_cli/commands/integrations.py

@@ -121,7 +121,7 @@ VSCODE_VIRTUAL_TOOLS_THRESHOLD = 128
 LOCAL_PROXY_STDIO_SUPPORT_MESSAGE = (
     "Local Proxy Mode stdio currently supports Codex TOML, "
     "Antigravity JSON, Claude Code JSON, Claude Desktop JSON, "
-    "Cursor JSON, Gemini CLI JSON, and VS Code JSON only."
+    "Cursor JSON, Gemini CLI JSON, VS Code JSON, and LibreChat YAML only."
 )
 LOCAL_PROXY_HTTP_SUPPORT_MESSAGE = (
     "Local Proxy Mode HTTP currently supports Codex TOML only."
@@ -237,6 +237,8 @@ def local_proxy_support_error(
 ) -> Optional[str]:
     """Return why a client/format/transport combination lacks Local Proxy support."""
     if local_proxy_transport == "stdio":
+        if client == "librechat" and export_format == "yaml":
+            return None
         if client in LOCAL_PROXY_JSON_CLIENTS and export_format == "json":
             return None
         if client == "codex" and export_format == "toml":
@@ -271,12 +273,29 @@ def backup_path_for(path: Path) -> Path:
 
 def direct_server_aliases(content: str, export_format: str) -> list[str]:
     """Return non-LightNow MCP server aliases found in a client config."""
-    if export_format not in {"json", "toml"}:
+    if export_format not in {"json", "toml", "yaml"}:
         return []
     try:
         entries = extract_mcp_entries(content, export_format)
     except ValueError:
         return []
+    if export_format == "yaml":
+        return sorted(
+            alias
+            for alias, entry in entries.items()
+            if not (
+                command_looks_like(
+                    str(entry.get("command") or ""), LOCAL_PROXY_EXECUTABLE
+                )
+                or command_looks_like(
+                    str(entry.get("command") or ""), LEGACY_LOCAL_PROXY_EXECUTABLE
+                )
+                or (
+                    is_lightnow_connection_alias(alias)
+                    and is_local_proxy_url(str(entry.get("url") or ""))
+                )
+            )
+        )
     return sorted(alias for alias in entries if alias not in LIGHTNOW_PROXY_ALIASES)
 
 
@@ -626,13 +645,18 @@ def sync(
         patch_aliases = previous_managed["aliases"]
         if local_proxy and export_format == "json":
             patch_aliases = ["LightNow" if connection == "lightnow" else connection]
-        patched = patch_config(
-            existing,
-            generated,
-            export_format,
-            patch_aliases,
-            previous_managed["input_ids"],
-        )
+        if local_proxy and client == "librechat" and export_format == "yaml":
+            patched = patch_local_proxy_yaml_config(
+                existing, generated, remove_unmanaged_client_servers
+            )
+        else:
+            patched = patch_config(
+                existing,
+                generated,
+                export_format,
+                patch_aliases,
+                previous_managed["input_ids"],
+            )
         if (
             not local_proxy
             and not runner
@@ -965,6 +989,12 @@ def build_local_proxy_export(
     if support_error:
         raise ValueError(support_error)
     if local_proxy_transport == "stdio":
+        if client == "librechat" and export_format == "yaml":
+            return render_local_proxy_librechat_yaml(
+                local_proxy_config_path
+                or default_local_proxy_config_path(client, connection_alias),
+                connection_alias,
+            )
         if client in LOCAL_PROXY_MCP_SERVERS_JSON_CLIENTS and export_format == "json":
             return render_local_proxy_mcp_servers_json(
                 local_proxy_config_path
@@ -1099,6 +1129,18 @@ def render_local_proxy_mcp_servers_json(
     return json.dumps(payload, indent=2) + "\n"
 
 
+def render_local_proxy_librechat_yaml(
+    local_proxy_config_path: Path, connection_alias: str = "lightnow"
+) -> str:
+    """Render an operator-owned LibreChat stdio entry on its backend host."""
+    payload = json.loads(
+        render_local_proxy_mcp_servers_json(local_proxy_config_path, connection_alias)
+    )
+    for entry in payload["mcpServers"].values():
+        entry["type"] = "stdio"
+    return yaml.safe_dump(payload, sort_keys=False, allow_unicode=True)
+
+
 def render_local_proxy_vscode_json(
     local_proxy_config_path: Path, connection_alias: str = "lightnow"
 ) -> str:
@@ -2084,6 +2126,11 @@ def extract_mcp_entries(content: str, export_format: str) -> dict[str, dict[str,
                 if isinstance(entry, dict):
                     entries[str(alias)] = entry
         return entries
+    if export_format == "yaml":
+        payload = load_yaml_client_config(content)
+        return {
+            str(alias): entry for alias, entry in payload.get("mcpServers", {}).items()
+        }
     raise ValueError(f"unsupported_format:{export_format}")
 
 
@@ -2106,7 +2153,7 @@ def is_local_proxy_url(value: str) -> bool:
 def warning_hint(code: str, client: str) -> Optional[str]:
     """Return a short recovery hint for a posture warning code."""
     sync_command = f"lightnow sync --client {client} --local-proxy"
-    if code.startswith("invalid_json") or code.startswith("invalid_toml"):
+    if code.startswith(("invalid_json", "invalid_toml", "invalid_yaml")):
         return (
             "the config file could not be parsed; fix it or restore the "
             ".lightnow.bak backup, then re-run the sync."
@@ -2439,6 +2486,60 @@ def merge_local_proxy_toml_connection(
     return "\n\n".join(part for part in (kept, generated.strip()) if part)
 
 
+class ClientConfigSafeLoader(yaml.SafeLoader):
+    """Reject duplicate YAML keys rather than silently discarding configuration."""
+
+    def construct_mapping(
+        self, node: yaml.nodes.MappingNode, deep: bool = False
+    ) -> dict[Any, Any]:
+        keys = [
+            self.construct_object(key, deep=deep)
+            for key, _ in node.value
+            if key.tag != "tag:yaml.org,2002:merge"
+        ]
+        if len(set(keys)) != len(keys):
+            raise ValueError("invalid_yaml:duplicate_key")
+        return super().construct_mapping(node, deep=deep)
+
+
+def load_yaml_client_config(content: str) -> dict[str, Any]:
+    """Read a LibreChat mapping without exposing source values in parse errors."""
+    try:
+        payload = (
+            yaml.load(content, Loader=ClientConfigSafeLoader) if content.strip() else {}
+        )
+    except (yaml.YAMLError, TypeError) as exc:
+        raise ValueError("invalid_yaml:parse_failed") from exc
+    if payload is None:
+        payload = {}
+    if not isinstance(payload, dict):
+        raise ValueError("invalid_yaml:root_not_object")
+    servers = payload.get("mcpServers", {})
+    if not isinstance(servers, dict) or any(
+        not isinstance(alias, str) or not isinstance(entry, dict)
+        for alias, entry in servers.items()
+    ):
+        raise ValueError("invalid_yaml:mcpServers_not_object")
+    return payload
+
+
+def patch_local_proxy_yaml_config(
+    existing: str, generated: str, remove_unmanaged: bool
+) -> str:
+    """Merge one LibreChat connection while respecting the unmanaged-server policy."""
+    current = load_yaml_client_config(existing)
+    incoming = load_yaml_client_config(generated)
+    entries = current.get("mcpServers", {})
+    if remove_unmanaged:
+        unmanaged = set(direct_server_aliases(existing, "yaml"))
+        entries = {
+            alias: entry for alias, entry in entries.items() if alias not in unmanaged
+        }
+    entries.update(incoming["mcpServers"])
+    current["mcpServers"] = entries
+    return yaml.safe_dump(current, sort_keys=False, allow_unicode=True)
+
+
 def patch_json_config(
     existing: str,
     generated: str,

{lightnow_cli-1.6.1 → lightnow_cli-1.7.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "lightnow-cli"
-version = "1.6.1"
+version = "1.7.0"
 description = "Official LightNow CLI for MCP registry discovery, client config sync, and local MCP runner workflows"
 authors = [{name = "LightNow Team"}]
 license = {text = "Apache-2.0"}