gora-cli 0.1.2__py3-none-any.whl

gora/tui.py

@@ -0,0 +1,115 @@
+from __future__ import annotations
+
+import os
+from pathlib import Path
+import shutil
+import subprocess
+import sys
+
+TUI_CACHE_VERSION = "bubbletea-v1"
+
+
+def run_tui(db_path: Path | None) -> int:
+    command, cwd = _tui_command()
+    if command is None:
+        print(
+            "Bubble Tea TUI is not built and Go is not available.\n"
+            "Build it with: go -C gora/go_tui build -o ../../dist/gora-tui .\n"
+            "Then run: GORA_TUI_BIN=dist/gora-tui gora",
+            file=sys.stderr,
+        )
+        return 1
+
+    if db_path is not None:
+        command.extend(["--db", str(db_path)])
+
+    try:
+        return subprocess.run(command, cwd=cwd).returncode
+    except KeyboardInterrupt:
+        return 130
+    except OSError as exc:
+        print(f"failed to launch Bubble Tea TUI: {exc}", file=sys.stderr)
+        return 1
+
+
+def _tui_command() -> tuple[list[str] | None, Path | None]:
+    configured = os.environ.get("GORA_TUI_BIN")
+    if configured:
+        return [_expand(configured)], None
+
+    discovered = shutil.which("gora-tui")
+    if discovered:
+        return [discovered], None
+
+    repo_root = Path(__file__).resolve().parents[1]
+    for candidate in (
+        repo_root / "dist" / "gora-tui",
+        repo_root / "bin" / "gora-tui",
+    ):
+        if candidate.exists() and os.access(candidate, os.X_OK):
+            return [str(candidate)], None
+
+    source_dir = Path(__file__).resolve().parent / "go_tui"
+    if source_dir.exists() and shutil.which("go"):
+        cached = _cached_tui_path()
+        if not cached.exists() or _source_is_newer(source_dir, cached):
+            if _build_tui(source_dir, cached):
+                return [str(cached)], None
+            return ["go", "run", "."], source_dir
+        return [str(cached)], None
+
+    return None, None
+
+
+def _expand(path: str) -> str:
+    return str(Path(path).expanduser())
+
+
+def _cached_tui_path() -> Path:
+    cache_home = os.environ.get("XDG_CACHE_HOME")
+    if cache_home:
+        root = Path(cache_home).expanduser()
+    elif sys.platform == "darwin":
+        root = Path.home() / "Library" / "Caches"
+    else:
+        root = Path.home() / ".cache"
+    return root / "gora" / TUI_CACHE_VERSION / "gora-tui"
+
+
+def _source_is_newer(source_dir: Path, binary: Path) -> bool:
+    try:
+        binary_mtime = binary.stat().st_mtime
+    except OSError:
+        return True
+    for path in source_dir.rglob("*"):
+        if path.is_file() and path.suffix in {".go", ".mod", ".sum"}:
+            try:
+                if path.stat().st_mtime > binary_mtime:
+                    return True
+            except OSError:
+                return True
+    return False
+
+
+def _build_tui(source_dir: Path, target: Path) -> bool:
+    target.parent.mkdir(parents=True, exist_ok=True)
+    tmp = target.with_suffix(".tmp")
+    try:
+        result = subprocess.run(
+            ["go", "build", "-o", str(tmp), "."],
+            cwd=source_dir,
+            stdout=subprocess.DEVNULL,
+            stderr=subprocess.DEVNULL,
+        )
+        if result.returncode != 0:
+            return False
+        tmp.replace(target)
+        target.chmod(0o755)
+        return True
+    except OSError:
+        return False
+    finally:
+        try:
+            tmp.unlink()
+        except OSError:
+            pass

gora_cli-0.1.2.dist-info/METADATA

