Metadata-Version: 2.4
Name: zipsa
Version: 0.1.0
Summary: Multi-runtime skill launcher for Claude Code, Codex, and Gemini CLI
Author-email: WestbrookAI <neochoon@gmail.com>
License-Expression: MIT
Keywords: agent,claude,codex,gemini,mcp,runtime
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: pydantic>=2.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: typer>=0.9
Provides-Extra: dev
Requires-Dist: mypy>=1.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.0; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: ruff>=0.1; extra == 'dev'
Description-Content-Type: text/markdown

# Zipsa Launcher

Multi-runtime skill launcher for Claude Code, Codex, and Gemini CLI.

## Installation

```bash
pip install -e ".[dev]"
```

## Configuration

### Runtime Configuration

Create `~/.zipsa/runtime-config.yaml` to configure runtime-specific settings:

```yaml
runtimes:
  claude:
    auto_inject_env:
      - CLAUDE_CODE_OAUTH_TOKEN
```

**How it works:**
- Only environment variables listed in `auto_inject_env` are automatically passed to the container
- If the config file doesn't exist or a runtime is not configured, no auto-injection occurs
- User-provided environment variables (via CLI) always take precedence
- If a listed env var is not set in the host environment, a warning is shown

Example file is provided at `runtime-config.yaml.example`.

## Usage

```bash
# Run a skill
zipsa run weather "Seoul weather"

# With specific runtime
zipsa run weather "Seoul" --runtime claude

# With environment variables (overrides auto-inject)
zipsa run weather "Seoul" --env CLAUDE_CODE_OAUTH_TOKEN=custom-token

# Validate manifest
zipsa validate ../zipsa-skills/weather

# List skills
zipsa list ../zipsa-skills

# List runtimes
zipsa runtimes
```

## Development

See [Design Document](../docs/zipsa-python-design.md) for architecture details.
