yobitsugi-cli
YOBITSUGI AI をターミナルから使う(yobitsugi コマンド)
AI への依頼をターミナルから送り、結果を受け取れます。ローカルのファイルを添付したり、AI が作成したファイルをダウンロードしたりできます。あなたの許可を得て、AI が手元のフォルダのファイルを読み書きしたり、コマンドを実行したりすることもできます。
詳しい使い方は、ターミナルから使う(CLI)をご覧ください。
インストール
npm install -g @gameagelayer/yobitsugi
Node.js 20 以上が必要です(手元のフォルダで作業する機能は Node.js 22 以上)。
ログイン
yobitsugi login
ブラウザで YOBITSUGI AI のログイン画面が開きます。ログインして「ログインする」を押すと完了です。アカウントをお持ちでない場合は、YOBITSUGI AI から登録できます。
ブラウザが開かない場合や、SSH で接続した先など別のコンピューターでログインする場合は、ターミナルに表示される URL を手元のブラウザで開いてください。ログインして「ログインする」を押すとコードが表示されるので、ターミナルに貼り付けると完了です(yobitsugi login --no-browser では、ブラウザを開かずに URL だけを表示します)。
使い方
yobitsugi # 対話モードを開始
yobitsugi "この表を集計して" # 最初のメッセージを指定して対話モードを開始
yobitsugi -p "@売上.csv を集計してグラフにして" -o out # 1 回だけ実行し、作成されたファイルを out/ に保存
cat log.txt | yobitsugi -p "エラーの原因をまとめて" # 標準入力から受け付け
yobitsugi -p -c "さっきの表に前年比を追加して" # このフォルダで最後に使ったセッションを再開
yobitsugi -p --output-format json "…" # 結果を JSON で出力(ほかのツールから利用する場合)
yobitsugi -p --output-format stream-json "…" # 途中の出来事を 1 行ずつ JSON で出力
yobitsugi -p -o out --share "商品写真を 3 枚作って" # 作成された画像を保存し、公開リンクも作成
yobitsugi --allow write "README の使い方の節を書き直して" # このフォルダのファイルを AI が読み書き(書き込みは確認なし)
yobitsugi connect ~/project # このパソコンをつないだままにして、Web やスマホの会話から使う
対話モードのコマンド: /new(新しいセッション)・/sessions(セッション一覧)・/resume <ID>・/model [ID]・/balance(クレジット残高)・/files(このセッションのファイル)・/get <パス> [保存先]・/open(ブラウザで開く)・/link(このセッションのリンク)・/watch(バックグラウンドの処理のあと、AI が続けた内容を表示)・/server <ID>(常駐サーバーの URL と ID・パスワード)・/lock(合言葉でロック)・/relock(今すぐロック)・/local [on|off](手元のフォルダ)・/allow write|exec|all・/deny write|exec|all・/help・/exit。Ctrl+C で実行中の依頼を停止できます(-p のときも停止します)。
対話モードで複数行のメッセージを送るときは、そのまま貼り付けるか、行の終わりに \ を付けて次の行を続けて入力してください。
AI からの質問とロック
- AI が確認の質問をしたときは、選択肢の番号(複数のときは
1,3)か文字で答えます。何も入力せずに Enter を押すと、答えずに続けます。-pで実行したときは、yobitsugi -cで再開して答えてください。 - 時間のかかる処理をバックグラウンドで実行しているときは、見込みの時間と終わる時刻を表示します。終わると AI が続きを進めます。
- 合言葉でロックしたセッションやグループを開くときは、合言葉を入力すると解除できます。
コマンドとオプション
| コマンド | 内容 |
|---|---|
yobitsugi login / logout / whoami | ログイン・ログアウト・ログイン中のアカウントを表示 |
yobitsugi sessions / models / balance | セッション一覧・モデル一覧・クレジット残高 |
yobitsugi get <パス> [保存先] | マイファイルからダウンロード |
yobitsugi files [フォルダ] | マイファイルの一覧(--session <ID> でそのセッションの作業場) |
yobitsugi put <ファイル...> | 手元のファイルをマイファイルへアップロード(--to <フォルダ>) |
yobitsugi share <パス> / unshare <パス> | 公開リンク(ログインなしで開ける URL)を作る・やめる |
yobitsugi follow <セッション ID> | 次の回(バックグラウンドの処理のあとに AI が続けた回など)を終わりまで表示 |
yobitsugi stop <セッション ID> | 実行中の作業を止める |
yobitsugi api <METHOD> </api/…> | Web の画面と同じ API をそのまま呼ぶ(--data に JSON)。画面でできることは、すべてこれでもできます |
yobitsugi connect [フォルダ...] | このパソコンをつないだままにして、Web やスマホの会話から AI にフォルダのファイルとコマンドを使わせる |
| オプション | 内容 |
|---|---|
-p, --print | 1 回だけ実行して結果を表示 |
-c, --continue / -r, --resume <ID> | セッションを再開 |
-m, --model <ID> / --effort <レベル> | モデルと推論の深さ(新しいセッションのとき) |
-o, --out <フォルダ> | 作成されたファイルをダウンロード |
--output-format <形式> | text(既定)・json・stream-json |
--share | 作成されたファイルの公開リンクも作る(-p のとき) |
--local / --no-local | いまのフォルダを AI に使わせる・使わせない(-p は --local を付けたときだけ) |
--allow <機能> | 書き込み(write)・コマンドの実行(exec)・両方(all)を、確認せずに許可 |
--folder <フォルダ> | AI に使わせるフォルダを足す(何度でも) |
--name <名前> | つないだときの名前(既定「CLI(コンピューター名)」) |
--allow-secrets | .env や鍵などのファイルの添付・読み取りを確認せずに許可 |
--no-browser | login のときにブラウザを開かず、URL を表示(表示されたコードを貼り付けてログイン) |
AI やスクリプトから使う
画像・動画・音声・資料などの生成も、Web の画面と同じようにコマンドから依頼できます。結果は次の形で受け取れます。
-o <フォルダ>: 作成されたファイルを手元に保存--output-format json: 終わったときに JSON を 1 つ出力。outputsに作成されたファイルの一覧(path・mime・size・downloadUrl・publicUrl・local)が入ります。downloadUrlはログインが必要な URL で、yobitsugi getで取り出せます。--shareを付けるとpublicUrl(ログインなしで開ける URL)も作ります--output-format stream-json: 途中の出来事(AI の文・ツールの実行・ファイルの作成・公開リンクなど)を、サーバーから届いた順に 1 行ずつ JSON で出力
手元のフォルダで作業する
AI が、あなたの許可を得て、手元のパソコンのファイルを読み書きしたり、コマンドを実行したりできます(Node.js 22 以上)。
- 対話モードを初めて開いたフォルダでは、「このフォルダのファイルを AI が読めるようにするか」を聞きます。答えはフォルダごとに覚えます(
/local on・/local offで変更)。ホームのフォルダでは聞かず、--localを付けたときだけ使います。 - AI が使えるのは、許可したフォルダの中だけです(
--folderで足せます)。 - ファイルの書き込み・移動・削除(OS のごみ箱へ移します)と、コマンドの実行は、その都度ターミナルで確認します。
y(はい)・n(いいえ)・a(この起動中はすべて許可)で答えます。最初から許可するときは--allow write・--allow exec・--allow allを付けます。 .envや鍵など、秘密情報を含む可能性のあるファイルは、読む前にも確認します。-pで使うときは--localを付けます。確認に答えられない使い方(パイプやスクリプト)では、--allowで許可したものだけを行います。yobitsugi connect [フォルダ...]は、会話をせずにこのパソコンをつないだままにします。Web やスマホの YOBITSUGI AI で「つないだ CLI のフォルダで…」と頼むと、AI がそのフォルダを使います。画面の無いサーバーでも使えます。Ctrl+C で終了します。- AI が行った操作は、ターミナルに 1 行ずつ表示し、YOBITSUGI AI の設定の「つないだ端末」にも記録します。Ctrl+C で、実行中の操作とコマンドを止めます。
- 同じログインでつなげる CLI は 1 つです。別のターミナルでつなぐと、前のほうは終わります。
ファイルの添付とダウンロード
- メッセージ内の
@ファイル名で、ローカルのファイルを添付できます(一度に 10 個まで・1 ファイル 100MB まで)。ファイル名のあとに空白を入れずに文を続けても(例:@売上.csvを集計して)添付します。見つからないファイルは、添付していないことを表示します。 .env・秘密鍵・証明書など、秘密情報を含む可能性のあるファイルは、誤って送信しないよう添付を中止します。添付する場合は--allow-secretsを指定してください。- 作成されたファイルは
-oまたは/getでダウンロードできます。同じ名前のファイルがある場合は上書きせず、番号を付けて保存します。
セキュリティ
- ログインは、ブラウザでの認証(認可コード + PKCE)で行います。パスワードを CLI に入力することはありません。貼り付けるコードは 10 分間・1 回だけ有効で、ログインを始めた CLI でなければ使えません。
- ログイン情報は
~/.config/yobitsugi/(Windows は%APPDATA%\yobitsugi\)に、本人だけが読める権限で保存します。yobitsugi logoutで削除し、サーバー側でも無効にします。 - ログイン中の端末は、YOBITSUGI AI の設定の「セキュリティ」→「ログイン中のアプリ」から確認・ログアウトできます。
- AI の出力に含まれる制御文字は、表示の前に取り除きます。
- 手元のフォルダで作業するときは、許可したフォルダの外(シンボリックリンクで外へ出るものを含む)のファイルには触れません。
料金
AI の利用に応じて、YOBITSUGI AI のクレジットが差し引かれます。料金は料金のページをご覧ください。
お問い合わせ
ライセンス
LICENSE をご覧ください。ご利用には YOBITSUGI AI の利用規約が適用されます。
更新
- 一度入れたら、1 日 1 回新しい版を確かめて、自動で更新します(コマンドが終わったあと、裏で入れ替えます)。
yobitsugi updateで、いますぐ最新の版に更新します。yobitsugi update manualで手動に切り替えると、新しい版があることを知らせるだけになります。yobitsugi update autoで自動に戻します。