@voyager-crew/cli 0.2.0 → 0.3.0

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 CHANGED
@@ -57,6 +57,11 @@ Every ask uses GPT-6 Pro in chat mode unless you pick another effort, and leaves
57
57
  Voyager never switches ChatGPT to Work mode. The reply lands in `~/.voyager/jobs/<id>/output/`,
58
58
  and `--json` prints its path along with the conversation link.
59
59
 
60
+ Files the reply offers (a CSV, a chart, a zip ChatGPT made) are saved beside it in `files/`,
61
+ with `-2`, `-3`… added when a name repeats; `--no-files` leaves them in ChatGPT. A file that
62
+ cannot be downloaded is reported without failing the command, since the reply itself was
63
+ saved: `voyager read <link>` tries again later.
64
+
60
65
  ### Long answers
61
66
 
62
67
  Pro can think for hours. `ask` waits as long as ChatGPT is still working on the reply, and
@@ -81,6 +86,24 @@ voyager project files "Thesis"
81
86
  voyager project remove "Thesis" old-notes.md # immediate and permanent; asks first
82
87
  ```
83
88
 
89
+ ## Google Drive and GitHub
90
+
91
+ ChatGPT's own Google Drive and GitHub apps can read your files directly, with no upload through the page. Connect them in ChatGPT first.
92
+
93
+ ```sh
94
+ voyager ask --drive ./paper.pdf "Summarize the method" # puts it on Drive and links it in the prompt
95
+ voyager ask --repo owner/name "Why does CI fail?" # ChatGPT's GitHub app reads the repository
96
+ ```
97
+
98
+ `--drive` packs like `--attach` but has no 64 MiB limit (files over 20 MiB inside a folder are still left out), and uploads with [rclone](https://rclone.org/drive/):
99
+ set `VOYAGER_DRIVE_REMOTE` (or `"driveRemote"` in `~/.voyager/config.json`) to a folder on a Google Drive
100
+ remote, such as `gdrive:Voyager`, on the same Google account ChatGPT's Drive app uses. The files stay there.
101
+
102
+ `--repo` asks ChatGPT to commit only to a new `chatgpt/*` branch, so you review before merging. That is a request, not
103
+ a restriction: the app writes wherever its GitHub installation allows, without asking. If it cannot reach the
104
+ repository, voyager stops with exit code 3; add the repository at
105
+ [github.com/settings/installations](https://github.com/settings/installations).
106
+
84
107
  ## Using it from an agent
85
108
 
86
109
  Claude Code, Codex and any other agent that can run shell commands can use Voyager CLI. Install
package/README_ZH.md CHANGED
@@ -52,6 +52,10 @@ voyager read <链接|id> # 保存某个对话的最
52
52
  默认用聊天模式下的 GPT-6 Pro,除非你另选思考强度;问完保持在这个选择上。Voyager 不会把 ChatGPT
53
53
  切到「工作」模式。回答保存在 `~/.voyager/jobs/<id>/output/`,加 `--json` 会输出文件路径和对话链接。
54
54
 
55
+ 回答里给出的文件(ChatGPT 生成的 CSV、图表、zip 等)会存到旁边的 `files/` 里,重名的依次加 `-2`、`-3`;
56
+ 加 `--no-files` 就不下载。某个文件下载失败只会报告,不会让命令失败,因为回答本身已经保存:之后可以用
57
+ `voyager read <链接>` 再取一次。
58
+
55
59
  ### 很长的回答
56
60
 
57
61
  Pro 可能要想好几个小时。只要 ChatGPT 还在写,`ask` 就一直等;连续 20 分钟完全没动静才算失败。想先拿回终端,就先提交、之后再取:
@@ -73,6 +77,23 @@ voyager project files "论文"
73
77
  voyager project remove "论文" old-notes.md # 立即删除且无法恢复,会先确认
74
78
  ```
75
79
 
80
+ ## Google Drive 和 GitHub
81
+
82
+ ChatGPT 自带的 Google Drive 和 GitHub 应用可以直接读你的文件,不用再经过网页上传。先在 ChatGPT 里连上它们。
83
+
84
+ ```sh
85
+ voyager ask --drive ./paper.pdf "总结一下方法部分" # 放到 Drive 上,把链接写进提示
86
+ voyager ask --repo owner/name "CI 为什么挂了?" # 让 ChatGPT 的 GitHub 应用读这个仓库
87
+ ```
88
+
89
+ `--drive` 的打包方式和 `--attach` 一样,但没有 64 MiB 的限制(文件夹里超过 20 MiB 的单个文件仍会被跳过),用 [rclone](https://rclone.org/drive/) 上传:
90
+ 把 `VOYAGER_DRIVE_REMOTE`(或 `~/.voyager/config.json` 里的 `"driveRemote"`)设成某个 Google Drive remote 上的文件夹,
91
+ 比如 `gdrive:Voyager`,而且要和 ChatGPT 的 Drive 应用是同一个 Google 账号。文件会一直留在那里。
92
+
93
+ `--repo` 会要求 ChatGPT 只往一个新的 `chatgpt/*` 分支提交,你看过再合并。这只是要求,不是限制:它的 GitHub
94
+ 安装能写到哪里,它就能写到哪里,而且不会先问你。读不到仓库时,voyager 以退出码 3 停下,去
95
+ [github.com/settings/installations](https://github.com/settings/installations) 把仓库加上就行。
96
+
76
97
  ## 给 agent 用
77
98
 
78
99
  Claude Code、Codex 以及任何能运行终端命令的 agent 都能用 Voyager CLI。先装上教它们怎么用的 skill: