kana はKanaeruのコマンドラインクライアントです。Webアプリと同じKanaeruサービスに接続するため、ターミナルで始めた作業はブラウザにも表示され、その逆も同様です。
インストール
kana はエージェントマネージャーのバンドルに同梱されているため、別途パッケージをインストールする必要はありません。マシンを接続すると、インストーラーが kanaeru-agent-manager と kana の実行ファイルをユーザーローカルのバイナリディレクトリ（macOSとLinuxでは ~/.local/bin）に配置し、そのディレクトリをログイン時の PATH に追加します。
対応プラットフォームは、Apple SiliconのmacOS、Linux x64、Windows x64です。
アップデート
kana が自動で更新されることはありません。各コマンドの実行後、最大6時間に1回、Kanaeruがより新しいバージョンを想定しているかを確認します。お使いのバージョンが古い場合は、stderrに通知を表示します。更新するには、マシンのページ（/machine-connect、またはチャット欄のランタイム選択にある 接続）を開き、エージェントマネージャーを更新 を選びます。対応する kana も一緒に配布されます。
通知を表示しないようにするには、KANAERU_CLI_SKIP_UPDATE_CHECK=1 を設定します。
サインイン
kana login を実行すると、ブラウザで Kanaeru CLIを接続 ページが開きます。Webアプリと同じGoogleまたはMicrosoftアカウントでサインインすると、ターミナル側のログインが自動で完了します。ブラウザがターミナルにトークンを渡すことはありません。ブラウザが返すのは使い捨てのコードで、CLIはそれを自分だけが持つPKCE verifierと引き換えにトークンを取得します。
ブラウザのないマシン（SSH経由、コンテナ内、ヘッドレスホストなど）では、代わりにクロスデバイスフローを使います。
マシンの認証情報
エージェントマネージャーで接続したマシンは、すでにマシン用の認証情報を持っています。誰もkana login を実行していない場合、kana はそれを使います。個人のログインが常に優先されます。どちらが使われているかは kana status で確認でき、Auth: user login (kana login) または Auth: machine bridge (from machine connect) と表示されます。そのため、接続済みのマシンで動くコーディングエージェントは、すぐに kana を使えます。
ワークスペースを選ぶ
ほとんどのコマンドは アクティブなワークスペース に対して動作します。kana workspace use <id> --localは、選択を現在のGitワークツリー内に限定します。チェックアウトごとに別のワークスペースを指定できます。解除するにはkana workspace clear-localを使います。kana workspace use <id> --globalは、共有のCLI状態に保存します。kana --workspace <id> <command>は、そのコマンドだけでワークスペースを使います。フラグはコマンドの前に置きます。
ファイルと環境変数
次のステップ
コマンドリファレンス
すべてのコマンド、引数、フラグ。
ターミナルからKanaと会話する
メッセージの送信、指示、質問への回答、許可リクエストの承認。