pocketshell 0.1.0__tar.gz

pocketshell-0.1.0/.gitignore

@@ -0,0 +1,11 @@
+# Python build / cache artifacts produced by `uv pip install -e .`,
+# `pytest`, and `ruff`. These never want to be checked in.
+.venv/
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+dist/
+build/

pocketshell-0.1.0/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: pocketshell
+Version: 0.1.0
+Summary: Unified server-side Python utility for the PocketShell Android client.
+Project-URL: Homepage, https://github.com/alexeygrigorev/pocketshell
+Project-URL: Issues, https://github.com/alexeygrigorev/pocketshell/issues
+Author: Alexey Grigorev
+License: MIT
+Keywords: agents,pocketshell,ssh,tmux,usage
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.11
+Requires-Dist: click>=8.2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.4.0; extra == 'dev'
+Requires-Dist: ruff>=0.15.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# pocketshell-cli
+
+Unified server-side Python utility for the [PocketShell](https://github.com/alexeygrigorev/pocketshell)
+Android client. Replaces the separately-installed `quse` and `tmuxctl`
+utilities the app currently probes for on every remote host.
+
+This first release ships the **skeleton plus the `pocketshell usage`
+subcommand only**. Follow-up rounds will add `jobs`, `agent-log`,
+`sessions`, `repos`, and an optional daemon mode. See
+[issue #170](https://github.com/alexeygrigorev/pocketshell/issues/170) for
+the design spike and phased roll-out plan.
+
+## Install
+
+The recommended path is `uv tool install`, which lands the binary on PATH
+under `~/.local/bin/`:
+
+```bash
+uv tool install pocketshell-cli
+```
+
+For local development from a clone:
+
+```bash
+cd tools/pocketshell-cli
+uv venv
+uv pip install -e .
+pocketshell --help
+```
+
+`pipx install pocketshell-cli` works the same way for users who prefer
+pipx. Both install paths produce a `pocketshell` binary that the
+PocketShell app's bootstrap probe detects.
+
+## Usage
+
+```text
+pocketshell usage           # human-readable lines, one per provider
+pocketshell usage --json    # machine-readable JSON (consumed by the app)
+pocketshell usage codex     # filter to a single provider
+```
+
+The output shape is byte-identical to `quse [provider] [--json]` so any
+consumer that already parses `quse` output keeps working when the app
+routes through `pocketshell usage` instead. Under the hood the first
+release delegates to the `quse` CLI via subprocess; later rounds will
+fold the provider-detection logic in directly and drop the subprocess
+hop.
+
+If `quse` is not installed, `pocketshell usage` exits with code 127 and
+prints an install hint to stderr.
+
+## Development
+
+```bash
+cd tools/pocketshell-cli
+uv venv
+uv pip install -e ".[dev]"
+uv run pytest
+```
+
+Or via the dependency-group:
+
+```bash
+uv sync --group dev
+uv run pytest
+```
+
+The tests stub `quse.usage.collect_usage` so they run in seconds without
+hitting any provider API.
+
+## Why a unified CLI?
+
+The PocketShell app previously probed for two binaries (`quse`,
+`tmuxctl`) on every host. That meant two installs to keep up to date,
+two probes to surface failures from, and two PATH-discovery edge cases
+(see [issue #41](https://github.com/alexeygrigorev/pocketshell/issues/41)).
+A single `pocketshell` binary collapses those into one install, one
+probe, one bootstrap row. The app keeps detecting `quse` and `tmuxctl`
+as a parallel path while `pocketshell` ramps up to feature parity; once
+parity is reached, the legacy probes are removed in a hard-cut follow-up
+(no compat shim — see decision D22 in `docs/decisions.md`).

pocketshell-0.1.0/README.md

@@ -0,0 +1,82 @@
+# pocketshell-cli
+
+Unified server-side Python utility for the [PocketShell](https://github.com/alexeygrigorev/pocketshell)
+Android client. Replaces the separately-installed `quse` and `tmuxctl`
+utilities the app currently probes for on every remote host.
+
+This first release ships the **skeleton plus the `pocketshell usage`
+subcommand only**. Follow-up rounds will add `jobs`, `agent-log`,
+`sessions`, `repos`, and an optional daemon mode. See
+[issue #170](https://github.com/alexeygrigorev/pocketshell/issues/170) for
+the design spike and phased roll-out plan.
+
+## Install
+
+The recommended path is `uv tool install`, which lands the binary on PATH
+under `~/.local/bin/`:
+
+```bash
+uv tool install pocketshell-cli
+```
+
+For local development from a clone:
+
+```bash
+cd tools/pocketshell-cli
+uv venv
+uv pip install -e .
+pocketshell --help
+```
+
+`pipx install pocketshell-cli` works the same way for users who prefer
+pipx. Both install paths produce a `pocketshell` binary that the
+PocketShell app's bootstrap probe detects.
+
+## Usage
+
+```text
+pocketshell usage           # human-readable lines, one per provider
+pocketshell usage --json    # machine-readable JSON (consumed by the app)
+pocketshell usage codex     # filter to a single provider
+```
+
+The output shape is byte-identical to `quse [provider] [--json]` so any
+consumer that already parses `quse` output keeps working when the app
+routes through `pocketshell usage` instead. Under the hood the first
+release delegates to the `quse` CLI via subprocess; later rounds will
+fold the provider-detection logic in directly and drop the subprocess
+hop.
+
+If `quse` is not installed, `pocketshell usage` exits with code 127 and
+prints an install hint to stderr.
+
+## Development
+
+```bash
+cd tools/pocketshell-cli
+uv venv
+uv pip install -e ".[dev]"
+uv run pytest
+```
+
+Or via the dependency-group:
+
+```bash
+uv sync --group dev
+uv run pytest
+```
+
+The tests stub `quse.usage.collect_usage` so they run in seconds without
+hitting any provider API.
+
+## Why a unified CLI?
+
+The PocketShell app previously probed for two binaries (`quse`,
+`tmuxctl`) on every host. That meant two installs to keep up to date,
+two probes to surface failures from, and two PATH-discovery edge cases
+(see [issue #41](https://github.com/alexeygrigorev/pocketshell/issues/41)).
+A single `pocketshell` binary collapses those into one install, one
+probe, one bootstrap row. The app keeps detecting `quse` and `tmuxctl`
+as a parallel path while `pocketshell` ramps up to feature parity; once
+parity is reached, the legacy probes are removed in a hard-cut follow-up
+(no compat shim — see decision D22 in `docs/decisions.md`).

pocketshell-0.1.0/pyproject.toml

@@ -0,0 +1,74 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pocketshell"
+version = "0.1.0"
+description = "Unified server-side Python utility for the PocketShell Android client."
+readme = "README.md"
+requires-python = ">=3.11"
+authors = [{ name = "Alexey Grigorev" }]
+license = { text = "MIT" }
+keywords = ["pocketshell", "ssh", "tmux", "agents", "usage"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development",
+    "Topic :: System :: Monitoring",
+]
+# First PR delegates `pocketshell usage` to the existing `quse` CLI via
+# subprocess (see `pocketshell/usage.py`) so the new utility does not need
+# `quse` published on PyPI. Later PRs will fold the provider-detection
+# implementation in directly. Pin lower-bound only.
+dependencies = [
+    "click>=8.2.0",
+]
+
+[project.scripts]
+pocketshell = "pocketshell.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/alexeygrigorev/pocketshell"
+Issues = "https://github.com/alexeygrigorev/pocketshell/issues"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.4.0",
+    "ruff>=0.15.0",
+]
+
+[project.optional-dependencies]
+# Mirror of the dev `dependency-groups` so `pip install -e ".[dev]"` and
+# `uv pip install -e ".[dev]"` both work for CI and ad-hoc local setups.
+# `uv sync --group dev` reads `dependency-groups`; PEP-621 tooling reads
+# `optional-dependencies`. Keeping both in lock-step is cheap.
+dev = [
+    "pytest>=8.4.0",
+    "ruff>=0.15.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pocketshell"]
+
+[tool.hatch.build.targets.sdist]
+exclude = [
+    "/.github",
+    "/.pytest_cache",
+    "/.ruff_cache",
+    "/.venv",
+    "/dist",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"

pocketshell-0.1.0/src/pocketshell/__init__.py

@@ -0,0 +1,14 @@
+"""Unified server-side Python utility for the PocketShell Android client.
+
+This package is intended to replace the separately-installed `quse` and
+`tmuxctl` utilities the PocketShell app currently probes for. The first PR
+ships the skeleton plus the `pocketshell usage` subcommand only; later PRs
+will add `jobs`, `agent-log`, `sessions`, `repos`, and daemon mode.
+
+See https://github.com/alexeygrigorev/pocketshell/issues/170.
+"""
+
+from __future__ import annotations
+
+__all__ = ["__version__"]
+__version__ = "0.1.0"

pocketshell-0.1.0/src/pocketshell/__main__.py

@@ -0,0 +1,14 @@
+"""Allow `python -m pocketshell` as an alternative to the installed entry point.
+
+Used in CI and developer environments where the console-script shim from
+`pip install -e .` / `uv tool install pocketshell-cli` is not on PATH.
+"""
+
+from __future__ import annotations
+
+import sys
+
+from pocketshell.cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

pocketshell-0.1.0/src/pocketshell/cli.py

@@ -0,0 +1,67 @@
+"""Top-level Click dispatcher for the unified `pocketshell` CLI.
+
+This is the skeleton landed in the first PR of issue
+[#170](https://github.com/alexeygrigorev/pocketshell/issues/170). Only the
+`usage` subcommand is wired up today; later PRs will add `jobs`,
+`agent-log`, `sessions`, `repos`, and `daemon`.
+
+Per the D22 locked principle (no backwards compatibility, hard cuts only)
+the eventual goal is for the PocketShell Android app to probe for this
+single binary instead of `quse` / `tmuxctl`. The first PR keeps the
+existing probes in place — parallel detection, not legacy detection — so
+the app keeps working while we ramp up `pocketshell`'s feature parity.
+"""
+
+from __future__ import annotations
+
+import sys
+from typing import Optional, Sequence
+
+import click
+
+from pocketshell import __version__
+from pocketshell.usage import usage_command
+
+
+@click.group(
+    context_settings={"help_option_names": ["-h", "--help"]},
+    help=(
+        "Unified server-side helper for the PocketShell Android client.\n\n"
+        "Subcommands replace the separately-installed `quse` and `tmuxctl` "
+        "CLIs. The first PR ships `usage` only; more subcommands will land "
+        "in follow-up rounds."
+    ),
+)
+@click.version_option(__version__, "-V", "--version", prog_name="pocketshell")
+def cli() -> None:
+    """Top-level group. Each subcommand is registered below."""
+
+
+cli.add_command(usage_command, name="usage")
+
+
+def main(argv: Optional[Sequence[str]] = None) -> int:
+    """Entrypoint for both the console-script and `python -m pocketshell`.
+
+    Returns an integer exit code rather than letting Click call
+    `sys.exit` so the function is testable from the unit suite.
+    """
+    try:
+        result = cli.main(args=list(argv) if argv is not None else None,
+                          prog_name="pocketshell",
+                          standalone_mode=False)
+    except click.exceptions.Exit as exc:
+        return int(exc.exit_code)
+    except click.ClickException as exc:
+        exc.show()
+        return int(exc.exit_code)
+    if result is None:
+        return 0
+    try:
+        return int(result)
+    except (TypeError, ValueError):
+        return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

pocketshell-0.1.0/src/pocketshell/usage.py

@@ -0,0 +1,115 @@
+"""`pocketshell usage` subcommand.
+
+First-PR implementation: delegate to the existing `quse` CLI via
+`subprocess.run`. The arguments and stdout are proxied through verbatim
+so the JSON payload (and human-readable lines) are byte-identical to
+`quse [provider] [--json]`. The existing Kotlin `QuseUsageJsonParser`
+keeps working when the Android app eventually switches its probe over.
+
+Why subprocess instead of `import quse`:
+
+- `quse` is currently not published to PyPI; declaring it as a normal
+  `pyproject.toml` dependency would break `uv tool install
+  pocketshell-cli` for any user (including the maintainer's dev box).
+- Subprocess delegation keeps `pocketshell-cli` decoupled from `quse`'s
+  internal module layout, so updates to `quse` don't break the wrapper.
+- The PATH-discovery story for `quse` is already solved on the app side
+  (see issue #41 + the `pathOverride` column on `HostEntity`). Wrapping
+  `quse` here means the app's existing PATH override mechanism keeps
+  working without re-implementation.
+
+Later PRs will fold the provider-detection logic in directly so
+`pocketshell-cli` is the canonical implementation and the subprocess
+hop disappears, but that is explicit non-scope here per the brief on
+issue [#170](https://github.com/alexeygrigorev/pocketshell/issues/170).
+"""
+
+from __future__ import annotations
+
+import shutil
+import subprocess
+import sys
+from typing import Optional, Sequence
+
+import click
+
+
+def _resolve_quse_binary() -> Optional[str]:
+    """Locate the `quse` CLI on PATH, or return ``None`` if absent.
+
+    Pulled out as a function so the unit suite can monkeypatch it.
+    `shutil.which` returns the same path the user would see from
+    `command -v quse`, which is the probe the Android app already runs.
+    """
+    return shutil.which("quse")
+
+
+def _run_quse(args: Sequence[str]) -> int:
+    """Invoke `quse` with [args]; proxy stdout/stderr and exit code.
+
+    Using `subprocess.run(..., check=False)` and forwarding the captured
+    output rather than `os.execvp` keeps the call testable (the test
+    suite can monkeypatch `subprocess.run`) and lets us decorate the
+    failure mode with a friendly hint when `quse` is missing.
+    """
+    quse_path = _resolve_quse_binary()
+    if quse_path is None:
+        # Same wording the bootstrap sheet uses so the user sees a
+        # consistent message whether they hit the bin via `pocketshell
+        # usage` or the app's poll loop.
+        click.echo(
+            "pocketshell: `quse` is not installed on this host. "
+            "Install it via `uv tool install quse` or `pipx install quse` "
+            "and re-run.",
+            err=True,
+        )
+        return 127
+
+    completed = subprocess.run(
+        [quse_path, *args],
+        check=False,
+        capture_output=True,
+        text=True,
+    )
+    # Echo verbatim so the JSON output is byte-identical to `quse --json`.
+    if completed.stdout:
+        sys.stdout.write(completed.stdout)
+    if completed.stderr:
+        sys.stderr.write(completed.stderr)
+    return completed.returncode
+
+
+@click.command(
+    context_settings={"help_option_names": ["-h", "--help"], "ignore_unknown_options": True},
+)
+@click.argument("provider", required=False)
+@click.option(
+    "--json",
+    "json_output",
+    is_flag=True,
+    help="Emit machine-readable JSON output identical to `quse --json`.",
+)
+@click.pass_context
+def usage_command(
+    ctx: click.Context,
+    provider: Optional[str] = None,
+    json_output: bool = False,
+) -> None:
+    """Report quota / usage for coding-agent providers on this host.
+
+    Delegates to the `quse` CLI via subprocess. Output shape (both human
+    and JSON) is byte-identical to `quse [provider] [--json]` so any
+    consumer that already parses `quse` output keeps working when the
+    PocketShell app routes through `pocketshell usage` instead.
+    """
+    args: list[str] = []
+    if provider:
+        args.append(provider)
+    if json_output:
+        args.append("--json")
+    exit_code = _run_quse(args)
+    # Click ignores the return value of a callback by default; we need to
+    # explicitly propagate non-zero exit codes through `ctx.exit` so the
+    # outer `main()` (and the OS) sees the same exit code `quse` reported.
+    if exit_code != 0:
+        ctx.exit(exit_code)

pocketshell-0.1.0/tests/test_usage.py

@@ -0,0 +1,168 @@
+"""Unit tests for `pocketshell usage`.
+
+The first PR exercises:
+ - `pocketshell --help` lists the `usage` subcommand.
+ - `pocketshell usage --help` shows the click usage line.
+ - `pocketshell usage --json` forwards through to `quse --json`.
+ - `pocketshell usage <provider>` forwards the positional arg.
+ - Missing `quse` produces a friendly stderr message + exit 127.
+ - stdout/stderr/exit-code from the subprocess are proxied verbatim.
+
+The tests stub `pocketshell.usage._resolve_quse_binary` and
+`subprocess.run` so they never invoke a real `quse` binary; the contract
+under test is "pocketshell delegates correctly to whatever quse exists
+on the host", not "the provider check works".
+"""
+
+from __future__ import annotations
+
+import json
+import subprocess
+from typing import Sequence
+from unittest.mock import patch
+
+from click.testing import CliRunner
+
+from pocketshell.cli import cli, main
+from pocketshell.usage import usage_command
+
+
+def _fake_completed(
+    stdout: str = "",
+    stderr: str = "",
+    returncode: int = 0,
+) -> subprocess.CompletedProcess:
+    return subprocess.CompletedProcess(
+        args=[],
+        returncode=returncode,
+        stdout=stdout,
+        stderr=stderr,
+    )
+
+
+def _fake_json_payload() -> str:
+    return json.dumps(
+        {
+            "claude": {
+                "plan": "Pro",
+                "session_used_percent": 12.5,
+                "session_window_resets_at": "2026-05-27T15:00:00Z",
+            },
+            "codex": {
+                "plan": "Plus",
+                "session_used_percent": 4.0,
+                "session_window_resets_at": "2026-05-27T16:00:00Z",
+            },
+        },
+        indent=2,
+        sort_keys=True,
+    )
+
+
+def test_top_level_help_lists_usage_subcommand() -> None:
+    runner = CliRunner()
+    result = runner.invoke(cli, ["--help"])
+    assert result.exit_code == 0, result.output
+    assert "usage" in result.output
+
+
+def test_usage_help_does_not_call_quse() -> None:
+    runner = CliRunner()
+    with patch("pocketshell.usage.subprocess.run") as run, patch(
+        "pocketshell.usage._resolve_quse_binary", return_value="/fake/quse"
+    ):
+        result = runner.invoke(usage_command, ["--help"])
+    assert result.exit_code == 0, result.output
+    assert "provider" in result.output.lower()
+    run.assert_not_called()
+
+
+def test_usage_json_forwards_to_quse_and_proxies_stdout() -> None:
+    payload = _fake_json_payload()
+    runner = CliRunner()
+    with patch("pocketshell.usage._resolve_quse_binary", return_value="/fake/quse"), patch(
+        "pocketshell.usage.subprocess.run",
+        return_value=_fake_completed(stdout=payload),
+    ) as run:
+        result = runner.invoke(usage_command, ["--json"])
+    assert result.exit_code == 0, result.output
+    # The stdout we got back must be the exact bytes `quse --json` emitted.
+    assert result.output == payload
+    # Args forwarded to the quse subprocess must include `--json`.
+    call_args = run.call_args
+    invoked: Sequence[str] = call_args.args[0]
+    assert invoked == ["/fake/quse", "--json"]
+
+
+def test_usage_forwards_provider_argument() -> None:
+    runner = CliRunner()
+    with patch("pocketshell.usage._resolve_quse_binary", return_value="/fake/quse"), patch(
+        "pocketshell.usage.subprocess.run",
+        return_value=_fake_completed(stdout="claude — 12.5% used\n"),
+    ) as run:
+        result = runner.invoke(usage_command, ["claude"])
+    assert result.exit_code == 0, result.output
+    invoked: Sequence[str] = run.call_args.args[0]
+    assert invoked == ["/fake/quse", "claude"]
+    assert "claude" in result.output
+
+
+def test_usage_forwards_provider_and_json_flag_together() -> None:
+    runner = CliRunner()
+    with patch("pocketshell.usage._resolve_quse_binary", return_value="/fake/quse"), patch(
+        "pocketshell.usage.subprocess.run",
+        return_value=_fake_completed(stdout="{\n  \"claude\": {}\n}\n"),
+    ) as run:
+        result = runner.invoke(usage_command, ["claude", "--json"])
+    assert result.exit_code == 0, result.output
+    invoked: Sequence[str] = run.call_args.args[0]
+    assert invoked == ["/fake/quse", "claude", "--json"]
+
+
+def test_usage_returns_127_when_quse_missing() -> None:
+    runner = CliRunner()
+    with patch("pocketshell.usage._resolve_quse_binary", return_value=None), patch(
+        "pocketshell.usage.subprocess.run"
+    ) as run:
+        result = runner.invoke(usage_command, ["--json"], catch_exceptions=False)
+    # 127 is the POSIX exit code for "command not found" and matches the
+    # signal `UsageRemoteSource.fetchUsage` already special-cases on the
+    # Kotlin side.
+    assert result.exit_code == 127, result.output
+    # The friendly message lands on stderr; CliRunner mixes stdout+stderr
+    # by default but `mix_stderr=False` is removed in click>=8.2, so just
+    # check that the install hint was emitted somewhere.
+    assert "quse" in result.output.lower()
+    run.assert_not_called()
+
+
+def test_usage_proxies_nonzero_exit_from_quse() -> None:
+    runner = CliRunner()
+    with patch("pocketshell.usage._resolve_quse_binary", return_value="/fake/quse"), patch(
+        "pocketshell.usage.subprocess.run",
+        return_value=_fake_completed(stderr="error: unknown provider\n", returncode=2),
+    ):
+        result = runner.invoke(usage_command, ["wat"])
+    assert result.exit_code == 2
+    # stderr from the subprocess must reach the user (otherwise debugging
+    # a failing provider would be opaque).
+    assert "unknown provider" in result.output
+
+
+def test_main_returns_int_on_success() -> None:
+    """`main` is the canonical entrypoint for the console-script and
+    `python -m pocketshell`. It must translate Click's exit-code object
+    into a plain int and never raise SystemExit through to the caller.
+    """
+    with patch("pocketshell.usage._resolve_quse_binary", return_value="/fake/quse"), patch(
+        "pocketshell.usage.subprocess.run",
+        return_value=_fake_completed(stdout=_fake_json_payload()),
+    ):
+        exit_code = main(["usage", "--json"])
+    assert isinstance(exit_code, int)
+    assert exit_code == 0
+
+
+def test_main_returns_nonzero_on_unknown_subcommand() -> None:
+    exit_code = main(["bogus-subcommand-that-does-not-exist"])
+    assert exit_code != 0

pocketshell-0.1.0/uv.lock

@@ -0,0 +1,139 @@
+version = 1
+revision = 3
+requires-python = ">=3.11"
+
+[options]
+exclude-newer = "2026-05-20T13:56:21.125647543Z"
+exclude-newer-span = "P7D"
+
+[[package]]
+name = "click"
+version = "8.4.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/23/e4/796662cd90cf80e3a363c99db2b88e0e394b988a575f60a17e16440cd011/click-8.4.0.tar.gz", hash = "sha256:638f1338fe1235c8f4e008e4a8a254fb5c5fbdcbb40ece3c9142ebb78e792973", size = 350843, upload-time = "2026-05-17T00:47:58.425Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ee/ae/8e92f8058baf87f6c7d86ee7e457668690195cc77efedb8d3797a06e3940/click-8.4.0-py3-none-any.whl", hash = "sha256:40c50b7c6c6adac2823d411041ec84f3f103f1b280d5e9ce0d7f998995832f81", size = 116147, upload-time = "2026-05-17T00:47:56.842Z" },
+]
+
+[[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 = "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 = "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 = "pocketshell-cli"
+version = "0.1.0"
+source = { editable = "." }
+dependencies = [
+    { name = "click" },
+]
+
+[package.optional-dependencies]
+dev = [
+    { name = "pytest" },
+    { name = "ruff" },
+]
+
+[package.dev-dependencies]
+dev = [
+    { name = "pytest" },
+    { name = "ruff" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "click", specifier = ">=8.2.0" },
+    { name = "pytest", marker = "extra == 'dev'", specifier = ">=8.4.0" },
+    { name = "ruff", marker = "extra == 'dev'", specifier = ">=0.15.0" },
+]
+provides-extras = ["dev"]
+
+[package.metadata.requires-dev]
+dev = [
+    { name = "pytest", specifier = ">=8.4.0" },
+    { name = "ruff", specifier = ">=0.15.0" },
+]
+
+[[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.0.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/7d/0d/549bd94f1a0a402dc8cf64563a117c0f3765662e2e668477624baeec44d5/pytest-9.0.3.tar.gz", hash = "sha256:b86ada508af81d19edeb213c681b1d48246c1a91d304c6c81a427674c17eb91c", size = 1572165, upload-time = "2026-04-07T17:16:18.027Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d4/24/a372aaf5c9b7208e7112038812994107bc65a84cd00e0354a88c2c77a617/pytest-9.0.3-py3-none-any.whl", hash = "sha256:2c5efc453d45394fdd706ade797c0a81091eccd1d6e4bccfcd476e2b8e0ab5d9", size = 375249, upload-time = "2026-04-07T17:16:16.13Z" },
+]
+
+[[package]]
+name = "ruff"
+version = "0.15.13"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/24/21/a7d5c126d5b557715ef81098f3db2fe20f622a039ff2e626af28d674ab80/ruff-0.15.13.tar.gz", hash = "sha256:f9d89f17f7ba7fb2ed42921f0df75da797a9a5d71bc39049e2c687cf2baf44b7", size = 4678180, upload-time = "2026-05-14T13:44:37.869Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c6/61/11d458dc6ac22504fd8e237b29dfd40504c7fbbcc8930402cfe51a8e63ed/ruff-0.15.13-py3-none-linux_armv6l.whl", hash = "sha256:444b580fc72fd6887e650acd3e575e18cdc79dbcf42fb4030b491057921f61f8", size = 10738279, upload-time = "2026-05-14T13:44:18.7Z" },
+    { url = "https://files.pythonhosted.org/packages/86/ca/caa871ee7be718c45256fada4e16a218ee3e33f0c4a46b729a60a24912e6/ruff-0.15.13-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:6590d009e7cb7ebf36f83dbdd44a3fa48a0994ff6f1cdc1b08006abe58f98dc7", size = 11124798, upload-time = "2026-05-14T13:44:06.427Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/19/43f5f2e568dddde567fc41f8471f9432c09563e19d3e617a48cfa52f8f0a/ruff-0.15.13-py3-none-macosx_11_0_arm64.whl", hash = "sha256:1c26d2f66163deeb6e08d8b39fbbe983ce3c71cea06a6d7591cfd1421793c629", size = 10460761, upload-time = "2026-05-14T13:44:04.375Z" },
+    { url = "https://files.pythonhosted.org/packages/99/df/cf938cd6de3003178f03ad7c1ea2a6c099468c03a35037985070b37e76be/ruff-0.15.13-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9dbd6f94b434f896308e4d57fb7bfde0d02b99f7a64b3bdab0fdfa6a864203a5", size = 10804451, upload-time = "2026-05-14T13:44:25.221Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/7d/5d0973129b154ded2225729169d7068f26b467760b146493fde138415f23/ruff-0.15.13-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:bf3259f3be4d181bda591da5db2571aed6853c6a048157756448020bc6c5cd22", size = 10534285, upload-time = "2026-05-14T13:44:08.888Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/e3/6b999bbc66cd51e5f073842bc2a3995e99c5e0e72e16b15e7261f7abf57a/ruff-0.15.13-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:ae9c17e5eb4430c154e76abc25d79a318190f5a997f38fb6b114416c5319ffc9", size = 11312063, upload-time = "2026-05-14T13:44:11.274Z" },
+    { url = "https://files.pythonhosted.org/packages/af/5a/642639e9f5db04f1e97fbd6e091c6fd20725bdf072fb114d00eefb9e6eb8/ruff-0.15.13-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:2e2e39bff6c341f4b577a21b801326fab0b11847f48fcaa83f00a113c9b3cb55", size = 12183079, upload-time = "2026-05-14T13:44:01.634Z" },
+    { url = "https://files.pythonhosted.org/packages/19/4c/7585735f6b53b0f12de13618b2f7d250a844f018822efc899df2e7b8295f/ruff-0.15.13-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e8d9a8e08013542e94d3220bc5b62cc3e5ef87c5f74bff367d3fac14fab013e6", size = 11440833, upload-time = "2026-05-14T13:43:59.043Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/31/bf1a0803d077e679cfeee5f2f67290a0fa79c7385b5d9a8c17b9db2c48f0/ruff-0.15.13-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:cc411dfebe5eebe55ce041c6ae080eb7668955e866daa2fbb16692a784f1c4ca", size = 11434486, upload-time = "2026-05-14T13:44:27.761Z" },
+    { url = "https://files.pythonhosted.org/packages/e1/4e/62c9b999875d4f14db80f277c030578f5e249c9852d65b7ac7ad0b43c041/ruff-0.15.13-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:768494eb08b9cee54e2fd27969966f74db5a57f6eaa7a90fcb3306af34dfc4bd", size = 11385189, upload-time = "2026-05-14T13:44:13.704Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/89/7e959047a104df3eb12863447c110140191fc5b6c4f379ea2e803fcdb0e4/ruff-0.15.13-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:fb75f9a3a7e42ffe117d734494e6c5e5cb3565d66e12612cb63d0e572a41a5b6", size = 10781380, upload-time = "2026-05-14T13:43:56.734Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/52/5fd18f3b88cab63e88aa11516b3b4e1e5f720e5c330f8dbe5c26210f41f8/ruff-0.15.13-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:8cb74dd33bb2f6613faf7fc03b660053b5ac4f80e706d5788c6335e2a8048d51", size = 10540605, upload-time = "2026-05-14T13:44:20.748Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/e0/9e35f338990d3e41a82875ff7053ffe97541dae81c9d02143177f381d572/ruff-0.15.13-py3-none-musllinux_1_2_i686.whl", hash = "sha256:7ef823f817fcd191dc934e984be9cf4094f808effa16f2542ad8e821ba02bbf2", size = 11036554, upload-time = "2026-05-14T13:44:16.256Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/13/070fb048c24080fba188f66371e2a92785be257ad02242066dc7255ac6e9/ruff-0.15.13-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:f345a13937bd7f09f6f5d19fa0721b0c103e00e7f62bc67089a8e5e037719e0b", size = 11528133, upload-time = "2026-05-14T13:44:22.808Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/8c/b1e1666aef7fc6555094d73ae6cd981701781ae85b97ceefc0eebd0b4668/ruff-0.15.13-py3-none-win32.whl", hash = "sha256:4044f94208b3b05ba0fc4a4abd0558cf4d6459bd18325eead7fd8cc66f909b41", size = 10721455, upload-time = "2026-05-14T13:44:35.697Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/a6/870a3e8a50590bb92be184ad928c2922f088b00d9dc5c5ec7b924ee08c22/ruff-0.15.13-py3-none-win_amd64.whl", hash = "sha256:7064884d442b7d477b4e7473d12da7f08851d2b1982763c5d3f388a19468a1a4", size = 11900409, upload-time = "2026-05-14T13:44:30.389Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/36/9c015cd052fca743dae8cb2aeb16b551444787467db42ceab0fc968865af/ruff-0.15.13-py3-none-win_arm64.whl", hash = "sha256:2471da9bd1068c8c064b5fd9c0c4b6dddffd6369cb1cd68b29993b1709ff1b21", size = 11179336, upload-time = "2026-05-14T13:44:33.026Z" },
+]