locaith-cli 0.1.0__tar.gz

locaith_cli-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,64 @@
+# 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/locaith_cli/__init__.py

@@ -0,0 +1,11 @@
+"""Cầu nối Python → lõi Node của Locaith CLI.
+
+Gói này KHÔNG chứa bản sao thứ hai của CLI: nó đóng gói đúng một tệp `locaith.cjs` (bundle do
+esbuild sinh từ mã nguồn extension, dùng chung một lõi) và gọi bằng `node` có sẵn trên máy.
+Nhờ vậy `pip install locaith-cli` cho ra lệnh `locaith` giống hệt bản npm.
+"""
+
+from .cli import main
+
+__all__ = ["main"]
+__version__ = "0.1.0"

locaith_cli-0.1.0/locaith_cli/__main__.py

@@ -0,0 +1,8 @@
+"""Cho phép `python -m locaith_cli …` như `locaith …`."""
+
+import sys
+
+from .cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())