@@ -0,0 +1,282 @@
+Metadata-Version: 2.4
+Name: gora-cli
+Version: 0.1.2
+Summary: Local CLI chat history index for Codex, Claude Code, and Pi.
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Classifier: Topic :: Terminals
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="images/gora-header.png" alt="Gora header" width="100%">
+</p>
+
+# gora
+
+Local memory for coding-agent chats.
+
+`gora` indexes chat history from Codex, Claude Code, and Pi into one local
+SQLite archive. Use it when you need to remember what you asked a model, what a
+coding agent changed, which repo a conversation belonged to, or which harness
+and model were used.
+
+## Why
+
+Coding-agent history is spread across different local folders. Some harnesses
+also prune or rewrite old logs. `gora` gives you one place to search them.
+
+Common uses:
+
+- Find an old debugging session by keyword.
+- Check what a coding agent did in a repo last week.
+- Recover a command, error, plan, or explanation from a past chat.
+- See tool calls and command output inline with the chat transcript.
+- Search across Codex, Claude Code, and Pi at the same time.
+- Filter history by harness, repo, role, or model.
+
+## Supported History
+
+`gora` reads local history files from:
+
+```text
+Codex       ~/.codex/sessions/**/*.jsonl
+Claude Code ~/.claude/projects/**/*.jsonl
+Pi          ~/.pi/agent/sessions/**/*.jsonl
+```
+
+No cloud service is required. The index stays on your machine.
+
+## Install
+
+```bash
+uv tool install gora-cli
+gora
+```
+
+The PyPI package is `gora-cli`. The installed command is `gora`.
+
+Install directly from GitHub:
+
+```bash
+uv tool install git+https://github.com/mertdeveci5/gora
+```
+
+For local development:
+
+```bash
+git clone <repo-url>
+cd gora
+uv tool install --editable .
+```
+
+## Quick Start
+
+1. Check what Gora can see:
+
+```bash
+gora doctor
+```
+
+2. Import local history:
+
+```bash
+gora import
+```
+
+3. Open the terminal UI:
+
+```bash
+gora
+```
+
+4. Search from the CLI:
+
+```bash
+gora search "render deploy"
+gora search "ctx7 login" --provider codex
+gora search "database migration" --model "model-from-gora-models"
+```
+
+5. Show a full transcript:
+
+```bash
+gora show codex:<session-id>
+```
+
+## Terminal UI
+
+Run:
+
+```bash
+gora
+```
+
+The interactive UI is a Bubble Tea app built with Bubbles components. Gora
+builds a cached local helper from the bundled Go source on first launch when Go
+is available. For a prebuilt local helper:
+
+```bash
+go -C gora/go_tui build -o ../../dist/gora-tui .
+GORA_TUI_BIN=dist/gora-tui gora
+```
+
+Controls:
+
+```text
+Type             search chats
+Tab              move focus between search, filters, and results
+Ctrl-F           open the filter editor
+Enter            open the selected chat or edit focused filters
+Click Filters    open the filter editor
+Space            select or clear a filter option in the filter editor
+1/H 2/R 3/M 4/O jump between filter editor steps
+Enter            select a filter option and move to the next filter step
+Up/Down          move through results or filter options
+M                export the selected chat as Markdown from results/transcript
+T                export the selected chat as plain text from results/transcript
+Left/Esc         return from transcript or apply filters and go back
+Ctrl-U           clear search or all filters in the filter editor
+Esc              clear search, clear active filters, or quit
+```
+
+The filter editor supports multi-select harnesses, repos, and models. For
+example, select Claude Code and two repos to show only Claude Code sessions from
+those repos.
+
+Exports are written to `~/Downloads/gora-exports` and keep the transcript in a
+portable Markdown or plain-text file.
+
+## CLI Commands
+
+```bash
+gora doctor
+gora import
+gora harnesses
+gora repos
+gora models
+gora recent
+gora list --limit 20
+gora search "query"
+gora show <session>
+```
+
+Filters:
+
+```bash
+gora list --provider codex
+gora list --cwd tlmc
+gora list --model "model-from-gora-models"
+gora list --include-children
+gora search "auth bug" --provider claude --model "model-from-gora-models"
+gora search "review output" --include-children
+gora show <session> --role user --role assistant
+```
+
+Most list-style commands print numbered results and a quick command for the top
+result.
+
+Example:
+
+```bash
+gora models
+```
+
+```text
+1. Model: gpt-5.4
+   Provider: openai
+   Chats: 460
+   Messages: 43079
+
+2. Model: gpt-5.3-codex
+   Provider: openai
+   Chats: 333
+   Messages: 14585
+
+Quick command:
+  gora search "<query>" --model gpt-5.4
+```
+
+Useful one-shot commands:
+
+```bash
+gora harnesses
+gora repos --limit 10
+gora models --limit 10
+gora recent --provider codex --limit 5
+gora search "migration bug" --cwd tlmc
+gora search "auth bug" --model "model-from-gora-models"
+gora show claude:<session-id>
+```
+
+## Import Behavior
+
+`gora import` is archive-oriented.
+
+Once a chat is imported, Gora keeps it searchable even if the original harness
+later deletes, prunes, or rewrites its local log file. Refreshing a changed
+source file merges in new messages but does not delete messages already in the
+archive.
+
+Tool calls and tool-result output are imported by default so transcripts show
+what the agent actually ran. Gora redacts common token shapes before storing
+message text.
+
+Codex can create child rollout files for subagents and review tasks. Gora stores
+those records with their parent thread metadata, but normal list, recent, repos,
+search, and TUI views show root user chats by default. Use `--include-children`
+on CLI list and search style commands when you want to inspect child rollout
+records too.
+
+## Models
+
+Gora does not use a fixed model-name list.
+
+It extracts model metadata from each harness's logged structure:
+
+```text
+Codex        turn context model metadata
+Claude Code  assistant message model metadata
+Pi           model change records and message metadata
+```
+
+List indexed models:
+
+```bash
+gora models
+```
+
+Filter by an indexed model:
+
+```bash
+gora search "cache bug" --model gpt-5.5
+```
+
+## Data Location
+
+Default index path:
+
+```text
+macOS  ~/Library/Application Support/gora/history.sqlite
+Linux  ~/.local/share/gora/history.sqlite
+```
+
+Use another path:
+
+```bash
+GORA_DB=/path/to/history.sqlite gora import
+gora --db /path/to/history.sqlite search "query"
+```
+
+The default data directory is created with owner-only permissions.
+
+## Development
+
+```bash
+uv run python -m unittest
+uv run python -m compileall gora tests main.py
+uv build
+```

