scrollback 0.1.1__tar.gz → 0.1.2__tar.gz

{scrollback-0.1.1 → scrollback-0.1.2}/CHANGELOG.md

@@ -6,6 +6,16 @@ follow [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.1.2] - 2026-06-30
+
+### Added
+
+- `scrollback uninstall`: removes the artifacts scrollback created (Desktop
+  launcher, macOS `.app`, optional search index, launcher log) with a
+  confirmation prompt (`--yes` / `--dry-run`). It never touches agent data
+  and never self-removes the package; it prints the right `pip`/`pipx
+  uninstall` command instead.
+
 ## [0.1.1] - 2026-06-30
 
 ### Fixed
@@ -90,6 +100,7 @@ export it from a CLI and a local web app.
 - Negative pagination arguments are rejected; clearer errors for unknown
   sources, failed exports, and unavailable data sources.
 
-[Unreleased]: https://github.com/a-attia/scrollback/compare/v0.1.1...HEAD
+[Unreleased]: https://github.com/a-attia/scrollback/compare/v0.1.2...HEAD
+[0.1.2]: https://github.com/a-attia/scrollback/compare/v0.1.1...v0.1.2
 [0.1.1]: https://github.com/a-attia/scrollback/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/a-attia/scrollback/releases/tag/v0.1.0

