プレビュー —
cloudthinker agent は macOS と Linux 向けの CloudThinker CLI に同梱され、有料のワークスペースプランが必要です。プレビューへの参加はこちらからお問い合わせください。cloudthinker agent はターミナルで動くコーディングエージェントで、pi を基盤にしています。ファイルの編集とコマンド実行は自分のマシンで行い、クラウドへはワークスペースのコネクションを使って CloudThinker Sandbox 経由でのみ到達します。
Agent CLI を使う理由
- リポジトリはローカルのまま。 モデルのループ、ファイル編集、シェルコマンドはすべて手元のノート PC で動きます。
- クラウド認証情報をマシンに置かない。 クラウドコマンドは CloudThinker Sandbox で実行され、コネクションの認証情報はその実行のためだけに注入されます。
- ワークスペースのルールが適用される。 クラウドへの書き込みは、チャットと同じ Rules と Approval mode に従います。
- すべてのセッションがミラーされる。 チームメイトはブラウザーでセッションを閲覧でき、ワークスペースが監査と課金を行います。
セッションを開始する
1
インストールしてログインする
CloudThinker CLI をインストールし、
cloudthinker login を実行します。認証情報がない場合はエージェントがブラウザーログインを実行します。2
リポジトリでエージェントを実行する
3
ヘッダーを読む
ヘッダーにはワークスペース、ユーザー、セッションのリンク、そしてワークスペースの承認モードが
· Auto または · Manual として表示されます。成功状態: フッターに ◆ 0.00 credits が表示され、最初のプロンプトを入力できます。2 つの実行環境
エージェントは 2 つの場所で動作でき、どちらを使っているかを常に示します。
コネクションは Sandbox が使える認証情報であり、3 つ目の環境ではありません。エージェントはチャットで CloudThinker が見るのと同じコネクション情報を、毎ターン更新して参照します。ブラウザーで追加したコネクションは次のプロンプトから使えます。
1 つのコマンドで、名前付きの AWS と GCP のコネクションを GitLab と組み合わせて使えます。どのエイリアスを使うかをエージェントに伝えてください。クラウド実行ごとに認証情報とローカルのファイル変更は分離され、新たに宣言された出力ファイルだけがワークスペースに戻り、既存ファイルは上書きされません。
クラウドツール
ct_ask はセッションごとに CloudThinker のスレッドを 1 つ開き、それを再利用します。ct_run_status は承認後に一時停止した実行を再開します。
クラウド書き込みを承認する
クラウドへの書き込みは呼び出しではなく、ワークスペースが判断するリクエストです。まず Rules が判断し、次に Approval mode が判断します。エージェントが書き込みを要求すると、ターミナルはエディターの上に理由、コネクション、コマンド、ブラウザーリンクを載せたカードを固定表示します。
カードでは次のいずれかを選びます。
Escape で拒否します。承認できるのは承認者だけで、承認者であるチームメイトにはブラウザーにも同じカードが表示されます。
Approve and trust this command はそのコマンドをワークスペースのポリシーに記録します。次回から、その同じコマンドは停止せずに実行されます。コマンドを信頼できるのは、ワークスペースのオーナーまたは管理者だけです。信頼できない場合、ターミナルはそのオプションなしで再度確認します。
承認は、書き込みが要求された時点で選ばれていたコネクションをそのまま保持します。コネクションを追加しても保留中の書き込みの範囲は広がりません。アクセス権の削除や、選択済み ID の変更は実行をブロックします。書き込みの結果が不明と報告された場合は、再度要求する前に影響を確認してください。リクエストの再開はコマンドを自動で再実行しません。
ターミナルでの Approval mode
Agent CLI のセッションは Chat 実行タイプのモードを使います。Chat が Same as workspace のとき、セッションはワークスペースのモードを使います。ターミナルはこのモードを表示するだけで、独自のモードは持ちません。/cloudthinker autoを実行すると、モードを表示します。/cloudthinker auto onを実行すると、ワークスペースを Auto · Rules + AI · Ask me にします。すでに Auto モードのワークスペースは、その選択を保ちます。/cloudthinker auto offを実行すると、ワークスペースを Manual にします。
通知
Agent CLI のセッション自体は承認通知を送りません。カードはすでにターミナルとブラウザーの目の前にあるからです。セッションのct_ask スレッドで CloudThinker が出す承認についても同じです。
自分が承認者でない場合は、/cloudthinker notify を実行すると、通知で設定されたチャネル宛に承認リクエストを 1 回だけ送れます。
コマンド
/model、/fork、/settings など pi 自身のコマンドはそのまま使えます。/share と /thinking は削除されています。
セッションミラー
すべてのセッションは Agent CLI 会話としてワークスペースにミラーされます。ブラウザーで開くと、リポジトリ、ブランチ、ツール呼び出し、リンクされた CloudThinker スレッドを含む読み取り専用ビューアーが表示されます。セッションを所有するターミナルだけが書き手なので、誰も入力はできません。閲覧権限を持つワークスペースメンバーは読むことができ、削除できるのはワークスペースのオーナーだけです。 トランスクリプトは pi のセッションファイルとして自分のマシンに残ります。そのファイルを再開すると同じ会話が伸び、/fork は親を記録した新しい会話を開きます。
クレジット
フッターはこのセッションに課金されたクレジットを表示します。例:◆ 1.75 credits。エージェントがモデルを通貨で価格表示することはありません。フッターにミラーの状態が追加されるのは、✕ mirror offline, 3 pending のように対応が必要なときだけです。
関連
CLI
CloudThinker CLI をインストールしてログイン
Approval mode
ワークスペース、実行タイプ、または 1 つのチャットで Manual か Auto を選ぶ
承認
承認者とツールの権限
コネクション
Sandbox が使えるコネクションを設定する