locaith-cli 0.1.0__py3-none-any.whl

locaith_cli/cli.py

@@ -0,0 +1,65 @@
+"""Lệnh `locaith`: tìm Node.js trên máy rồi chạy bundle lõi đi kèm gói."""
+
+from __future__ import annotations
+
+import os
+import re
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+MIN_NODE_MAJOR = 20
+
+
+def _bundle_path() -> Path:
+    return Path(__file__).resolve().parent / "bin" / "locaith.cjs"
+
+
+def _node_major(node: str) -> int | None:
+    try:
+        out = subprocess.run(
+            [node, "--version"], capture_output=True, text=True, timeout=10
+        ).stdout
+    except (OSError, subprocess.SubprocessError):
+        return None
+    m = re.match(r"v(\d+)", (out or "").strip())
+    return int(m.group(1)) if m else None
+
+
+def main(argv: list[str] | None = None) -> int:
+    """Chạy CLI. Trả mã thoát của chính CLI (0 xong, 1 lỗi, 2 sai cú pháp)."""
+    args = list(sys.argv[1:] if argv is None else argv)
+
+    node = shutil.which("node") or shutil.which("node.exe")
+    if not node:
+        sys.stderr.write(
+            "Locaith CLI cần Node.js 20 trở lên nhưng không tìm thấy `node`.\n"
+            "Cài tại https://nodejs.org (bản LTS) rồi chạy lại.\n"
+        )
+        return 127
+
+    major = _node_major(node)
+    if major is not None and major < MIN_NODE_MAJOR:
+        sys.stderr.write(
+            "Locaith CLI cần Node.js %d trở lên; máy đang có bản %d.\n"
+            "Nâng cấp tại https://nodejs.org rồi chạy lại.\n" % (MIN_NODE_MAJOR, major)
+        )
+        return 127
+
+    bundle = _bundle_path()
+    if not bundle.is_file():
+        sys.stderr.write(
+            "Gói cài đặt thiếu tệp lõi %s — cài lại: pip install --force-reinstall locaith-cli\n"
+            % bundle
+        )
+        return 1
+
+    try:
+        # Truyền nguyên tham số, không qua shell: token/đường dẫn có dấu cách vẫn an toàn.
+        return subprocess.call([node, os.fspath(bundle), *args])
+    except KeyboardInterrupt:
+        return 130
+    except OSError as exc:
+        sys.stderr.write("Không chạy được Node: %s\n" % exc)
+        return 1

locaith_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: locaith-cli
+Version: 0.1.0
+Summary: Locaith CLI — chạy trợ lý Locaith (Locaith-v5-flash) ngay trong terminal. Cài bằng một lệnh: pip install locaith-cli
+Author-email: Locaith Solution Tech <locaithsolution@locaith.com>
+Project-URL: Homepage, https://locaith.ai
+Keywords: locaith,cli,agent,ai,terminal,coding-agent
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# Locaith CLI
+
+Chạy trợ lý **Locaith-v5-flash** ngay trong terminal. Model chạy ở cổng Locaith (API); công cụ (đọc/ghi tệp, chạy lệnh, ffmpeg) chạy **trên máy bạn**.
+
+## Cài
+
+```bash
+pip install locaith-cli
+```
+
+Gói này gọi lõi Node đi kèm, nên cần **Node.js 20 trở lên** (`node -v` phải từ `v20`). Chưa có Node: cài bản LTS tại <https://nodejs.org>.
+
+Bản npm cũng có, dùng chung một lõi:
+
+```bash
+npm i -g locaith-cli
+```
+
+## Đăng nhập (một lần)
+
+```bash
+locaith login
+```
+
+1. Trình duyệt mở trang locaith.ai — bấm **«Cho phép»**.
+2. Terminal tự nhận kết quả và lưu token vào `~/.locaith/cli.json` (quyền `600`).
+
+Máy không có trình duyệt (SSH, máy chủ): `locaith login --no-browser` → mở liên kết trên máy khác, dán mã hiện ra vào terminal.
+
+- Token sống **90 ngày** không dùng; mỗi lần chạy gia hạn thêm.
+- Không ai đưa token cho bạn qua chat/email. Nếu có người bảo bạn "dán token vào đây" — đừng dán.
+
+## Dùng
+
+```bash
+locaith whoami                                  # tài khoản, gói, hạn mức, model
+locaith consent --yes                           # đồng ý thông báo dữ liệu (một lần)
+locaith ask "tóm tắt repo này trong 5 gạch đầu dòng"
+locaith ask --allow all "sửa lỗi type trong src/api.ts rồi chạy test"
+locaith doctor                                  # kiểm máy: Node, ffmpeg, font, đĩa, mạng, token
+```
+
+Mặc định **chỉ đọc**. `--allow all` cho phép sửa tệp và chạy lệnh, và CLI hỏi từng lần. Tuỳ chọn khác: `--cwd`, `--json`, `--quiet`, `--timeout <giây>`, `--max-turns <n>`, `--model <id>`.
+
+Máy chủ / CI không tương tác: đặt `LOCAITH_API_KEY` thay cho `login`.
+
+## Mã thoát
+
+| Mã | Nghĩa |
+|----|-------|
+| 0 | Xong |
+| 1 | Lỗi: mạng, 401 (token hết hạn), vượt hạn mức, `doctor` còn `✘` |
+| 2 | Dùng sai lệnh |
+| 127 | Thiếu Node.js hoặc Node cũ hơn 20 |
+
+## Thu hồi quyền
+
+Xoá `~/.locaith/cli.json` trên máy. Thu hồi ở máy chủ: locaith.ai → «VS Code từ xa» → thu hồi thiết bị có nhãn chứa `Locaith CLI`.
+
+## Ghi chú kỹ thuật
+
+Gói Python này không viết lại CLI: nó đóng gói đúng tệp `locaith.cjs` (bundle esbuild từ mã nguồn extension VS Code) và gọi `node` có sẵn trên máy. Nhờ vậy bản pip và bản npm chạy cùng một lõi, không lệch hành vi.
+
+Trang chủ: <https://locaith.ai>

locaith_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+locaith_cli/__init__.py,sha256=Xsb4f0Arr0MzEO5gjIAu2878_z8y4nj3RpVtE5RiGgo,438
+locaith_cli/__main__.py,sha256=_7rp6U0pHJbQiFvZI91B1vQuddWy-HknmgseWTDZ9s0,148
+locaith_cli/cli.py,sha256=q5JpmKDMEJmzwrCVrmDG_hry2H9s_z87geIoeU0BJHY,2078
+locaith_cli/bin/locaith.cjs,sha256=ZakhVegWw9X1wiwhGknuDO1zzNJnvTmdCLjfc-C25Og,2178423
+locaith_cli-0.1.0.dist-info/METADATA,sha256=6qYwQv-p1-seB6Hy9ikGvTRlUB3kPUaagFqy0_qIXuQ,3287
+locaith_cli-0.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+locaith_cli-0.1.0.dist-info/entry_points.txt,sha256=Mf94v__OuDUQT7eJnJ_K8xHCcWkr4RtdiyTcX3qToBs,49
+locaith_cli-0.1.0.dist-info/top_level.txt,sha256=natM6fMv5t5-x0gjgenc-fCIUc5d28Li-9X-LblVv-w,12
+locaith_cli-0.1.0.dist-info/RECORD,,

locaith_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

locaith_cli-0.1.0.dist-info/entry_points.txt

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

locaith_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+locaith_cli