{scrollback-0.1.1 → scrollback-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scrollback
-Version: 0.1.1
+Version: 0.1.2
 Summary: Navigate, search, copy, and export your AI coding-agent sessions (opencode, Claude Code, ...) from one local, read-only tool.
 Project-URL: Homepage, https://github.com/a-attia/scrollback
 Project-URL: Repository, https://github.com/a-attia/scrollback
@@ -73,13 +73,13 @@ modifies, locks for writing, or uploads your data.
 You can use it two ways. From the **command line**, list, search, and export
 your sessions in a single scriptable tool:
 
-![scrollback listing recent sessions in the terminal.](https://raw.githubusercontent.com/a-attia/scrollback/v0.1.1/assets/screenshots/cli.png)
+![scrollback listing recent sessions in the terminal.](https://raw.githubusercontent.com/a-attia/scrollback/v0.1.2/assets/screenshots/cli.png)
 
 Or open the **local web app** to read a transcript in full — with rendered
 Markdown, syntax-highlighted code, and typeset LaTeX math:
 
 ![The scrollback web app showing a session list beside a transcript with
-rendered Markdown, highlighted code, and typeset equations.](https://raw.githubusercontent.com/a-attia/scrollback/v0.1.1/assets/screenshots/web.png)
+rendered Markdown, highlighted code, and typeset equations.](https://raw.githubusercontent.com/a-attia/scrollback/v0.1.2/assets/screenshots/web.png)
 
 Both views read the same on-disk session stores, so you can jump between
 them freely. (The screenshots above use synthetic demo data.)
@@ -299,6 +299,13 @@ window closes. All of this behaviour is decided in Python, so the launcher
 scripts stay free of OS-specific assumptions and ship inside the package
 for `pip install` users.
 
+To clean up, `scrollback uninstall` removes the artifacts scrollback
+created — the launchers, the macOS `.app`, the optional search index, and the
+launcher log — after a confirmation (`--yes` to skip it, `--dry-run` to
+preview). It never touches your agent data, and it does not remove the Python
+package itself: it prints the right `pip`/`pipx uninstall` command to finish
+the job (a program can't reliably uninstall the package it is running from).
+
 ## Fast search (optional index)
 
 By default, search is a lexical scan over your live data: zero setup,

{scrollback-0.1.1 → scrollback-0.1.2}/README.md

@@ -14,13 +14,13 @@ modifies, locks for writing, or uploads your data.
 You can use it two ways. From the **command line**, list, search, and export
 your sessions in a single scriptable tool:
 
-![scrollback listing recent sessions in the terminal.](https://raw.githubusercontent.com/a-attia/scrollback/v0.1.1/assets/screenshots/cli.png)
+![scrollback listing recent sessions in the terminal.](https://raw.githubusercontent.com/a-attia/scrollback/v0.1.2/assets/screenshots/cli.png)
 
 Or open the **local web app** to read a transcript in full — with rendered
 Markdown, syntax-highlighted code, and typeset LaTeX math:
 
 ![The scrollback web app showing a session list beside a transcript with
-rendered Markdown, highlighted code, and typeset equations.](https://raw.githubusercontent.com/a-attia/scrollback/v0.1.1/assets/screenshots/web.png)
+rendered Markdown, highlighted code, and typeset equations.](https://raw.githubusercontent.com/a-attia/scrollback/v0.1.2/assets/screenshots/web.png)
 
 Both views read the same on-disk session stores, so you can jump between
 them freely. (The screenshots above use synthetic demo data.)
@@ -240,6 +240,13 @@ window closes. All of this behaviour is decided in Python, so the launcher
 scripts stay free of OS-specific assumptions and ship inside the package
 for `pip install` users.
 
+To clean up, `scrollback uninstall` removes the artifacts scrollback
+created — the launchers, the macOS `.app`, the optional search index, and the
+launcher log — after a confirmation (`--yes` to skip it, `--dry-run` to
+preview). It never touches your agent data, and it does not remove the Python
+package itself: it prints the right `pip`/`pipx uninstall` command to finish
+the job (a program can't reliably uninstall the package it is running from).
+
 ## Fast search (optional index)
 
 By default, search is a lexical scan over your live data: zero setup,

{scrollback-0.1.1 → scrollback-0.1.2}/src/scrollback/__init__.py

@@ -5,4 +5,4 @@ coding agents (opencode, Claude Code, ...) through a common adapter
 interface and lets you list, view, search, and export those sessions.
 """
 
-__version__ = "0.1.1"
+__version__ = "0.1.2"

{scrollback-0.1.1 → scrollback-0.1.2}/src/scrollback/cli.py

@@ -844,6 +844,72 @@ def cmd_install_launcher(args: argparse.Namespace) -> int:
     return 0
 
 
+def _detect_install_tool() -> str:
+    """Best-effort guess of how scrollback was installed, for the hint.
+
+    Returns the command the user should run to remove the package itself.
+    We never run it: a process cannot reliably uninstall the package it is
+    executing from, and the right tool (pip / pipx / conda) depends on how
+    it was installed.
+    """
+    exe = (sys.executable or "").replace("\\", "/")
+    if "/pipx/" in exe or "/.local/pipx/" in exe:
+        return "pipx uninstall scrollback"
+    return "pip uninstall scrollback"
+
+
+def cmd_uninstall(args: argparse.Namespace) -> int:
+    """Remove scrollback-created artifacts; explain how to remove the package.
+
+    Removes only files scrollback itself created (launchers, the macOS .app,
+    the optional search index, the launcher log). It never touches your agent
+    data, and it never tries to uninstall the Python package -- that is left
+    to pip/pipx, with the exact command printed at the end.
+    """
+    from . import fts, launcher_install
+
+    targets: list = list(launcher_install.installed_artifacts())
+    index_path = fts.default_index_path()
+    if index_path.exists():
+        targets.append(index_path)
+
+    if not targets:
+        _eprint("no scrollback-created artifacts found.")
+        _eprint(f"to remove the package itself, run:\n    {_detect_install_tool()}")
+        return 0
+
+    label = "would remove" if args.dry_run else "about to remove"
+    _eprint(f"{label}:")
+    for p in targets:
+        _eprint(f"  {p}")
+
+    if args.dry_run:
+        return 0
+
+    if not args.yes:
+        try:
+            reply = input("remove these? [y/N] ").strip().lower()
+        except (EOFError, KeyboardInterrupt):
+            reply = ""
+        if reply not in ("y", "yes"):
+            _eprint("aborted; nothing removed.")
+            return 1
+
+    removed, failed = 0, 0
+    for p in targets:
+        try:
+            launcher_install.remove_path(p)
+            _eprint(f"removed {p}")
+            removed += 1
+        except OSError as exc:
+            _eprint(f"could not remove {p}: {exc}")
+            failed += 1
+
+    _eprint(f"\nremoved {removed} item(s)" + (f", {failed} failed" if failed else ""))
+    _eprint(f"to remove the package itself, run:\n    {_detect_install_tool()}")
+    return 1 if failed else 0
+
+
 class _AppBridge:
     """JS<->Python API exposed to the pywebview window.
 
@@ -1093,6 +1159,20 @@ def build_parser() -> argparse.ArgumentParser:
                          "falls back to the Desktop launcher elsewhere)")
     sp.set_defaults(func=cmd_install_launcher)
 
+    # uninstall
+    sp = sub.add_parser(
+        "uninstall",
+        help="remove scrollback-created artifacts (launchers, app, index)",
+        description="Remove files scrollback created (Desktop launcher, macOS "
+                    ".app, search index, launcher log). Your agent data is never "
+                    "touched. The Python package itself is removed with pip/pipx "
+                    "-- the exact command is printed at the end.",
+    )
+    sp.add_argument("-y", "--yes", action="store_true", help="skip the confirmation prompt")
+    sp.add_argument("--dry-run", action="store_true",
+                    help="show what would be removed, then exit")
+    sp.set_defaults(func=cmd_uninstall)
+
     return p
 
 

{scrollback-0.1.1 → scrollback-0.1.2}/src/scrollback/launcher_install.py

@@ -207,3 +207,43 @@ def _install_linux(dest: Path | None) -> list[Path]:
     _write(sh, _read_bundled("scrollback.sh"), executable=True)
     created.append(sh)
     return created
+
+
+# -- uninstall: locate + remove the artifacts install creates --------------
+
+def installed_artifacts() -> list[Path]:
+    """Return the launcher/app/log paths scrollback may have created.
+
+    Covers the default install locations on every platform (a custom
+    ``--dest`` is not tracked, so those must be removed by hand). Only paths
+    that currently exist are returned. Never includes the user's agent data.
+    """
+    home = Path.home()
+    candidates: list[Path] = []
+
+    if sys.platform == "darwin":
+        candidates += [
+            _desktop_dir() / "scrollback.command",
+            home / "Applications" / "scrollback.app",
+            home / "Library" / "Logs" / "scrollback-launcher.log",
+        ]
+    elif sys.platform == "win32":
+        candidates += [_desktop_dir() / "scrollback.bat"]
+    else:
+        apps = Path(os.environ.get("XDG_DATA_HOME", home / ".local" / "share")) / "applications"
+        candidates += [
+            apps / "scrollback.desktop",
+            _desktop_dir() / "scrollback.sh",
+        ]
+
+    return [p for p in candidates if p.exists()]
+
+
+def remove_path(path: Path) -> None:
+    """Delete a file or directory (used to remove a .app bundle)."""
+    import shutil
+
+    if path.is_dir() and not path.is_symlink():
+        shutil.rmtree(path)
+    else:
+        path.unlink()

{scrollback-0.1.1 → scrollback-0.1.2}/tests/test_launcher_install.py

@@ -99,3 +99,29 @@ def test_command_script_bakes_absolute_interpreter_path():
     script = launcher_install._command_script()
     assert sys.executable in script
     assert "scrollback.cli web" in script
+
+
+def test_installed_artifacts_finds_what_install_created(tmp_path, monkeypatch):
+    # Point HOME at a temp dir, install to the (temp) Desktop, then confirm
+    # installed_artifacts() reports the created launcher and that remove_path
+    # actually deletes it. Never touches the real home.
+    monkeypatch.setattr(launcher_install.Path, "home", classmethod(lambda cls: tmp_path))
+    desktop = tmp_path / "Desktop"
+    desktop.mkdir()
+
+    created = launcher_install.install(desktop, desktop=True)
+    assert created and all(p.exists() for p in created)
+
+    found = launcher_install.installed_artifacts()
+    # The platform's Desktop launcher should be discovered.
+    assert any(p in found for p in created), (found, created)
+
+    for p in found:
+        launcher_install.remove_path(p)
+        assert not p.exists()
+
+
+def test_installed_artifacts_empty_when_nothing_installed(tmp_path, monkeypatch):
+    monkeypatch.setattr(launcher_install.Path, "home", classmethod(lambda cls: tmp_path))
+    (tmp_path / "Desktop").mkdir()
+    assert launcher_install.installed_artifacts() == []