Metadata-Version: 2.4
Name: loopgrid-claude-launcher
Version: 0.1.0
Summary: Isolated secure launcher for LoopGrid's Claude Code plugin
Author-email: LoopGrid <hello@loopgrid.io>
License-Expression: Apache-2.0
Project-URL: Homepage, https://loopgrid.io/integrations/
Project-URL: Repository, https://github.com/loopgridio/loopgrid-claude-launcher
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: loopgrid-mcp==0.1.0
Dynamic: license-file

# LoopGrid Claude Launcher

Secure, Claude-specific MCP launcher for **LoopGrid Decision Evidence**.

This package runs the existing published `loopgrid-mcp==0.1.0` without modifying it or affecting integrations that depend on that version.

## Features

- Launches the existing LoopGrid MCP server for Claude Code.
- Filters inherited environment variables before starting the MCP application.
- Maps the explicitly configured, sensitive Claude plugin `service_key` option to `LOOPGRID_SERVICE_KEY`.
- Rejects non-HTTPS remote LoopGrid Core URLs. Local HTTP connections to loopback addresses are supported for development.
- Preserves the existing LoopGrid MCP tools and their behavior.
- Does not execute external business actions. The underlying MCP tools record and verify decision evidence.

## Installation

After the package is published on PyPI, Claude Code can launch it using:

```bash
uvx loopgrid-claude-launcher==0.1.0
```

The launcher is intended to be configured through the LoopGrid Claude Code plugin. Users should normally install the plugin rather than configure this executable manually.

## Configuration and security

The launcher uses the operator-selected Claude plugin configuration for the Core URL, workspace and service key.

The service key should be configured through the plugin's sensitive `service_key` option. Do not embed credentials in repository files, command-line arguments or committed configuration.

Remote Core connections require HTTPS. Loopback HTTP is supported for local development.

**Important security limitation:** `uvx` starts the Python package manager before this launcher's environment filtering runs. The launcher can sanitize the environment used by the MCP application, but it cannot sanitize the environment already received by `uvx`. This limitation must be considered when deploying the plugin in environments containing sensitive credentials.

## Compatibility

- Claude Code plugin: LoopGrid Decision Evidence
- MCP dependency: `loopgrid-mcp==0.1.0`
- MCP dependency modifications: None
- Package license: Apache-2.0

## Links

- Website: https://loopgrid.io
- Launcher source: https://github.com/loopgridio/loopgrid-claude-launcher
- Claude plugin repository: https://github.com/loopgridio/loopgrid-claude-code
- Privacy policy: https://loopgrid.io/privacy/
- Support: hello@loopgrid.io

## Release and maintenance

This launcher is distributed independently from `loopgrid-mcp`. Updating the Claude-specific launcher does not require releasing a new version of the existing MCP package.

Published versions and installation availability should be verified on PyPI.

The LoopGrid Claude Code plugin and its security requirements are maintained separately from other LoopGrid integrations.
