Add non-TUI inspect flow and ignore local AI artifacts

Author: 01rabbit

.gitignore

@@ -7,6 +7,7 @@ __pycache__/
 .venv/
 venv/
 .claude/
+CLAUDE.md
 .coverage
 *.egg-info/
 
@@ -26,6 +27,9 @@ dump.txt
 *.bin
 models/object_gate/
 release/
+report.json
+refactor-instructions.md
+phasmid-autotest/
 
 !requirements.txt
 !MIO _Logo.png

src/phasmid/cli.py

@@ -450,6 +450,11 @@ def _build_tui_parser() -> argparse.ArgumentParser:
 
     inspect_p = subparsers.add_parser("inspect", help="Inspect a Vessel")
     inspect_p.add_argument("vessel", nargs="?", help="Path to Vessel file")
+    inspect_p.add_argument(
+        "--no-tui",
+        action="store_true",
+        help="Print Vessel status without opening the TUI",
+    )
 
     close_p = subparsers.add_parser("close", help="Close a Vessel")
     close_p.add_argument("vessel", nargs="?", help="Path to Vessel file")
@@ -683,6 +688,9 @@ def main():
 
     if args.command == "inspect":
         vessel = getattr(args, "vessel", None)
+        no_tui = getattr(args, "no_tui", False)
+        if no_tui or not sys.stdout.isatty():
+            return _run_inspect_command(args)
         from .tui.app import run_tui
 
         run_tui(initial_screen="inspect", vessel_path=vessel)
@@ -786,6 +794,32 @@ def _run_close_command(args) -> int:
     return 0
 
 
+def _run_inspect_command(args) -> int:
+    vessel = getattr(args, "vessel", None)
+    if not vessel:
+        error("Vessel path is required for inspect.")
+        return 1
+
+    path = Path(vessel).expanduser().resolve()
+    if not path.exists():
+        error(f"vessel file not found: {path}")
+        return 1
+
+    svc = VesselWorkflowService()
+    try:
+        vessels = svc._vessels.list_all()
+        meta = next((item for item in vessels if item.path.resolve() == path), None)
+    except OSError as exc:
+        error(str(exc))
+        return 1
+
+    status_label = "open" if meta and meta.is_open else "closed"
+    open_count = meta.open_count if meta else 0
+    info(f"Vessel: {path.name}")
+    info(f"status: {status_label}  open count: {open_count}")
+    return 0
+
+
 def _run_face_command(args) -> int:
     if getattr(args, "face_command", None) != "create":
         error("Face action is required.")
@@ -1678,4 +1712,4 @@ def _run_legacy_command(args) -> None:
 
 
 if __name__ == "__main__":
-    main()
+    sys.exit(main() or 0)

src/phasmid/config.py

@@ -243,3 +243,7 @@ def standby_hotkey() -> str:
 
 def allow_no_object_binding() -> bool:
     return env_flag("PHASMID_ALLOW_NO_OBJECT_BINDING", default=False)
+
+
+def config_dir_override() -> str:
+    return env_text("PHASMID_CONFIG_DIR", "").strip()

src/phasmid/services/profile_service.py

@@ -12,6 +12,7 @@
 
 import tomli_w
 
+from ..config import config_dir_override
 from ..models.profile import Profile  # noqa: F401 (re-exported)
 
 APP_NAME = "phasmid"
@@ -20,6 +21,9 @@
 
 
 def config_dir() -> Path:
+    override = config_dir_override()
+    if override:
+        return Path(override)
     return Path(platformdirs.user_config_dir(APP_NAME, APP_AUTHOR))