Metadata-Version: 2.5
Name: kitup-sdk
Version: 0.1.4
Summary: Shared installer SDK for bundled Agent Skills.
License: Apache-2.0
Keywords: agent,installer,sdk,skills
Requires-Python: >=3.10
Provides-Extra: dev
Requires-Dist: pytest>=8.3.0; extra == 'dev'
Requires-Dist: ruff>=0.12.0; extra == 'dev'
Description-Content-Type: text/markdown

# kitup Python SDK

Shared installer SDK for bundled Agent Skills.

## Install

```bash
pip install kitup-sdk
```

## Use

Use the workflow API for user-facing install commands:

```python
from kitup import (
    BaseOptions,
    InstallOptions,
    InstallWorkflowOptions,
    directory_bundle,
    run_bundled_skill_install,
)

workflow = run_bundled_skill_install(
    InstallWorkflowOptions(
        install=InstallOptions(
            base=BaseOptions(),
            app_id="mycli",
            skill_bundle=directory_bundle("./skills/mycli"),
            scope="user",
        ),
        stdin_tty=True,
        prompt_scope=True,
    )
)
```

Embed a skill directory shipped as package data with:

```python
from importlib.resources import files
from kitup import resources_bundle

bundle = resources_bundle(files("mycli.skills") / "mycli")
```

Call `install_bundled_skill` when your CLI already knows the target scope and agents and does not need the interactive workflow surface.