gora_cli-0.1.2.dist-info/RECORD

@@ -0,0 +1,14 @@
+gora/__init__.py,sha256=ulCdHq_2DQHHaXDkXTSVf-8D_07_2YRnB18hxBqrWNw,104
+gora/__main__.py,sha256=yXtZIqonLnM8h-9OOsl9Bt4USaF-mVaqDS-BZeQchC4,282
+gora/cli.py,sha256=JbC35xeuoY501NsOcHxJoXDMBu1Q0dsTLegRG2wbAk0,16741
+gora/parsers.py,sha256=ALLNZoIn0jhINjqsVVZkvv_74hRlCR51Eclkz9M2nM4,19505
+gora/store.py,sha256=f-JtJHTSj9oL19sBXdHbKhkW8m1fNeRFf4cHpIEBYgk,30038
+gora/tui.py,sha256=7EUeAE_gKor2R3AuUM9FyTcqgrv5FCqHiGtKGx8TlJ8,3281
+gora/go_tui/go.mod,sha256=LKS2kXUljZdD1ui0mD-ICkm9KFSxlydS3FpfEUhLkJY,1719
+gora/go_tui/go.sum,sha256=7XrrBzWw7QNM0L1Lx_igfdkzo3VC_Av7lX_RgZ3yrkY,9414
+gora/go_tui/main.go,sha256=5JE-xDGdktGBf7_bnT-8fg6lVI1fnoEdu5b457DAs8k,69649
+gora/go_tui/main_test.go,sha256=mg9FnSD8BtqVUZ5fQOBN2VV9nVSLjATf75dbRNky2n4,18898
+gora_cli-0.1.2.dist-info/METADATA,sha256=qIfXirY-apOcJXV8PoQZ_0W-FvR08fidxFazyTRf8xo,6576
+gora_cli-0.1.2.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+gora_cli-0.1.2.dist-info/entry_points.txt,sha256=KM28YlhjZ6de0vYJ5yiP2JcjjoU4BKNM-5jk4ABWhD0,39
+gora_cli-0.1.2.dist-info/RECORD,,

gora_cli-0.1.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

gora_cli-0.1.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+gora = gora.cli:main