opencode-manager 0.3.1 → 0.4.1

package/bun.lock

@@ -7,9 +7,12 @@
       "dependencies": {
         "@opentui/core": "^0.1.44",
         "@opentui/react": "^0.1.44",
+        "commander": "^12.0.0",
+        "fast-fuzzy": "^1.12.0",
         "react": "^19.0.0",
       },
       "devDependencies": {
+        "@types/bun": "^1.3.6",
         "@types/node": "^22.8.5",
         "@types/react": "^19.0.0",
         "typescript": "^5.6.3",
@@ -93,6 +96,8 @@
 
     "@tokenizer/token": ["@tokenizer/token@0.3.0", "", {}, "sha512-OvjF+z51L3ov0OyAU0duzsYuvO01PH7x4t6DJx+guahgTnBHkhJdG7soQeTSFLWN3efnHyibZ4Z8l2EuWwJN3A=="],
 
+    "@types/bun": ["@types/bun@1.3.6", "", { "dependencies": { "bun-types": "1.3.6" } }, "sha512-uWCv6FO/8LcpREhenN1d1b6fcspAB+cefwD7uti8C8VffIv0Um08TKMn98FynpTiU38+y2dUO55T11NgDt8VAA=="],
+
     "@types/node": ["@types/node@22.19.0", "", { "dependencies": { "undici-types": "~6.21.0" } }, "sha512-xpr/lmLPQEj+TUnHmR+Ab91/glhJvsqcjB+yY0Ix9GO70H6Lb4FHH5GeqdOE5btAx7eIMwuHkp4H2MSkLcqWbA=="],
 
     "@types/react": ["@types/react@19.2.2", "", { "dependencies": { "csstype": "^3.0.2" } }, "sha512-6mDvHUFSjyT2B2yeNx2nUgMxh9LtOWvkhIU3uePn2I2oyNymUAX1NIsdgviM4CH+JSrp2D2hsMvJOkxY+0wNRA=="],
@@ -113,6 +118,8 @@
 
     "bun-ffi-structs": ["bun-ffi-structs@0.1.2", "", { "peerDependencies": { "typescript": "^5" } }, "sha512-Lh1oQAYHDcnesJauieA4UNkWGXY9hYck7OA5IaRwE3Bp6K2F2pJSNYqq+hIy7P3uOvo3km3oxS8304g5gDMl/w=="],
 
+    "bun-types": ["bun-types@1.3.6", "", { "dependencies": { "@types/node": "*" } }, "sha512-OlFwHcnNV99r//9v5IIOgQ9Uk37gZqrNMCcqEaExdkVq3Avwqok1bJFmvGMCkCE0FqzdY8VMOZpfpR3lwI+CsQ=="],
+
     "bun-webgpu": ["bun-webgpu@0.1.4", "", { "dependencies": { "@webgpu/types": "^0.1.60" }, "optionalDependencies": { "bun-webgpu-darwin-arm64": "^0.1.4", "bun-webgpu-darwin-x64": "^0.1.4", "bun-webgpu-linux-x64": "^0.1.4", "bun-webgpu-win32-x64": "^0.1.4" } }, "sha512-Kw+HoXl1PMWJTh9wvh63SSRofTA8vYBFCw0XEP1V1fFdQEDhI8Sgf73sdndE/oDpN/7CMx0Yv/q8FCvO39ROMQ=="],
 
     "bun-webgpu-darwin-arm64": ["bun-webgpu-darwin-arm64@0.1.4", "", { "os": "darwin", "cpu": "arm64" }, "sha512-eDgLN9teKTfmvrCqgwwmWNsNszxYs7IZdCqk0S1DCarvMhr4wcajoSBlA/nQA0/owwLduPTS8xxCnQp4/N/gDg=="],
@@ -123,6 +130,8 @@
 
     "bun-webgpu-win32-x64": ["bun-webgpu-win32-x64@0.1.4", "", { "os": "win32", "cpu": "x64" }, "sha512-Z5yAK28xrcm8Wb5k7TZ8FJKpOI/r+aVCRdlHYAqI2SDJFN3nD4mJs900X6kNVmG/xFzb5yOuKVYWGg+6ZXWbyA=="],
 
+    "commander": ["commander@12.1.0", "", {}, "sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA=="],
+
     "csstype": ["csstype@3.1.3", "", {}, "sha512-M1uQkMl8rQK/szD0LNhtqxIPLpimGm8sOBwU7lLnCpSbTyY3yeU1Vc7l4KT5zT4s/yOxHH5O7tIuuLOCnLADRw=="],
 
     "event-target-shim": ["event-target-shim@5.0.1", "", {}, "sha512-i/2XbnSz/uxRCU6+NdVJgKWDTM427+MqYbkQzD321DuCQJUqOuJKIA0IM2+W2xtYHdKOmZ4dR6fExsd4SXL+WQ=="],
@@ -131,10 +140,14 @@
 
     "exif-parser": ["exif-parser@0.1.12", "", {}, "sha512-c2bQfLNbMzLPmzQuOr8fy0csy84WmwnER81W88DzTp9CYNPJ6yzOj2EZAh9pywYpqHnshVLHQJ8WzldAyfY+Iw=="],
 
+    "fast-fuzzy": ["fast-fuzzy@1.12.0", "", { "dependencies": { "graphemesplit": "^2.4.1" } }, "sha512-sXxGgHS+ubYpsdLnvOvJ9w5GYYZrtL9mkosG3nfuD446ahvoWEsSKBP7ieGmWIKVLnaxRDgUJkZMdxRgA2Ni+Q=="],
+
     "file-type": ["file-type@16.5.4", "", { "dependencies": { "readable-web-to-node-stream": "^3.0.0", "strtok3": "^6.2.4", "token-types": "^4.1.1" } }, "sha512-/yFHK0aGjFEgDJjEKP0pWCplsPFPhwyfwevf/pVxiN0tmE4L9LmwWxWukdJSHdoCli4VgQLehjJtwQBnqmsKcw=="],
 
     "gifwrap": ["gifwrap@0.10.1", "", { "dependencies": { "image-q": "^4.0.0", "omggif": "^1.0.10" } }, "sha512-2760b1vpJHNmLzZ/ubTtNnEx5WApN/PYWJvXvgS+tL1egTTthayFYIQQNi136FLEDcN/IyEY2EcGpIITD6eYUw=="],
 
+    "graphemesplit": ["graphemesplit@2.6.0", "", { "dependencies": { "js-base64": "^3.6.0", "unicode-trie": "^2.0.0" } }, "sha512-rG9w2wAfkpg0DILa1pjnjNfucng3usON360shisqIMUBw/87pojcBSrHmeE4UwryAuBih7g8m1oilf5/u8EWdQ=="],
+
     "ieee754": ["ieee754@1.2.1", "", {}, "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA=="],
 
     "image-q": ["image-q@4.0.0", "", { "dependencies": { "@types/node": "16.9.1" } }, "sha512-PfJGVgIfKQJuq3s0tTDOKtztksibuUEbJQIYT3by6wctQo+Rdlh7ef4evJ5NCdxY4CfMbvFkocEwbl4BF8RlJw=="],
@@ -143,11 +156,13 @@
 
     "jpeg-js": ["jpeg-js@0.4.4", "", {}, "sha512-WZzeDOEtTOBK4Mdsar0IqEU5sMr3vSV2RqkAIzUEV2BHnUfKGyswWFPFwK5EeDo93K3FohSHbLAjj0s1Wzd+dg=="],
 
+    "js-base64": ["js-base64@3.7.8", "", {}, "sha512-hNngCeKxIUQiEUN3GPJOkz4wF/YvdUdbNL9hsBcMQTkKzboD7T/q3OYOuuPZLUE6dBxSGpwhk5mwuDud7JVAow=="],
+
     "mime": ["mime@3.0.0", "", { "bin": "cli.js" }, "sha512-jSCU7/VB1loIWBZe14aEYHU/+1UMEHoaO7qxCOVJOw9GgH72VAWppxNcjU+x9a2k3GSIBXNKxXQFqRvvZ7vr3A=="],
 
     "omggif": ["omggif@1.0.10", "", {}, "sha512-LMJTtvgc/nugXj0Vcrrs68Mn2D1r0zf630VNtqtpI1FEO7e+O9FP4gqs9AcnBaSEeoHIPm28u6qgPR0oyEpGSw=="],
 
-    "pako": ["pako@1.0.11", "", {}, "sha512-4hLB8Py4zZce5s4yd9XzopqwVv/yGNhV1Bl8NTmCq1763HeK2+EwVTv+leGeL13Dnh2wfbqowVPXCIO0z4taYw=="],
+    "pako": ["pako@0.2.9", "", {}, "sha512-NUcwaKxUxWrZLpDG+z/xZaCgQITkA/Dv4V/T6bw7VON6l1Xz/VnrBqrYjZQ12TamKHzITTfOEIYUj48y2KXImA=="],
 
     "parse-bmfont-ascii": ["parse-bmfont-ascii@1.0.6", "", {}, "sha512-U4RrVsUFCleIOBsIGYOMKjn9PavsGOXxbvYGtMOEfnId0SVNsgehXh1DxUdVPLoxd5mvcEtvmKs2Mmf0Mpa1ZA=="],
 
@@ -189,6 +204,8 @@
 
     "three": ["three@0.177.0", "", {}, "sha512-EiXv5/qWAaGI+Vz2A+JfavwYCMdGjxVsrn3oBwllUoqYeaBO75J63ZfyaQKoiLrqNHoTlUc6PFgMXnS0kI45zg=="],
 
+    "tiny-inflate": ["tiny-inflate@1.0.3", "", {}, "sha512-pkY1fj1cKHb2seWDy0B16HeWyczlJA9/WW3u3c4z/NiWDsO3DOU5D7nhTLE9CF0yXv/QZFY7sEJmj24dK+Rrqw=="],
+
     "tinycolor2": ["tinycolor2@1.6.0", "", {}, "sha512-XPaBkWQJdsf3pLKJV9p4qN/S+fm2Oj8AIPo1BTUhg5oxkvm9+SVEGFdhyOz7tTdUTfvxMiAs4sp6/eZO2Ew+pw=="],
 
     "token-types": ["token-types@4.2.1", "", { "dependencies": { "@tokenizer/token": "^0.3.0", "ieee754": "^1.2.1" } }, "sha512-6udB24Q737UD/SDsKAHI9FCRP7Bqc9D/MQUV02ORQg5iskjtLJlZJNdN4kKtcdtwCeWIwIHDGaUsTsCCAa8sFQ=="],
@@ -197,6 +214,8 @@
 
     "undici-types": ["undici-types@6.21.0", "", {}, "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ=="],
 
+    "unicode-trie": ["unicode-trie@2.0.0", "", { "dependencies": { "pako": "^0.2.5", "tiny-inflate": "^1.0.0" } }, "sha512-x7bc76x0bm4prf1VLg79uhAzKw8DVboClSN5VxJuQ+LKDOVEW9CdH+VY7SP+vX7xCYQqzzgQpFqz15zeLvAtZQ=="],
+
     "utif2": ["utif2@4.1.0", "", { "dependencies": { "pako": "^1.0.11" } }, "sha512-+oknB9FHrJ7oW7A2WZYajOcv4FcDR4CfoGB0dPNfxbi4GO05RRnFmt5oa23+9w32EanrYcSJWspUiJkLMs+37w=="],
 
     "web-tree-sitter": ["web-tree-sitter@0.25.10", "", { "peerDependencies": { "@types/emscripten": "^1.40.0" }, "optionalPeers": ["@types/emscripten"] }, "sha512-Y09sF44/13XvgVKgO2cNDw5rGk6s26MgoZPXLESvMXeefBf7i6/73eFurre0IsTW6E14Y0ArIzhUMmjoc7xyzA=="],
@@ -214,5 +233,7 @@
     "image-q/@types/node": ["@types/node@16.9.1", "", {}, "sha512-QpLcX9ZSsq3YYUUnD3nFDY8H7wctAhQj/TFKL8Ya8v5fMm3CFXxo8zStsLAl780ltoYoo1WvKUVGBQK+1ifr7g=="],
 
     "pixelmatch/pngjs": ["pngjs@6.0.0", "", {}, "sha512-TRzzuFRRmEoSW/p1KVAmiOgPco2Irlah+bGFCeNfJXxxYGwSw7YwAOAcd7X28K/m5bjBWKsC29KyoMfHbypayg=="],
+
+    "utif2/pako": ["pako@1.0.11", "", {}, "sha512-4hLB8Py4zZce5s4yd9XzopqwVv/yGNhV1Bl8NTmCq1763HeK2+EwVTv+leGeL13Dnh2wfbqowVPXCIO0z4taYw=="],
   }
 }

