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