@futurelastic/colab-handbook 1.17.1-rc.2 → 1.18.0-rc.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -1
- package/README.vi.md +2 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -309,6 +309,7 @@ path* last. Unattended, say it with a flag:
|
|
|
309
309
|
|---|---|---|---|
|
|
310
310
|
| Claude Code (`claude`) | `~/.claude/skills` | `/code-start` | Nothing. This user-level install **wins** over a repo's own `.claude/skills/<name>` of the same name (precedence is enterprise > personal > project), so rename a repo variant you want used. |
|
|
311
311
|
| OpenAI Codex (`codex`) | `~/.agents/skills` | `$code-start` | Its default sandbox has no network, so `gh` fails: set `[sandbox_workspace_write] network_access = true` in `~/.codex/config.toml`. Values from Codex's docs; not yet verified by a clean-machine run. |
|
|
312
|
+
| opencode (`opencode`) | `~/.config/opencode/skills` | ask for it: "use the code-start skill" | opencode does not run a skill's `` !`command` `` lines, so the agent reads `.colab/skills/<name>.md` itself. With `OPENCODE_DISABLE_CLAUDE_CODE=1` it reads no `.claude/skills` at all. If `XDG_CONFIG_HOME` is set, the folder moves under it: install there with `--skills-dir`. Verified by a run of opencode 1.18.3. |
|
|
312
313
|
| anything else | `--skills-dir <path>` | the agent's own way | The agent's shell needs network access for `gh`. The folder is remembered in `~/.colab/skills-dirs`. |
|
|
313
314
|
|
|
314
315
|
A re-run with no flag and no terminal keeps every agent runtime it finds already
|
|
@@ -319,7 +320,7 @@ one file each — that folder is the source for the table above.
|
|
|
319
320
|
| Flag | What it does |
|
|
320
321
|
|---|---|
|
|
321
322
|
| *(none)* | Symlink `skills/` into each chosen agent runtime's user-level folder, so they are available in every repo you open. Asks at a terminal; otherwise keeps what is linked (see [*Choose your agent runtime*](#choose-your-agent-runtime)). |
|
|
322
|
-
| `--engine <id>[,<id>]` | Install for these agent runtimes (`claude`, `codex` — the files in `engines/`), no question asked. |
|
|
323
|
+
| `--engine <id>[,<id>]` | Install for these agent runtimes (`claude`, `codex`, `opencode` — the files in `engines/`), no question asked. |
|
|
323
324
|
| `--skills-dir <path>` | Also install into this folder, for an agent `engines/` does not know. |
|
|
324
325
|
| `--tools` | The `colab` CLI twice: a **symlink** at `~/.local/bin/colab` for your sessions (it prints the `PATH` line if needed), and a stamped **frozen copy** at `~/.colab/bin/colab` for always-on services. Also creates an empty `~/.colab/state.json` if there is none. |
|
|
325
326
|
| `--hooks` | Point this clone's git at `.githooks/`: a gitleaks secret scan and an identity scan whose vocabulary you keep outside every repo (see [`templates/README.md`](templates/README.md)). |
|
package/README.vi.md
CHANGED
|
@@ -308,6 +308,7 @@ path*. Chạy không người trông thì nói bằng flag:
|
|
|
308
308
|
|---|---|---|---|
|
|
309
309
|
| Claude Code (`claude`) | `~/.claude/skills` | `/code-start` | Không cần gì. Bản cài cấp user này **thắng** `.claude/skills/<name>` cùng tên của repo (thứ tự ưu tiên là enterprise > personal > project), nên muốn dùng bản của repo thì đổi tên nó. |
|
|
310
310
|
| OpenAI Codex (`codex`) | `~/.agents/skills` | `$code-start` | Sandbox mặc định không có mạng nên `gh` lỗi: đặt `[sandbox_workspace_write] network_access = true` trong `~/.codex/config.toml`. Số liệu lấy từ tài liệu của Codex; chưa được xác minh bằng một lần chạy trên máy sạch. |
|
|
311
|
+
| opencode (`opencode`) | `~/.config/opencode/skills` | nhờ agent: "use the code-start skill" | opencode không chạy các dòng `` !`command` `` của skill, nên agent tự đọc `.colab/skills/<name>.md`. Khi đặt `OPENCODE_DISABLE_CLAUDE_CODE=1` thì nó không đọc `.claude/skills` nào cả. Nếu có `XDG_CONFIG_HOME` thì thư mục chuyển vào dưới đó: cài vào đó bằng `--skills-dir`. Đã xác minh bằng một lần chạy opencode 1.18.3. |
|
|
311
312
|
| agent khác | `--skills-dir <path>` | theo cách của agent | Shell của agent cần có mạng cho `gh`. Thư mục được ghi nhớ trong `~/.colab/skills-dirs`. |
|
|
312
313
|
|
|
313
314
|
Chạy lại không flag và không có terminal thì giữ mọi agent runtime đã thấy được link
|
|
@@ -318,7 +319,7 @@ mỗi agent runtime một file — thư mục đó là nguồn của bảng trê
|
|
|
318
319
|
| Flag | Làm gì |
|
|
319
320
|
|---|---|
|
|
320
321
|
| *(không có)* | Symlink `skills/` vào thư mục cấp user của từng agent runtime đã chọn, để mở repo nào cũng có. Ở terminal thì hỏi; không thì giữ những gì đã link (xem [*Chọn agent runtime*](#chọn-agent-runtime)). |
|
|
321
|
-
| `--engine <id>[,<id>]` | Cài cho các agent runtime này (`claude`, `codex` — các file trong `engines/`), không hỏi. |
|
|
322
|
+
| `--engine <id>[,<id>]` | Cài cho các agent runtime này (`claude`, `codex`, `opencode` — các file trong `engines/`), không hỏi. |
|
|
322
323
|
| `--skills-dir <path>` | Cài thêm vào thư mục này, cho agent mà `engines/` chưa biết. |
|
|
323
324
|
| `--tools` | CLI `colab` cài hai lần: một **symlink** ở `~/.local/bin/colab` cho các phiên làm việc của bạn (in sẵn dòng `PATH` nếu cần), và một **bản đóng băng** có đóng dấu ở `~/.colab/bin/colab` cho các service luôn-bật. Đồng thời tạo `~/.colab/state.json` rỗng nếu chưa có. |
|
|
324
325
|
| `--hooks` | Trỏ git của clone này vào `.githooks/`: quét secret bằng gitleaks, và quét danh tính với danh sách từ khoá do bạn giữ NGOÀI mọi repo (xem [`templates/README.md`](templates/README.md)). |
|
package/package.json
CHANGED