package/manage_opencode_projects.py

@@ -1,93 +1,98 @@
 #!/usr/bin/env python3
-"""Launch the OpenCode metadata TUI built with OpenTUI.
+"""Launch the OpenCode metadata manager (TUI or CLI).
 
-This wrapper keeps the previous entry point name but simply shells out to the
-new Bun-powered React TUI located under ``src/opencode-tui.tsx``. Use
-``manage_opencode_projects.py -- --help`` to see the TUI's runtime help text.
+This wrapper keeps the previous entry point name but shells out to the
+Bun-powered entrypoint at ``src/bin/opencode-manager.ts``. The routing logic
+detects CLI subcommands (projects, sessions, chat, tokens) and passes them
+directly, otherwise defaults to the TUI.
+
+Usage:
+  manage_opencode_projects.py                    # Launch TUI (default)
+  manage_opencode_projects.py projects list      # CLI: list projects
+  manage_opencode_projects.py sessions list      # CLI: list sessions
+  manage_opencode_projects.py -- --help          # Show TUI help
 """
 
 from __future__ import annotations
 
-import argparse
 import shutil
 import subprocess
 import sys
 from pathlib import Path
 from typing import Sequence
 
-DEFAULT_ROOT = Path.home() / ".local" / "share" / "opencode"
+# CLI subcommands that route to the CLI module instead of TUI
+CLI_SUBCOMMANDS = frozenset({"projects", "sessions", "chat", "tokens"})
+
 PROJECT_DIR = Path(__file__).resolve().parent
 
 
-def parse_args(argv: Sequence[str] | None = None) -> argparse.Namespace:
-    parser = argparse.ArgumentParser(
-        description="Open the interactive OpenCode metadata manager TUI",
-        epilog=(
-            "Examples:\n"
-            "  manage_opencode_projects.py\n"
-            "    Launch the TUI using the default metadata root.\n\n"
-            "  manage_opencode_projects.py --root /tmp/opencode\n"
-            "    Launch the TUI against a different storage directory.\n\n"
-            "  manage_opencode_projects.py -- --help\n"
-            "    Show the TUI's built-in CLI help output.\n"
-        ),
-    )
-    parser.add_argument(
-        "--root",
-        type=Path,
-        default=DEFAULT_ROOT,
-        help="Metadata root to inspect (defaults to ~/.local/share/opencode)",
-    )
-    parser.add_argument(
-        "--bun",
-        type=Path,
-        default=None,
-        help="Optional path to the bun executable if it's not on PATH",
-    )
-    parser.add_argument(
-        "tui_args",
-        nargs=argparse.REMAINDER,
-        help=(
-            "Additional arguments forwarded to the TUI after '--'. For example: "
-            "manage_opencode_projects.py -- --help"
-        ),
-    )
-    return parser.parse_args(argv)
-
-
-def find_bun(explicit: Path | None) -> str:
-    if explicit:
-        return str(explicit)
+def find_bun(explicit_path: str | None = None) -> str:
+    """Locate bun executable, preferring explicit path if provided."""
+    if explicit_path:
+        return explicit_path
     bun_path = shutil.which("bun")
     if bun_path:
         return bun_path
-    raise SystemExit("bun executable not found. Please install Bun to run the TUI.")
-
-
-def launch_tui(root: Path, bun_exe: str, extra_args: Sequence[str]) -> int:
-    # Normalize passthrough args: drop leading "--" if present
-    if extra_args and len(extra_args) > 0 and extra_args[0] == "--":
-        extra_args = extra_args[1:]
-    cmd = [
-        bun_exe,
-        "run",
-        "tui",
-        "--",
-        "--root",
-        str(root.expanduser()),
-    ]
-    if extra_args:
-        cmd.extend(extra_args)
+    raise SystemExit("bun executable not found. Please install Bun.")
+
+
+def is_cli_subcommand(args: Sequence[str]) -> bool:
+    """Check if the first non-flag argument is a CLI subcommand."""
+    for arg in args:
+        if arg.startswith("-"):
+            # Skip flags like --bun, --root, etc.
+            continue
+        # First positional argument determines routing
+        return arg in CLI_SUBCOMMANDS
+    return False
+
 
+def run_entrypoint(bun_exe: str, args: Sequence[str]) -> int:
+    """Run the main entrypoint with given arguments.
+    
+    The TypeScript entrypoint handles all routing internally:
+    - CLI subcommands (projects, sessions, chat, tokens) → CLI module
+    - Everything else → TUI
+    """
+    # Normalize: drop leading "--" if present (legacy passthrough syntax)
+    args_list = list(args)
+    if args_list and args_list[0] == "--":
+        args_list = args_list[1:]
+    
+    cmd = [bun_exe, "src/bin/opencode-manager.ts"] + args_list
     process = subprocess.run(cmd, cwd=PROJECT_DIR)
     return process.returncode
 
 
 def main(argv: Sequence[str] | None = None) -> int:
-    args = parse_args(argv)
-    bun_exe = find_bun(args.bun)
-    extra_args = list(args.tui_args or [])
-    return launch_tui(args.root, bun_exe, extra_args)
+    """Main entry point.
+    
+    Parses minimal wrapper-level options (--bun) and forwards everything
+    else to the TypeScript entrypoint which handles TUI/CLI routing.
+    """
+    if argv is None:
+        argv = sys.argv[1:]
+    
+    args = list(argv)
+    bun_exe_path: str | None = None
+    
+    # Extract --bun option if present (wrapper-level option only)
+    filtered_args: list[str] = []
+    i = 0
+    while i < len(args):
+        if args[i] == "--bun" and i + 1 < len(args):
+            bun_exe_path = args[i + 1]
+            i += 2
+        elif args[i].startswith("--bun="):
+            bun_exe_path = args[i].split("=", 1)[1]
+            i += 1
+        else:
+            filtered_args.append(args[i])
+            i += 1
+    
+    bun_exe = find_bun(bun_exe_path)
+    return run_entrypoint(bun_exe, filtered_args)
 
 
 if __name__ == "__main__":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-manager",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "Terminal UI for inspecting OpenCode metadata stores.",
   "type": "module",
   "license": "MIT",
@@ -20,8 +20,9 @@
     "LICENSE"
   ],
   "scripts": {
-    "tui": "bun src/opencode-tui.tsx",
-    "dev": "bun --watch src/opencode-tui.tsx",
+    "tui": "bun src/tui/index.tsx",
+    "dev": "bun --watch src/tui/index.tsx",
+    "test": "bun test",
     "typecheck": "bunx tsc --noEmit",
     "prepublishOnly": "bun run typecheck"
   },
@@ -45,9 +46,12 @@
   "dependencies": {
     "@opentui/core": "^0.1.44",
     "@opentui/react": "^0.1.44",
+    "commander": "^12.0.0",
+    "fast-fuzzy": "^1.12.0",
     "react": "^19.0.0"
   },
   "devDependencies": {
+    "@types/bun": "^1.3.6",
     "@types/node": "^22.8.5",
     "@types/react": "^19.0.0",
     "typescript": "^5.6.3"

package/src/bin/opencode-manager.ts

@@ -1,4 +1,134 @@
 #!/usr/bin/env bun
-// Bun-native CLI entry that simply boots the TUI module.
-// Keeping this file tiny lets `bun x opencode-manager` launch instantly without extra bundling.
-import "../opencode-tui"
+/**
+ * Main CLI entrypoint for opencode-manager.
+ *
+ * Routes between TUI and CLI modes based on provided subcommands:
+ * - No subcommand → shows help
+ * - "tui" subcommand → launches TUI
+ * - CLI subcommands (projects, sessions, chat, tokens) → launches CLI
+ *
+ * Uses dynamic imports to keep initial load fast and avoid loading
+ * unused modules.
+ */
+
+// Known CLI subcommands that should route to the CLI module
+const CLI_SUBCOMMANDS = new Set([
+  "projects",
+  "sessions",
+  "chat",
+  "tokens",
+])
+
+// Subcommands that explicitly request TUI
+const TUI_SUBCOMMANDS = new Set(["tui"])
+
+// Version from package.json
+const VERSION = "0.4.0"
+
+function printHelp(): void {
+  console.log(`opencode-manager v${VERSION}
+
+Inspect and manage OpenCode metadata stores via TUI or CLI.
+
+USAGE:
+  opencode-manager [command] [options]
+
+MODES:
+  tui                       Launch interactive TUI (terminal user interface)
+  <command>                 Run CLI command (see below)
+
+CLI COMMANDS:
+  projects list             List all projects
+  projects delete           Delete a project's metadata
+
+  sessions list             List sessions (optionally filter by project)
+  sessions delete           Delete a session's metadata
+  sessions rename           Rename a session
+  sessions move             Move a session to another project
+  sessions copy             Copy a session to another project
+
+  chat list                 List messages in a session
+  chat show                 Show a specific message
+  chat search               Search chat content across sessions
+
+  tokens session            Show token usage for a session
+  tokens project            Show token usage for a project
+  tokens global             Show global token usage
+
+OPTIONS:
+  --help, -h                Show this help
+  --version, -v             Show version
+
+EXAMPLES:
+  opencode-manager tui                          # Launch TUI
+  opencode-manager projects list --format json  # List projects as JSON
+  opencode-manager sessions list --project X    # List sessions for project
+  opencode-manager chat search --query "error"  # Search chat content
+
+For detailed help on any command:
+  opencode-manager <command> --help
+  opencode-manager <command> <subcommand> --help
+`)
+}
+
+function printVersion(): void {
+  console.log(VERSION)
+}
+
+async function main(): Promise<void> {
+  const args = process.argv.slice(2)
+  const firstArg = args[0]
+
+  // Handle no args, --help, or -h → show help
+  if (!firstArg || firstArg === "--help" || firstArg === "-h") {
+    printHelp()
+    return
+  }
+
+  // Handle --version or -v
+  if (firstArg === "--version" || firstArg === "-v") {
+    printVersion()
+    return
+  }
+
+  // Determine routing based on first argument
+  const isCliSubcommand = CLI_SUBCOMMANDS.has(firstArg)
+  const isTuiSubcommand = TUI_SUBCOMMANDS.has(firstArg)
+
+  if (isCliSubcommand) {
+    // Route to CLI module (dynamically imported)
+    // Using string path to avoid TypeScript errors before CLI module exists
+    const cliModulePath = "../cli/index"
+    try {
+      const cliModule = await import(cliModulePath)
+      if (typeof cliModule.runCLI !== "function") {
+        throw new Error("CLI module missing runCLI export")
+      }
+      await cliModule.runCLI(args)
+    } catch (error) {
+      const errCode = (error as NodeJS.ErrnoException).code
+      const errMessage = (error as Error).message
+      if (errCode === "ERR_MODULE_NOT_FOUND" || errMessage.includes("Cannot find module")) {
+        console.error(`CLI module not yet implemented. Subcommand: ${firstArg}`)
+        console.error("Run without subcommand to launch TUI, or use --help for usage.")
+        process.exit(1)
+      }
+      throw error
+    }
+  } else if (isTuiSubcommand) {
+    // Explicit TUI request - strip "tui" subcommand so TUI args parser doesn't see it
+    const tuiArgs = args.slice(1)
+    const { bootstrap } = await import("../tui/index")
+    await bootstrap(tuiArgs)
+  } else {
+    // Unknown command
+    console.error(`Unknown command: ${firstArg}\n`)
+    printHelp()
+    process.exit(1)
+  }
+}
+
+main().catch((error) => {
+  console.error(error)
+  process.exit(1)
+})