Added Global directory accessibility.

README.md

@@ -153,6 +153,42 @@ uv run cheatbox
 
 `cheatbox` is inspired by the common cheatsheet posts in the Linkedin feed and also [BENTOBOX](https://www.google.com/search?q=bento).
 
+## Running the Application Globally
+
+Install once, then run `cheatbox` from any directory.
+
+**Install**
+
+- pipx (recommended):
+  ```bash
+  pipx install cheatbox
+  ```
+- From a cloned repo:
+  ```bash
+  uv tool install .
+  ```
+
+**Set PATH**
+
+- Windows (PowerShell): ensure `C:\Users\<you>\.local\bin` is on PATH. One-time helper:
+  ```powershell
+  uv tool update-shell
+  ```
+  Current session only:
+  ```powershell
+  $env:PATH = "C:\Users\<you>\.local\bin;$env:PATH"
+  ```
+- Linux/macOS (bash/zsh): ensure `~/.local/bin` is on PATH:
+  ```bash
+  export PATH="$HOME/.local/bin:$PATH"
+  ```
+
+**Run**
+
+```bash
+cheatbox
+```
+
 ## License
 
 GPL-3.0

cheatbox/data.py

@@ -5,7 +5,8 @@
 
 class Data:
     def __init__(self):
-        self.base_dir = Path(__file__).parent.parent
+        # Keep data files alongside the package so installs include them
+        self.base_dir = Path(__file__).parent
         self.data_dir = self.base_dir / "data"
         self.domain: str = self.select_domain()
 

cheatbox/display.py

@@ -64,8 +64,8 @@ def display_bento(self, json_data):
 
         logo_panel = self.get_ascii_panel(json_data, "LOGO")
         title_panel = self.get_ascii_panel(json_data, "TITLE")
-
-        title_panel.subtitle = "CheatBox "
+        if title_panel:
+            title_panel.subtitle = "CheatBox "
 
         # Display the Logo and title
         if logo_panel or title_panel:

cheatbox/main.py

@@ -18,4 +18,4 @@ def main(ctx: typer.Context):
         list()
 
 if __name__ == "__main__":
-    app()
+    app()

pyproject.toml

@@ -36,6 +36,9 @@ cheatbox = "cheatbox.main:app"
 [tool.uv]
 package = true
 
+[tool.hatch.build]
+include = ["cheatbox", "images/*", "README.md", "CHEATSHEET.md"]
+
 [build-system]
 requires = ["hatchling"]
 build-backend = "hatchling.build"