gl-cursor-skill 0.1.0__tar.gz

gl_cursor_skill-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,34 @@
+name: CI
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Test and build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      - name: Install Python
+        run: uv python install 3.13
+
+      - name: Sync dependencies
+        run: uv sync --locked --dev
+
+      - name: Run tests
+        run: uv run pytest
+
+      - name: Build package
+        run: uv build

gl_cursor_skill-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,75 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: ["published"]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build distributions
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      - name: Install Python
+        run: uv python install 3.13
+
+      - name: Sync dependencies
+        run: uv sync --locked --dev
+
+      - name: Check release tag matches project version
+        if: github.event_name == 'release'
+        run: |
+          python - <<'PY'
+          import os
+          import tomllib
+
+          tag = os.environ["GITHUB_REF_NAME"]
+          version = tomllib.loads(open("pyproject.toml", "rb").read().decode())["project"]["version"]
+          expected = f"v{version}"
+          if tag != expected:
+              raise SystemExit(f"Release tag {tag!r} does not match pyproject version {version!r}; expected {expected!r}")
+          PY
+
+      - name: Run tests
+        run: uv run pytest
+
+      - name: Build package
+        run: uv build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: distributions
+          path: dist/*
+          if-no-files-found: error
+
+  publish:
+    name: Publish distributions to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: distributions
+          path: dist/
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Publish package
+        run: uv publish

gl_cursor_skill-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+.DS_Store
+.venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+dist/
+build/
+*.egg-info/

gl_cursor_skill-0.1.0/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: gl-cursor-skill
+Version: 0.1.0
+Summary: Move and install AI agent skills between Claude, Codex, Cursor, and project scopes.
+Project-URL: Homepage, https://pypi.org/project/gl-cursor-skill/
+Author: gulei
+License-Expression: MIT
+Requires-Python: >=3.10
+Requires-Dist: questionary>=2.1.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: typer>=0.16.0
+Description-Content-Type: text/markdown
+
+# gl-cursor-skill
+
+`gl-cursor-skill` installs AI-agent skills between common local skill folders.
+
+Primary usage:
+
+```bash
+uvx gl-cursor-skill add cursor-agent
+```
+
+When options are omitted in an interactive terminal, the CLI asks where to install:
+
+```text
+? Install for which agent?
+  Codex
+  Cursor
+  Claude Code
+
+? Install scope?
+  Global
+  Project
+```
+
+For scripts, pass the choices explicitly:
+
+```bash
+uvx gl-cursor-skill add cursor-agent --agent codex --scope global --from claude --yes
+```
+
+## Supported Targets
+
+| Agent | Global target | Project target |
+| --- | --- | --- |
+| Codex | `~/.codex/skills` | `.codex/skills` |
+| Claude Code | `~/.claude/skills` | `.claude/skills` |
+| Cursor | `~/.cursor/skills` | `.cursor/skills` |
+
+`claude` and `claudecode` are accepted aliases for `claude-code`.
+
+## Commands
+
+```bash
+gl-cursor-skill add <skill>
+gl-cursor-skill agents
+gl-cursor-skill list
+```
+
+Examples:
+
+```bash
+# Interactive install
+uvx gl-cursor-skill add cursor-agent
+
+# Non-interactive install from Claude global skills into Codex global skills
+uvx gl-cursor-skill add cursor-agent --agent codex --scope global --from claude --yes
+
+# Install from an explicit local path
+uvx gl-cursor-skill add /path/to/cursor-agent --agent codex --scope global --yes
+
+# Preview without copying files
+uvx gl-cursor-skill add cursor-agent --agent codex --scope global --from claude --dry-run --yes
+
+# Overwrite an existing target skill
+uvx gl-cursor-skill add cursor-agent --agent codex --scope global --from claude --force --yes
+```
+
+## Development
+
+```bash
+uv sync
+uv run pytest
+uv run gl-cursor-skill --help
+uv build
+```
+
+## Release From GitHub
+
+The repository includes GitHub Actions workflows:
+
+- `.github/workflows/ci.yml` runs tests and builds the package on push and pull requests.
+- `.github/workflows/publish.yml` publishes to PyPI when a GitHub Release is published.
+
+Recommended setup:
+
+1. Create a GitHub repository and push this project.
+2. On PyPI, configure a Trusted Publisher for project `gl-cursor-skill`.
+3. Use these PyPI Trusted Publisher values:
+
+```text
+Owner: <your GitHub username or org>
+Repository name: <your repo name>
+Workflow name: publish.yml
+Environment name: pypi
+```
+
+4. For each release, bump the version in `pyproject.toml`, tag the commit as `vX.Y.Z`, and publish a GitHub Release from that tag.
+
+The workflow checks that the release tag matches the package version. For example, version `0.1.0` must be released with tag `v0.1.0`.
+
+Manual local publish also works:
+
+```bash
+UV_PUBLISH_TOKEN="pypi-..." uv publish
+```
+
+If you configure PyPI Trusted Publishing in CI, `uv publish` can run without a token.

gl_cursor_skill-0.1.0/README.md

@@ -0,0 +1,106 @@
+# gl-cursor-skill
+
+`gl-cursor-skill` installs AI-agent skills between common local skill folders.
+
+Primary usage:
+
+```bash
+uvx gl-cursor-skill add cursor-agent
+```
+
+When options are omitted in an interactive terminal, the CLI asks where to install:
+
+```text
+? Install for which agent?
+  Codex
+  Cursor
+  Claude Code
+
+? Install scope?
+  Global
+  Project
+```
+
+For scripts, pass the choices explicitly:
+
+```bash
+uvx gl-cursor-skill add cursor-agent --agent codex --scope global --from claude --yes
+```
+
+## Supported Targets
+
+| Agent | Global target | Project target |
+| --- | --- | --- |
+| Codex | `~/.codex/skills` | `.codex/skills` |
+| Claude Code | `~/.claude/skills` | `.claude/skills` |
+| Cursor | `~/.cursor/skills` | `.cursor/skills` |
+
+`claude` and `claudecode` are accepted aliases for `claude-code`.
+
+## Commands
+
+```bash
+gl-cursor-skill add <skill>
+gl-cursor-skill agents
+gl-cursor-skill list
+```
+
+Examples:
+
+```bash
+# Interactive install
+uvx gl-cursor-skill add cursor-agent
+
+# Non-interactive install from Claude global skills into Codex global skills
+uvx gl-cursor-skill add cursor-agent --agent codex --scope global --from claude --yes
+
+# Install from an explicit local path
+uvx gl-cursor-skill add /path/to/cursor-agent --agent codex --scope global --yes
+
+# Preview without copying files
+uvx gl-cursor-skill add cursor-agent --agent codex --scope global --from claude --dry-run --yes
+
+# Overwrite an existing target skill
+uvx gl-cursor-skill add cursor-agent --agent codex --scope global --from claude --force --yes
+```
+
+## Development
+
+```bash
+uv sync
+uv run pytest
+uv run gl-cursor-skill --help
+uv build
+```
+
+## Release From GitHub
+
+The repository includes GitHub Actions workflows:
+
+- `.github/workflows/ci.yml` runs tests and builds the package on push and pull requests.
+- `.github/workflows/publish.yml` publishes to PyPI when a GitHub Release is published.
+
+Recommended setup:
+
+1. Create a GitHub repository and push this project.
+2. On PyPI, configure a Trusted Publisher for project `gl-cursor-skill`.
+3. Use these PyPI Trusted Publisher values:
+
+```text
+Owner: <your GitHub username or org>
+Repository name: <your repo name>
+Workflow name: publish.yml
+Environment name: pypi
+```
+
+4. For each release, bump the version in `pyproject.toml`, tag the commit as `vX.Y.Z`, and publish a GitHub Release from that tag.
+
+The workflow checks that the release tag matches the package version. For example, version `0.1.0` must be released with tag `v0.1.0`.
+
+Manual local publish also works:
+
+```bash
+UV_PUBLISH_TOKEN="pypi-..." uv publish
+```
+
+If you configure PyPI Trusted Publishing in CI, `uv publish` can run without a token.

gl_cursor_skill-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[project]
+name = "gl-cursor-skill"
+version = "0.1.0"
+description = "Move and install AI agent skills between Claude, Codex, Cursor, and project scopes."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+  { name = "gulei" }
+]
+dependencies = [
+  "questionary>=2.1.0",
+  "rich>=13.7.0",
+  "typer>=0.16.0",
+]
+
+[project.urls]
+Homepage = "https://pypi.org/project/gl-cursor-skill/"
+
+[project.scripts]
+gl-cursor-skill = "gl_cursor_skill.cli:main"
+
+[dependency-groups]
+dev = [
+  "pytest>=8.2.0",
+]
+
+[build-system]
+requires = ["hatchling>=1.26"]
+build-backend = "hatchling.build"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

gl_cursor_skill-0.1.0/src/gl_cursor_skill/__init__.py

@@ -0,0 +1,3 @@
+"""Tools for installing local AI-agent skills."""
+
+__version__ = "0.1.0"

gl_cursor_skill-0.1.0/src/gl_cursor_skill/agents.py

@@ -0,0 +1,54 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from pathlib import Path
+
+
+@dataclass(frozen=True)
+class AgentProfile:
+    key: str
+    label: str
+    global_dir: Path
+    project_dir: Path
+    aliases: tuple[str, ...] = ()
+
+
+def home() -> Path:
+    return Path.home()
+
+
+AGENTS: tuple[AgentProfile, ...] = (
+    AgentProfile(
+        key="codex",
+        label="Codex",
+        global_dir=home() / ".codex" / "skills",
+        project_dir=Path(".codex") / "skills",
+    ),
+    AgentProfile(
+        key="claude-code",
+        label="Claude Code",
+        global_dir=home() / ".claude" / "skills",
+        project_dir=Path(".claude") / "skills",
+        aliases=("claude", "claudecode", "claude_code"),
+    ),
+    AgentProfile(
+        key="cursor",
+        label="Cursor",
+        global_dir=home() / ".cursor" / "skills",
+        project_dir=Path(".cursor") / "skills",
+    ),
+)
+
+
+def normalize_agent(value: str) -> AgentProfile:
+    wanted = value.strip().lower().replace(" ", "-")
+    for agent in AGENTS:
+        names = (agent.key, *agent.aliases)
+        if wanted in names:
+            return agent
+    valid = ", ".join(agent.key for agent in AGENTS)
+    raise ValueError(f"Unknown agent '{value}'. Expected one of: {valid}")
+
+
+def agent_choices() -> list[tuple[str, str]]:
+    return [(agent.label, agent.key) for agent in AGENTS]

gl_cursor_skill-0.1.0/src/gl_cursor_skill/cli.py

@@ -0,0 +1,267 @@
+from __future__ import annotations
+
+from pathlib import Path
+import sys
+from typing import Optional
+
+import questionary
+from rich.console import Console
+from rich.table import Table
+import typer
+
+from . import __version__
+from .agents import AGENTS, agent_choices, normalize_agent
+from .core import (
+    SkillCandidate,
+    SkillError,
+    build_install_plan,
+    install_skill,
+    known_source_dirs,
+    normalize_scope,
+    resolve_source_candidates,
+)
+
+
+app = typer.Typer(
+    add_completion=False,
+    help="Install AI-agent skills between Claude, Codex, Cursor, and project scopes.",
+    no_args_is_help=True,
+)
+console = Console()
+
+
+def _version_callback(value: bool) -> None:
+    if value:
+        console.print(f"gl-cursor-skill {__version__}")
+        raise typer.Exit()
+
+
+@app.callback()
+def callback(
+    version: bool = typer.Option(
+        False,
+        "--version",
+        help="Show the installed gl-cursor-skill version.",
+        callback=_version_callback,
+        is_eager=True,
+    ),
+) -> None:
+    pass
+
+
+@app.command()
+def agents() -> None:
+    """Show known agent skill directories."""
+    table = Table(title="Known agent skill directories")
+    table.add_column("Agent")
+    table.add_column("Global")
+    table.add_column("Project")
+
+    for agent in AGENTS:
+        table.add_row(agent.label, str(agent.global_dir), str(agent.project_dir))
+
+    console.print(table)
+
+
+@app.command(name="list")
+def list_skills(
+    project_dir: Optional[Path] = typer.Option(
+        None,
+        "--project-dir",
+        "-p",
+        help="Project root used when listing project skill folders.",
+    ),
+) -> None:
+    """List discovered local skills."""
+    table = Table(title="Discovered skills")
+    table.add_column("Source")
+    table.add_column("Skill")
+    table.add_column("Path")
+
+    found_any = False
+    for base in known_source_dirs(project_dir):
+        if not base.path.is_dir():
+            continue
+        for child in sorted(base.path.iterdir(), key=lambda item: item.name.lower()):
+            if child.is_dir() and (child / "SKILL.md").is_file():
+                found_any = True
+                table.add_row(base.label, child.name, str(child))
+
+    if found_any:
+        console.print(table)
+    else:
+        console.print("[yellow]No skills found in known directories.[/yellow]")
+
+
+@app.command()
+def add(
+    skill: Optional[str] = typer.Argument(
+        None,
+        help="Skill name or path to a skill directory containing SKILL.md.",
+    ),
+    agent: Optional[str] = typer.Option(
+        None,
+        "--agent",
+        "-a",
+        help="Target agent: codex, cursor, or claude-code.",
+    ),
+    scope: Optional[str] = typer.Option(
+        None,
+        "--scope",
+        "-s",
+        help="Install scope: global or project.",
+    ),
+    source: Optional[str] = typer.Option(
+        None,
+        "--from",
+        "-f",
+        help="Source agent or path. Examples: claude, codex, cursor, /path/to/skill.",
+    ),
+    project_dir: Optional[Path] = typer.Option(
+        None,
+        "--project-dir",
+        "-p",
+        help="Project root used for project scope and project-source discovery.",
+    ),
+    dest: Optional[Path] = typer.Option(
+        None,
+        "--dest",
+        help="Override the destination skills directory.",
+    ),
+    force: bool = typer.Option(
+        False,
+        "--force",
+        help="Overwrite the target skill if it already exists.",
+    ),
+    dry_run: bool = typer.Option(
+        False,
+        "--dry-run",
+        help="Print the planned install without copying files.",
+    ),
+    yes: bool = typer.Option(
+        False,
+        "--yes",
+        "-y",
+        help="Do not prompt; use defaults where possible.",
+    ),
+) -> None:
+    """Install a skill into an agent's global or project skill directory."""
+    interactive = _can_prompt(yes)
+    project_root = project_dir.expanduser() if project_dir is not None else Path.cwd()
+
+    try:
+        skill_name = _resolve_skill_arg(skill, interactive)
+        target_agent = normalize_agent(agent) if agent else _choose_agent(interactive, yes)
+        target_scope = normalize_scope(scope) if scope else _choose_scope(interactive, yes)
+        source_dir = _choose_source(skill_name, source, project_root, interactive, yes)
+        plan = build_install_plan(source_dir, target_agent, target_scope, project_root, dest)
+        _print_plan(plan, dry_run, force)
+        install_skill(plan, force=force, dry_run=dry_run)
+    except (SkillError, ValueError) as error:
+        console.print(f"[red]Error:[/red] {error}")
+        raise typer.Exit(code=1) from error
+
+    if dry_run:
+        console.print("[cyan]Dry run complete. No files were changed.[/cyan]")
+    else:
+        console.print(f"[green]Installed[/green] {plan.skill_name} -> {plan.target_dir}")
+        console.print("Restart the target agent if it does not pick up new skills automatically.")
+
+
+def _can_prompt(yes: bool) -> bool:
+    return not yes and sys.stdin.isatty() and sys.stdout.isatty()
+
+
+def _resolve_skill_arg(skill: Optional[str], interactive: bool) -> str:
+    if skill:
+        return skill
+    if not interactive:
+        raise SkillError("Skill is required in non-interactive mode.")
+    answer = questionary.text("Skill name or path:").ask()
+    if not answer:
+        raise SkillError("Skill is required.")
+    return answer
+
+
+def _choose_agent(interactive: bool, yes: bool):
+    if yes:
+        return normalize_agent("codex")
+    if not interactive:
+        raise SkillError("Missing --agent in non-interactive mode.")
+
+    choices = [questionary.Choice(title=label, value=value) for label, value in agent_choices()]
+    answer = questionary.select("Install for which agent?", choices=choices).ask()
+    if not answer:
+        raise SkillError("Target agent is required.")
+    return normalize_agent(answer)
+
+
+def _choose_scope(interactive: bool, yes: bool) -> str:
+    if yes:
+        return "global"
+    if not interactive:
+        raise SkillError("Missing --scope in non-interactive mode.")
+
+    answer = questionary.select(
+        "Install scope?",
+        choices=[
+            questionary.Choice(title="Global", value="global"),
+            questionary.Choice(title="Project", value="project"),
+        ],
+    ).ask()
+    if not answer:
+        raise SkillError("Scope is required.")
+    return normalize_scope(answer)
+
+
+def _choose_source(
+    skill: str,
+    source: Optional[str],
+    project_root: Path,
+    interactive: bool,
+    yes: bool,
+) -> Path:
+    candidates = resolve_source_candidates(skill, source, project_root)
+    if not candidates:
+        hint = f" from '{source}'" if source else ""
+        raise SkillError(f"Could not find skill '{skill}'{hint}.")
+
+    if len(candidates) == 1:
+        return candidates[0].path
+
+    if yes:
+        return candidates[0].path
+
+    if not interactive:
+        lines = "\n".join(f"- {candidate.label}: {candidate.path}" for candidate in candidates)
+        raise SkillError(f"Multiple source skills found; pass --from or run interactively.\n{lines}")
+
+    choices = [
+        questionary.Choice(title=f"{candidate.label}: {candidate.path}", value=str(index))
+        for index, candidate in enumerate(candidates)
+    ]
+    answer = questionary.select("Install from which source?", choices=choices).ask()
+    if answer is None:
+        raise SkillError("Source selection is required.")
+    return candidates[int(answer)].path
+
+
+def _print_plan(plan, dry_run: bool, force: bool) -> None:
+    table = Table(title="Install plan")
+    table.add_column("Field")
+    table.add_column("Value")
+    table.add_row("Skill", plan.skill_name)
+    table.add_row("Target agent", plan.target_agent.label)
+    table.add_row("Scope", plan.scope)
+    table.add_row("Source", str(plan.source_dir))
+    table.add_row("Destination", str(plan.target_dir))
+    table.add_row("Target exists", "yes" if plan.target_dir.exists() else "no")
+    table.add_row("Mode", "dry-run" if dry_run else "copy")
+    table.add_row("Overwrite", "yes" if force else "no")
+    console.print(table)
+    if dry_run and plan.target_dir.exists() and not force:
+        console.print("[yellow]Target already exists; actual install would need --force.[/yellow]")
+
+
+def main() -> None:
+    app()

gl_cursor_skill-0.1.0/src/gl_cursor_skill/core.py

@@ -0,0 +1,171 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from pathlib import Path
+import shutil
+
+from .agents import AGENTS, AgentProfile, normalize_agent
+
+
+class SkillError(RuntimeError):
+    pass
+
+
+@dataclass(frozen=True)
+class SkillCandidate:
+    path: Path
+    label: str
+
+
+@dataclass(frozen=True)
+class InstallPlan:
+    source_dir: Path
+    target_dir: Path
+    skill_name: str
+    target_agent: AgentProfile
+    scope: str
+
+
+def find_skill_file(path: Path) -> Path | None:
+    if path.is_file() and path.name.lower() == "skill.md":
+        return path
+    if not path.is_dir():
+        return None
+    for name in ("SKILL.md", "skill.md"):
+        candidate = path / name
+        if candidate.is_file():
+            return candidate
+    return None
+
+
+def ensure_skill_dir(path: Path) -> Path:
+    expanded = path.expanduser()
+    if expanded.is_file() and expanded.name.lower() == "skill.md":
+        expanded = expanded.parent
+    skill_file = find_skill_file(expanded)
+    if skill_file is None:
+        raise SkillError(f"Not a skill directory: {expanded}")
+    return expanded
+
+
+def target_base_dir(
+    agent: AgentProfile,
+    scope: str,
+    project_root: Path | None = None,
+    explicit_dest: Path | None = None,
+) -> Path:
+    if explicit_dest is not None:
+        return explicit_dest.expanduser()
+
+    normalized_scope = normalize_scope(scope)
+    if normalized_scope == "global":
+        return agent.global_dir
+
+    root = project_root.expanduser() if project_root is not None else Path.cwd()
+    return root / agent.project_dir
+
+
+def normalize_scope(value: str) -> str:
+    normalized = value.strip().lower()
+    if normalized not in {"global", "project"}:
+        raise ValueError("Scope must be either 'global' or 'project'")
+    return normalized
+
+
+def known_source_dirs(project_root: Path | None = None) -> list[SkillCandidate]:
+    root = project_root.expanduser() if project_root is not None else Path.cwd()
+    candidates: list[SkillCandidate] = []
+
+    for agent in AGENTS:
+        candidates.append(SkillCandidate(agent.global_dir, f"{agent.label} global"))
+        candidates.append(SkillCandidate(root / agent.project_dir, f"{agent.label} project"))
+
+    return candidates
+
+
+def resolve_source_candidates(
+    skill: str,
+    source: str | None = None,
+    project_root: Path | None = None,
+) -> list[SkillCandidate]:
+    skill_path = Path(skill).expanduser()
+    if skill_path.exists():
+        source_dir = ensure_skill_dir(skill_path)
+        return [SkillCandidate(source_dir, "explicit path")]
+
+    source_path = Path(source).expanduser() if source else None
+    if source_path is not None and source_path.exists():
+        if find_skill_file(source_path) is not None:
+            source_dir = ensure_skill_dir(source_path)
+        elif source_path.is_dir():
+            source_dir = ensure_skill_dir(source_path / skill)
+        else:
+            source_dir = ensure_skill_dir(source_path)
+        return [SkillCandidate(source_dir, "explicit --from path")]
+
+    search_dirs = _source_search_dirs(source, project_root)
+    found: list[SkillCandidate] = []
+    seen: set[Path] = set()
+    for base in search_dirs:
+        candidate_dir = base.path / skill
+        if find_skill_file(candidate_dir) is None:
+            continue
+        resolved = candidate_dir.resolve()
+        if resolved in seen:
+            continue
+        seen.add(resolved)
+        found.append(SkillCandidate(candidate_dir, base.label))
+
+    return found
+
+
+def _source_search_dirs(source: str | None, project_root: Path | None) -> list[SkillCandidate]:
+    if source is None:
+        return known_source_dirs(project_root)
+
+    try:
+        agent = normalize_agent(source)
+    except ValueError as error:
+        raise SkillError(str(error)) from error
+
+    root = project_root.expanduser() if project_root is not None else Path.cwd()
+    return [
+        SkillCandidate(agent.global_dir, f"{agent.label} global"),
+        SkillCandidate(root / agent.project_dir, f"{agent.label} project"),
+    ]
+
+
+def build_install_plan(
+    source_dir: Path,
+    target_agent: AgentProfile,
+    scope: str,
+    project_root: Path | None = None,
+    explicit_dest: Path | None = None,
+) -> InstallPlan:
+    source = ensure_skill_dir(source_dir)
+    base = target_base_dir(target_agent, scope, project_root, explicit_dest)
+    return InstallPlan(
+        source_dir=source,
+        target_dir=base / source.name,
+        skill_name=source.name,
+        target_agent=target_agent,
+        scope=normalize_scope(scope),
+    )
+
+
+def install_skill(plan: InstallPlan, force: bool = False, dry_run: bool = False) -> None:
+    if plan.target_dir.exists():
+        if dry_run:
+            return
+        if not force:
+            raise SkillError(f"Target already exists: {plan.target_dir}")
+        if plan.target_dir.is_dir():
+            shutil.rmtree(plan.target_dir)
+        else:
+            plan.target_dir.unlink()
+
+    if dry_run:
+        return
+
+    plan.target_dir.parent.mkdir(parents=True, exist_ok=True)
+    shutil.copytree(plan.source_dir, plan.target_dir)

gl_cursor_skill-0.1.0/tests/test_core.py

@@ -0,0 +1,101 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+import pytest
+
+from gl_cursor_skill.agents import normalize_agent
+from gl_cursor_skill.core import (
+    SkillError,
+    build_install_plan,
+    ensure_skill_dir,
+    install_skill,
+    normalize_scope,
+    resolve_source_candidates,
+)
+
+
+def make_skill(path: Path) -> Path:
+    path.mkdir(parents=True)
+    (path / "SKILL.md").write_text("---\nname: demo\n---\n# Demo\n", encoding="utf-8")
+    return path
+
+
+def test_normalize_agent_aliases() -> None:
+    assert normalize_agent("codex").key == "codex"
+    assert normalize_agent("claudecode").key == "claude-code"
+    assert normalize_agent("claude").key == "claude-code"
+
+
+def test_normalize_scope() -> None:
+    assert normalize_scope("global") == "global"
+    assert normalize_scope("project") == "project"
+    with pytest.raises(ValueError):
+        normalize_scope("workspace")
+
+
+def test_ensure_skill_dir_accepts_directory_and_skill_file(tmp_path: Path) -> None:
+    skill = make_skill(tmp_path / "cursor-agent")
+    assert ensure_skill_dir(skill) == skill
+    assert ensure_skill_dir(skill / "SKILL.md") == skill
+
+
+def test_install_skill_to_explicit_destination(tmp_path: Path) -> None:
+    source = make_skill(tmp_path / "source" / "cursor-agent")
+    dest = tmp_path / "dest"
+    plan = build_install_plan(source, normalize_agent("codex"), "global", explicit_dest=dest)
+
+    install_skill(plan)
+
+    assert (dest / "cursor-agent" / "SKILL.md").is_file()
+
+
+def test_install_skill_requires_force_for_existing_target(tmp_path: Path) -> None:
+    source = make_skill(tmp_path / "source" / "cursor-agent")
+    dest = tmp_path / "dest"
+    plan = build_install_plan(source, normalize_agent("codex"), "global", explicit_dest=dest)
+    install_skill(plan)
+
+    with pytest.raises(SkillError):
+        install_skill(plan)
+
+    install_skill(plan, force=True)
+    assert (dest / "cursor-agent" / "SKILL.md").is_file()
+
+
+def test_dry_run_does_not_require_force_for_existing_target(tmp_path: Path) -> None:
+    source = make_skill(tmp_path / "source" / "cursor-agent")
+    dest = tmp_path / "dest"
+    plan = build_install_plan(source, normalize_agent("codex"), "global", explicit_dest=dest)
+    install_skill(plan)
+
+    install_skill(plan, dry_run=True)
+
+    assert (dest / "cursor-agent" / "SKILL.md").is_file()
+
+
+def test_resolve_source_candidates_from_explicit_path(tmp_path: Path) -> None:
+    source = make_skill(tmp_path / "source" / "cursor-agent")
+
+    candidates = resolve_source_candidates(str(source))
+
+    assert len(candidates) == 1
+    assert candidates[0].path == source
+
+
+def test_resolve_source_candidates_from_exact_from_path(tmp_path: Path) -> None:
+    source = make_skill(tmp_path / "source" / "cursor-agent")
+
+    candidates = resolve_source_candidates("cursor-agent", source=str(source))
+
+    assert len(candidates) == 1
+    assert candidates[0].path == source
+
+
+def test_resolve_source_candidates_from_parent_from_path(tmp_path: Path) -> None:
+    source = make_skill(tmp_path / "source" / "cursor-agent")
+
+    candidates = resolve_source_candidates("cursor-agent", source=str(source.parent))
+
+    assert len(candidates) == 1
+    assert candidates[0].path == source

gl_cursor_skill-0.1.0/uv.lock

@@ -0,0 +1,266 @@
+version = 1
+revision = 3
+requires-python = ">=3.10"
+
+[[package]]
+name = "annotated-doc"
+version = "0.0.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/57/ba/046ceea27344560984e26a590f90bc7f4a75b06701f653222458922b558c/annotated_doc-0.0.4.tar.gz", hash = "sha256:fbcda96e87e9c92ad167c2e53839e57503ecfda18804ea28102353485033faa4", size = 7288, upload-time = "2025-11-10T22:07:42.062Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1e/d3/26bf1008eb3d2daa8ef4cacc7f3bfdc11818d111f7e2d0201bc6e3b49d45/annotated_doc-0.0.4-py3-none-any.whl", hash = "sha256:571ac1dc6991c450b25a9c2d84a3705e2ae7a53467b5d111c24fa8baabbed320", size = 5303, upload-time = "2025-11-10T22:07:40.673Z" },
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "exceptiongroup"
+version = "1.3.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/50/79/66800aadf48771f6b62f7eb014e352e5d06856655206165d775e675a02c9/exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219", size = 30371, upload-time = "2025-11-21T23:01:54.787Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8a/0e/97c33bf5009bdbac74fd2beace167cab3f978feb69cc36f1ef79360d6c4e/exceptiongroup-1.3.1-py3-none-any.whl", hash = "sha256:a7a39a3bd276781e98394987d3a5701d0c4edffb633bb7a5144577f82c773598", size = 16740, upload-time = "2025-11-21T23:01:53.443Z" },
+]
+
+[[package]]
+name = "gl-cursor-skill"
+version = "0.1.0"
+source = { editable = "." }
+dependencies = [
+    { name = "questionary" },
+    { name = "rich" },
+    { name = "typer" },
+]
+
+[package.dev-dependencies]
+dev = [
+    { name = "pytest" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "questionary", specifier = ">=2.1.0" },
+    { name = "rich", specifier = ">=13.7.0" },
+    { name = "typer", specifier = ">=0.16.0" },
+]
+
+[package.metadata.requires-dev]
+dev = [{ name = "pytest", specifier = ">=8.2.0" }]
+
+[[package]]
+name = "iniconfig"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },
+]
+
+[[package]]
+name = "markdown-it-py"
+version = "4.2.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "mdurl" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/06/ff/7841249c247aa650a76b9ee4bbaeae59370dc8bfd2f6c01f3630c35eb134/markdown_it_py-4.2.0.tar.gz", hash = "sha256:04a21681d6fbb623de53f6f364d352309d4094dd4194040a10fd51833e418d49", size = 82454, upload-time = "2026-05-07T12:08:28.36Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b3/81/4da04ced5a082363ecfa159c010d200ecbd959ae410c10c0264a38cac0f5/markdown_it_py-4.2.0-py3-none-any.whl", hash = "sha256:9f7ebbcd14fe59494226453aed97c1070d83f8d24b6fc3a3bcf9a38092641c4a", size = 91687, upload-time = "2026-05-07T12:08:27.182Z" },
+]
+
+[[package]]
+name = "mdurl"
+version = "0.1.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d6/54/cfe61301667036ec958cb99bd3efefba235e65cdeb9c84d24a8293ba1d90/mdurl-0.1.2.tar.gz", hash = "sha256:bb413d29f5eea38f31dd4754dd7377d4465116fb207585f97bf925588687c1ba", size = 8729, upload-time = "2022-08-14T12:40:10.846Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b3/38/89ba8ad64ae25be8de66a6d463314cf1eb366222074cfda9ee839c56a4b4/mdurl-0.1.2-py3-none-any.whl", hash = "sha256:84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8", size = 9979, upload-time = "2022-08-14T12:40:09.779Z" },
+]
+
+[[package]]
+name = "packaging"
+version = "26.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d7/f1/e7a6dd94a8d4a5626c03e4e99c87f241ba9e350cd9e6d75123f992427270/packaging-26.2.tar.gz", hash = "sha256:ff452ff5a3e828ce110190feff1178bb1f2ea2281fa2075aadb987c2fb221661", size = 228134, upload-time = "2026-04-24T20:15:23.917Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/df/b2/87e62e8c3e2f4b32e5fe99e0b86d576da1312593b39f47d8ceef365e95ed/packaging-26.2-py3-none-any.whl", hash = "sha256:5fc45236b9446107ff2415ce77c807cee2862cb6fac22b8a73826d0693b0980e", size = 100195, upload-time = "2026-04-24T20:15:22.081Z" },
+]
+
+[[package]]
+name = "pluggy"
+version = "1.6.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
+]
+
+[[package]]
+name = "prompt-toolkit"
+version = "3.0.52"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "wcwidth" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/a1/96/06e01a7b38dce6fe1db213e061a4602dd6032a8a97ef6c1a862537732421/prompt_toolkit-3.0.52.tar.gz", hash = "sha256:28cde192929c8e7321de85de1ddbe736f1375148b02f2e17edd840042b1be855", size = 434198, upload-time = "2025-08-27T15:24:02.057Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/84/03/0d3ce49e2505ae70cf43bc5bb3033955d2fc9f932163e84dc0779cc47f48/prompt_toolkit-3.0.52-py3-none-any.whl", hash = "sha256:9aac639a3bbd33284347de5ad8d68ecc044b91a762dc39b7c21095fcd6a19955", size = 391431, upload-time = "2025-08-27T15:23:59.498Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.20.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c3/b2/bc9c9196916376152d655522fdcebac55e66de6603a76a02bca1b6414f6c/pygments-2.20.0.tar.gz", hash = "sha256:6757cd03768053ff99f3039c1a36d6c0aa0b263438fcab17520b30a303a82b5f", size = 4955991, upload-time = "2026-03-29T13:29:33.898Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f4/7e/a72dd26f3b0f4f2bf1dd8923c85f7ceb43172af56d63c7383eb62b332364/pygments-2.20.0-py3-none-any.whl", hash = "sha256:81a9e26dd42fd28a23a2d169d86d7ac03b46e2f8b59ed4698fb4785f946d0176", size = 1231151, upload-time = "2026-03-29T13:29:30.038Z" },
+]
+
+[[package]]
+name = "pytest"
+version = "9.1.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "exceptiongroup", marker = "python_full_version < '3.11'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+    { name = "tomli", marker = "python_full_version < '3.11'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/e4/47/b9efed96c114afcfa3c9d3fe98a76a1d14c74a9e266d397cf6eb64be5e01/pytest-9.1.1.tar.gz", hash = "sha256:1088fbde8f2b49d95a549a195707afa7a76a3ce9bcadc26b6d71f0ffda5fe313", size = 1636369, upload-time = "2026-06-19T10:58:32.857Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/24/25/1de2678b631f5a49215c6c96fff41ba892b0a34df68d6d80292b1b48aa7f/pytest-9.1.1-py3-none-any.whl", hash = "sha256:37a86b45efb9a47a61a36449063e8e18d0cab3161329fc099eb21783169c4f0c", size = 386536, upload-time = "2026-06-19T10:58:31.347Z" },
+]
+
+[[package]]
+name = "questionary"
+version = "2.1.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "prompt-toolkit" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/f6/45/eafb0bba0f9988f6a2520f9ca2df2c82ddfa8d67c95d6625452e97b204a5/questionary-2.1.1.tar.gz", hash = "sha256:3d7e980292bb0107abaa79c68dd3eee3c561b83a0f89ae482860b181c8bd412d", size = 25845, upload-time = "2025-08-28T19:00:20.851Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3c/26/1062c7ec1b053db9e499b4d2d5bc231743201b74051c973dadeac80a8f43/questionary-2.1.1-py3-none-any.whl", hash = "sha256:a51af13f345f1cdea62347589fbb6df3b290306ab8930713bfae4d475a7d4a59", size = 36753, upload-time = "2025-08-28T19:00:19.56Z" },
+]
+
+[[package]]
+name = "rich"
+version = "15.0.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "markdown-it-py" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/c0/8f/0722ca900cc807c13a6a0c696dacf35430f72e0ec571c4275d2371fca3e9/rich-15.0.0.tar.gz", hash = "sha256:edd07a4824c6b40189fb7ac9bc4c52536e9780fbbfbddf6f1e2502c31b068c36", size = 230680, upload-time = "2026-04-12T08:24:00.75Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/82/3b/64d4899d73f91ba49a8c18a8ff3f0ea8f1c1d75481760df8c68ef5235bf5/rich-15.0.0-py3-none-any.whl", hash = "sha256:33bd4ef74232fb73fe9279a257718407f169c09b78a87ad3d296f548e27de0bb", size = 310654, upload-time = "2026-04-12T08:24:02.83Z" },
+]
+
+[[package]]
+name = "shellingham"
+version = "1.5.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/58/15/8b3609fd3830ef7b27b655beb4b4e9c62313a4e8da8c676e142cc210d58e/shellingham-1.5.4.tar.gz", hash = "sha256:8dbca0739d487e5bd35ab3ca4b36e11c4078f3a234bfce294b0a0291363404de", size = 10310, upload-time = "2023-10-24T04:13:40.426Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e0/f9/0595336914c5619e5f28a1fb793285925a8cd4b432c9da0a987836c7f822/shellingham-1.5.4-py2.py3-none-any.whl", hash = "sha256:7ecfff8f2fd72616f7481040475a65b2bf8af90a56c89140852d1120324e8686", size = 9755, upload-time = "2023-10-24T04:13:38.866Z" },
+]
+
+[[package]]
+name = "tomli"
+version = "2.4.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/22/de/48c59722572767841493b26183a0d1cc411d54fd759c5607c4590b6563a6/tomli-2.4.1.tar.gz", hash = "sha256:7c7e1a961a0b2f2472c1ac5b69affa0ae1132c39adcb67aba98568702b9cc23f", size = 17543, upload-time = "2026-03-25T20:22:03.828Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f4/11/db3d5885d8528263d8adc260bb2d28ebf1270b96e98f0e0268d32b8d9900/tomli-2.4.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:f8f0fc26ec2cc2b965b7a3b87cd19c5c6b8c5e5f436b984e85f486d652285c30", size = 154704, upload-time = "2026-03-25T20:21:10.473Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/f7/675db52c7e46064a9aa928885a9b20f4124ecb9bc2e1ce74c9106648d202/tomli-2.4.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:4ab97e64ccda8756376892c53a72bd1f964e519c77236368527f758fbc36a53a", size = 149454, upload-time = "2026-03-25T20:21:12.036Z" },
+    { url = "https://files.pythonhosted.org/packages/61/71/81c50943cf953efa35bce7646caab3cf457a7d8c030b27cfb40d7235f9ee/tomli-2.4.1-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:96481a5786729fd470164b47cdb3e0e58062a496f455ee41b4403be77cb5a076", size = 237561, upload-time = "2026-03-25T20:21:13.098Z" },
+    { url = "https://files.pythonhosted.org/packages/48/c1/f41d9cb618acccca7df82aaf682f9b49013c9397212cb9f53219e3abac37/tomli-2.4.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:5a881ab208c0baf688221f8cecc5401bd291d67e38a1ac884d6736cbcd8247e9", size = 243824, upload-time = "2026-03-25T20:21:14.569Z" },
+    { url = "https://files.pythonhosted.org/packages/22/e4/5a816ecdd1f8ca51fb756ef684b90f2780afc52fc67f987e3c61d800a46d/tomli-2.4.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:47149d5bd38761ac8be13a84864bf0b7b70bc051806bc3669ab1cbc56216b23c", size = 242227, upload-time = "2026-03-25T20:21:15.712Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/49/2b2a0ef529aa6eec245d25f0c703e020a73955ad7edf73e7f54ddc608aa5/tomli-2.4.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:ec9bfaf3ad2df51ace80688143a6a4ebc09a248f6ff781a9945e51937008fcbc", size = 247859, upload-time = "2026-03-25T20:21:17.001Z" },
+    { url = "https://files.pythonhosted.org/packages/83/bd/6c1a630eaca337e1e78c5903104f831bda934c426f9231429396ce3c3467/tomli-2.4.1-cp311-cp311-win32.whl", hash = "sha256:ff2983983d34813c1aeb0fa89091e76c3a22889ee83ab27c5eeb45100560c049", size = 97204, upload-time = "2026-03-25T20:21:18.079Z" },
+    { url = "https://files.pythonhosted.org/packages/42/59/71461df1a885647e10b6bb7802d0b8e66480c61f3f43079e0dcd315b3954/tomli-2.4.1-cp311-cp311-win_amd64.whl", hash = "sha256:5ee18d9ebdb417e384b58fe414e8d6af9f4e7a0ae761519fb50f721de398dd4e", size = 108084, upload-time = "2026-03-25T20:21:18.978Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/83/dceca96142499c069475b790e7913b1044c1a4337e700751f48ed723f883/tomli-2.4.1-cp311-cp311-win_arm64.whl", hash = "sha256:c2541745709bad0264b7d4705ad453b76ccd191e64aa6f0fc66b69a293a45ece", size = 95285, upload-time = "2026-03-25T20:21:20.309Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/ba/42f134a3fe2b370f555f44b1d72feebb94debcab01676bf918d0cb70e9aa/tomli-2.4.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:c742f741d58a28940ce01d58f0ab2ea3ced8b12402f162f4d534dfe18ba1cd6a", size = 155924, upload-time = "2026-03-25T20:21:21.626Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/c7/62d7a17c26487ade21c5422b646110f2162f1fcc95980ef7f63e73c68f14/tomli-2.4.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:7f86fd587c4ed9dd76f318225e7d9b29cfc5a9d43de44e5754db8d1128487085", size = 150018, upload-time = "2026-03-25T20:21:23.002Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/05/79d13d7c15f13bdef410bdd49a6485b1c37d28968314eabee452c22a7fda/tomli-2.4.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ff18e6a727ee0ab0388507b89d1bc6a22b138d1e2fa56d1ad494586d61d2eae9", size = 244948, upload-time = "2026-03-25T20:21:24.04Z" },
+    { url = "https://files.pythonhosted.org/packages/10/90/d62ce007a1c80d0b2c93e02cab211224756240884751b94ca72df8a875ca/tomli-2.4.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:136443dbd7e1dee43c68ac2694fde36b2849865fa258d39bf822c10e8068eac5", size = 253341, upload-time = "2026-03-25T20:21:25.177Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/7e/caf6496d60152ad4ed09282c1885cca4eea150bfd007da84aea07bcc0a3e/tomli-2.4.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:5e262d41726bc187e69af7825504c933b6794dc3fbd5945e41a79bb14c31f585", size = 248159, upload-time = "2026-03-25T20:21:26.364Z" },
+    { url = "https://files.pythonhosted.org/packages/99/e7/c6f69c3120de34bbd882c6fba7975f3d7a746e9218e56ab46a1bc4b42552/tomli-2.4.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:5cb41aa38891e073ee49d55fbc7839cfdb2bc0e600add13874d048c94aadddd1", size = 253290, upload-time = "2026-03-25T20:21:27.46Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/2f/4a3c322f22c5c66c4b836ec58211641a4067364f5dcdd7b974b4c5da300c/tomli-2.4.1-cp312-cp312-win32.whl", hash = "sha256:da25dc3563bff5965356133435b757a795a17b17d01dbc0f42fb32447ddfd917", size = 98141, upload-time = "2026-03-25T20:21:28.492Z" },
+    { url = "https://files.pythonhosted.org/packages/24/22/4daacd05391b92c55759d55eaee21e1dfaea86ce5c571f10083360adf534/tomli-2.4.1-cp312-cp312-win_amd64.whl", hash = "sha256:52c8ef851d9a240f11a88c003eacb03c31fc1c9c4ec64a99a0f922b93874fda9", size = 108847, upload-time = "2026-03-25T20:21:29.386Z" },
+    { url = "https://files.pythonhosted.org/packages/68/fd/70e768887666ddd9e9f5d85129e84910f2db2796f9096aa02b721a53098d/tomli-2.4.1-cp312-cp312-win_arm64.whl", hash = "sha256:f758f1b9299d059cc3f6546ae2af89670cb1c4d48ea29c3cacc4fe7de3058257", size = 95088, upload-time = "2026-03-25T20:21:30.677Z" },
+    { url = "https://files.pythonhosted.org/packages/07/06/b823a7e818c756d9a7123ba2cda7d07bc2dd32835648d1a7b7b7a05d848d/tomli-2.4.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:36d2bd2ad5fb9eaddba5226aa02c8ec3fa4f192631e347b3ed28186d43be6b54", size = 155866, upload-time = "2026-03-25T20:21:31.65Z" },
+    { url = "https://files.pythonhosted.org/packages/14/6f/12645cf7f08e1a20c7eb8c297c6f11d31c1b50f316a7e7e1e1de6e2e7b7e/tomli-2.4.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:eb0dc4e38e6a1fd579e5d50369aa2e10acfc9cace504579b2faabb478e76941a", size = 149887, upload-time = "2026-03-25T20:21:33.028Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/e0/90637574e5e7212c09099c67ad349b04ec4d6020324539297b634a0192b0/tomli-2.4.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c7f2c7f2b9ca6bdeef8f0fa897f8e05085923eb091721675170254cbc5b02897", size = 243704, upload-time = "2026-03-25T20:21:34.51Z" },
+    { url = "https://files.pythonhosted.org/packages/10/8f/d3ddb16c5a4befdf31a23307f72828686ab2096f068eaf56631e136c1fdd/tomli-2.4.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f3c6818a1a86dd6dca7ddcaaf76947d5ba31aecc28cb1b67009a5877c9a64f3f", size = 251628, upload-time = "2026-03-25T20:21:36.012Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/f1/dbeeb9116715abee2485bf0a12d07a8f31af94d71608c171c45f64c0469d/tomli-2.4.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:d312ef37c91508b0ab2cee7da26ec0b3ed2f03ce12bd87a588d771ae15dcf82d", size = 247180, upload-time = "2026-03-25T20:21:37.136Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/74/16336ffd19ed4da28a70959f92f506233bd7cfc2332b20bdb01591e8b1d1/tomli-2.4.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:51529d40e3ca50046d7606fa99ce3956a617f9b36380da3b7f0dd3dd28e68cb5", size = 251674, upload-time = "2026-03-25T20:21:38.298Z" },
+    { url = "https://files.pythonhosted.org/packages/16/f9/229fa3434c590ddf6c0aa9af64d3af4b752540686cace29e6281e3458469/tomli-2.4.1-cp313-cp313-win32.whl", hash = "sha256:2190f2e9dd7508d2a90ded5ed369255980a1bcdd58e52f7fe24b8162bf9fedbd", size = 97976, upload-time = "2026-03-25T20:21:39.316Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/1e/71dfd96bcc1c775420cb8befe7a9d35f2e5b1309798f009dca17b7708c1e/tomli-2.4.1-cp313-cp313-win_amd64.whl", hash = "sha256:8d65a2fbf9d2f8352685bc1364177ee3923d6baf5e7f43ea4959d7d8bc326a36", size = 108755, upload-time = "2026-03-25T20:21:40.248Z" },
+    { url = "https://files.pythonhosted.org/packages/83/7a/d34f422a021d62420b78f5c538e5b102f62bea616d1d75a13f0a88acb04a/tomli-2.4.1-cp313-cp313-win_arm64.whl", hash = "sha256:4b605484e43cdc43f0954ddae319fb75f04cc10dd80d830540060ee7cd0243cd", size = 95265, upload-time = "2026-03-25T20:21:41.219Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/fb/9a5c8d27dbab540869f7c1f8eb0abb3244189ce780ba9cd73f3770662072/tomli-2.4.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:fd0409a3653af6c147209d267a0e4243f0ae46b011aa978b1080359fddc9b6cf", size = 155726, upload-time = "2026-03-25T20:21:42.23Z" },
+    { url = "https://files.pythonhosted.org/packages/62/05/d2f816630cc771ad836af54f5001f47a6f611d2d39535364f148b6a92d6b/tomli-2.4.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:a120733b01c45e9a0c34aeef92bf0cf1d56cfe81ed9d47d562f9ed591a9828ac", size = 149859, upload-time = "2026-03-25T20:21:43.386Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/48/66341bdb858ad9bd0ceab5a86f90eddab127cf8b046418009f2125630ecb/tomli-2.4.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:559db847dc486944896521f68d8190be1c9e719fced785720d2216fe7022b662", size = 244713, upload-time = "2026-03-25T20:21:44.474Z" },
+    { url = "https://files.pythonhosted.org/packages/df/6d/c5fad00d82b3c7a3ab6189bd4b10e60466f22cfe8a08a9394185c8a8111c/tomli-2.4.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:01f520d4f53ef97964a240a035ec2a869fe1a37dde002b57ebc4417a27ccd853", size = 252084, upload-time = "2026-03-25T20:21:45.62Z" },
+    { url = "https://files.pythonhosted.org/packages/00/71/3a69e86f3eafe8c7a59d008d245888051005bd657760e96d5fbfb0b740c2/tomli-2.4.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7f94b27a62cfad8496c8d2513e1a222dd446f095fca8987fceef261225538a15", size = 247973, upload-time = "2026-03-25T20:21:46.937Z" },
+    { url = "https://files.pythonhosted.org/packages/67/50/361e986652847fec4bd5e4a0208752fbe64689c603c7ae5ea7cb16b1c0ca/tomli-2.4.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:ede3e6487c5ef5d28634ba3f31f989030ad6af71edfb0055cbbd14189ff240ba", size = 256223, upload-time = "2026-03-25T20:21:48.467Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/9a/b4173689a9203472e5467217e0154b00e260621caa227b6fa01feab16998/tomli-2.4.1-cp314-cp314-win32.whl", hash = "sha256:3d48a93ee1c9b79c04bb38772ee1b64dcf18ff43085896ea460ca8dec96f35f6", size = 98973, upload-time = "2026-03-25T20:21:49.526Z" },
+    { url = "https://files.pythonhosted.org/packages/14/58/640ac93bf230cd27d002462c9af0d837779f8773bc03dee06b5835208214/tomli-2.4.1-cp314-cp314-win_amd64.whl", hash = "sha256:88dceee75c2c63af144e456745e10101eb67361050196b0b6af5d717254dddf7", size = 109082, upload-time = "2026-03-25T20:21:50.506Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/2f/702d5e05b227401c1068f0d386d79a589bb12bf64c3d2c72ce0631e3bc49/tomli-2.4.1-cp314-cp314-win_arm64.whl", hash = "sha256:b8c198f8c1805dc42708689ed6864951fd2494f924149d3e4bce7710f8eb5232", size = 96490, upload-time = "2026-03-25T20:21:51.474Z" },
+    { url = "https://files.pythonhosted.org/packages/45/4b/b877b05c8ba62927d9865dd980e34a755de541eb65fffba52b4cc495d4d2/tomli-2.4.1-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:d4d8fe59808a54658fcc0160ecfb1b30f9089906c50b23bcb4c69eddc19ec2b4", size = 164263, upload-time = "2026-03-25T20:21:52.543Z" },
+    { url = "https://files.pythonhosted.org/packages/24/79/6ab420d37a270b89f7195dec5448f79400d9e9c1826df982f3f8e97b24fd/tomli-2.4.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:7008df2e7655c495dd12d2a4ad038ff878d4ca4b81fccaf82b714e07eae4402c", size = 160736, upload-time = "2026-03-25T20:21:53.674Z" },
+    { url = "https://files.pythonhosted.org/packages/02/e0/3630057d8eb170310785723ed5adcdfb7d50cb7e6455f85ba8a3deed642b/tomli-2.4.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1d8591993e228b0c930c4bb0db464bdad97b3289fb981255d6c9a41aedc84b2d", size = 270717, upload-time = "2026-03-25T20:21:55.129Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/b4/1613716072e544d1a7891f548d8f9ec6ce2faf42ca65acae01d76ea06bb0/tomli-2.4.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:734e20b57ba95624ecf1841e72b53f6e186355e216e5412de414e3c51e5e3c41", size = 278461, upload-time = "2026-03-25T20:21:56.228Z" },
+    { url = "https://files.pythonhosted.org/packages/05/38/30f541baf6a3f6df77b3df16b01ba319221389e2da59427e221ef417ac0c/tomli-2.4.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:8a650c2dbafa08d42e51ba0b62740dae4ecb9338eefa093aa5c78ceb546fcd5c", size = 274855, upload-time = "2026-03-25T20:21:57.653Z" },
+    { url = "https://files.pythonhosted.org/packages/77/a3/ec9dd4fd2c38e98de34223b995a3b34813e6bdadf86c75314c928350ed14/tomli-2.4.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:504aa796fe0569bb43171066009ead363de03675276d2d121ac1a4572397870f", size = 283144, upload-time = "2026-03-25T20:21:59.089Z" },
+    { url = "https://files.pythonhosted.org/packages/ef/be/605a6261cac79fba2ec0c9827e986e00323a1945700969b8ee0b30d85453/tomli-2.4.1-cp314-cp314t-win32.whl", hash = "sha256:b1d22e6e9387bf4739fbe23bfa80e93f6b0373a7f1b96c6227c32bef95a4d7a8", size = 108683, upload-time = "2026-03-25T20:22:00.214Z" },
+    { url = "https://files.pythonhosted.org/packages/12/64/da524626d3b9cc40c168a13da8335fe1c51be12c0a63685cc6db7308daae/tomli-2.4.1-cp314-cp314t-win_amd64.whl", hash = "sha256:2c1c351919aca02858f740c6d33adea0c5deea37f9ecca1cc1ef9e884a619d26", size = 121196, upload-time = "2026-03-25T20:22:01.169Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/cd/e80b62269fc78fc36c9af5a6b89c835baa8af28ff5ad28c7028d60860320/tomli-2.4.1-cp314-cp314t-win_arm64.whl", hash = "sha256:eab21f45c7f66c13f2a9e0e1535309cee140182a9cdae1e041d02e47291e8396", size = 100393, upload-time = "2026-03-25T20:22:02.137Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/61/cceae43728b7de99d9b847560c262873a1f6c98202171fd5ed62640b494b/tomli-2.4.1-py3-none-any.whl", hash = "sha256:0d85819802132122da43cb86656f8d1f8c6587d54ae7dcaf30e90533028b49fe", size = 14583, upload-time = "2026-03-25T20:22:03.012Z" },
+]
+
+[[package]]
+name = "typer"
+version = "0.26.8"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "annotated-doc" },
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "rich" },
+    { name = "shellingham" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/7c/f7/68adc395201b20b872d68e975386832e8005ffeacedd43a1d837a32815be/typer-0.26.8.tar.gz", hash = "sha256:c244a6bd558886fe3f8780efb6bdd28bb9aff005a94eedebaa5cb32926fe2f7e", size = 202097, upload-time = "2026-06-26T09:22:45.705Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/80/87/b9fd69c92c6102a066e1b86a35243f53e70bd4c709f2a26d9f4fee4f4dc0/typer-0.26.8-py3-none-any.whl", hash = "sha256:3512ca79ac5c11113414b36e80281b872884477722440691c89d1112e321a49c", size = 122564, upload-time = "2026-06-26T09:22:44.72Z" },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.16.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f6/cc/6253133b5bb138fc3306cebfbda2c520f545d36b5be2c7255cc528bb45d6/typing_extensions-4.16.0.tar.gz", hash = "sha256:dc983d19a509c94dba722ee6abd33940f7c05a89e243c47e907eb4db6f1a43e5", size = 113555, upload-time = "2026-07-02T08:40:05.92Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/49/d3/b8441a820a491ddfc024b0b0cf0393375b75ea13866d9c66727e54c2fc80/typing_extensions-4.16.0-py3-none-any.whl", hash = "sha256:481caa481374e813c1b176ada14e97f1f67a4539ce9cfeb3f350d78d6370c2e8", size = 45571, upload-time = "2026-07-02T08:40:04.659Z" },
+]
+
+[[package]]
+name = "wcwidth"
+version = "0.8.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/34/74/c6428f875774288bec1396f5bfcbc2d925700a4dad61727fd5f2b12f249d/wcwidth-0.8.2.tar.gz", hash = "sha256:91fbef97204b96a3d4d421609b80340b760cf33e26da123ff243d76b1fda8dda", size = 1466253, upload-time = "2026-06-29T18:11:11.601Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/96/42/3e5985a0a7e57de470b320c6d6a1a67c844f6737a587f3d44dd13d1819e7/wcwidth-0.8.2-py3-none-any.whl", hash = "sha256:d63947694a0539a1d51e01eda7caf800c291020e6cdd7e28ad7b14dd33ad4f85", size = 323166, upload-time = "2026-06-29T18:11:09.888Z" },
+]