最初に見る場所
Desktopのupdateが必要
Cognoは、アプリの他の画面を開く前に、現在の署名済みDesktop releaseへのupdateを求める場合があります。この画面は閉じられません。Cognoをアップデートを選ぶと開始します。Cognoがreleaseをdownload・installしている間は、progress barと、設定言語に対応した3件のupdate内容が表示されます。横にswipeするか、3つのpage indicatorを使って移動できます。 installが完了するとCognoは自動的に再起動します。更新後のアプリが開いたら、welcome画面で Cognoをはじめる を選びます。in-app updateを利用できない場合は、Cognoをアップデートを選ぶと署名済みinstallerがdownloadされます。手動でinstallしてCognoをもう一度開いてください。errorが表示された場合は もう一度試す または インストーラーをダウンロード を選びます。任意のupdateがあるときは、タイトルバーの右端に 再起動して更新 が表示されます。選んでから 今すぐ再起動 を選びます。このupdateが失敗した場合は同じ場所に 更新に失敗しました が表示されるので、選んでから もう一度試す または ダウンロードページを開く を選び、最新の署名済みreleaseを手動で入手します。Sign-inとワークスペース access
Sign inできない
確認します。- account作成時と同じsign-in methodを使っている。
- emailで新規登録した場合は、受信した最新の6桁confirmation codeをsignup画面へ入力する。メールは別deviceで読んでもよいが、codeはsignupを開始したbrowserへ入力する。
- GoogleまたはApple sign-inの場合は、browserがauth callbackを完了できる。
- invite linkから来た場合は、sign in後にinvite linkをもう一度開く。
- auth callbackがerror pageを表示する場合は、visible error textを控える。
ワークスペースが表示されない
確認します。- ワークスペース selectorを開く。
- 期待するaccountでsign inしている。
- ワークスペース ownerに 設定 → メンバー から新しいinvite linkを送ってもらう。
- 自分で作成できる場合は ワークスペースを作成 を使う。
Invite linkで追加されない
確認します。- 先にsign inする。
- 同じbrowserでinvite linkを開く。
- 設定 → メンバー からfresh invite linkをもらう。
- accept後、ワークスペース ownerがmember listで自分を確認できる。
ワークスペース settings
Settingsがinvalid ワークスペースになる
URLのワークスペース IDがcurrent accountから使えない可能性があります。 次の操作を行います。- Cogno app rootに戻る。
- ワークスペース selectorからワークスペースを選ぶ。
- ワークスペース ownerにmembershipを確認してもらう。
General settingsが読み込めない
次の操作を行います。- pageをrefreshする。
- main Tasks pageから同じワークスペースを開けるか確認する。
- 自分のaccountが 設定 → メンバー に残っているか確認する。
- visible error textを控える。
ワークスペース deleteがdisabled
確認します。- ワークスペース titleが空ではない。
- confirmation dialogにexact ワークスペース titleを入力している。
- deletionによりtasks、chat history、members、ワークスペース dataが消えることを理解している。
Task CSV import
CSV fileがrejectedされる
Cognoはheader rowと少なくとも1件のtask rowを必要とします。 次の操作を行います。- spreadsheetまたはtext editorでCSVを開く。
- row 1がheadersになっていることを確認する。
- 2行目以降にtask dataがあることを確認する。
- CSVとしてexportし直す。
Mapping completeがdisabled
すべてのCSV columnはmapするか、明示的にignoreする必要があります。 確認します。Imported rowsがskippedされる
validationに失敗したrowsはskippedされます。 よくある原因です。Parent tasksがlinkされない
次の操作を行います。- stable parent ID、title、source URL、external keyを Parent Task にmapする。
- 可能ならparent rowを同じimportに含める。
- source IDsまたはURLsを Source または Metadata に残す。
- fileを分けてmigrationする場合は、parentsを先にimportしてからchildrenを再importする。
Imported tasksのcontextが足りない
次の操作を行います。- source URLを Source として残す。
- labels、priorities、milestones、numbers、issue keys、custom fieldsを Metadata にmapする。
- 長いcontextが複数columnsに分かれている場合は、複数の Description columnsを使う。
- 直接対応するCogno fieldがないcommentsやdetailed textはmetadataに残す。
連携
連携が一覧に無い
連携ページには、いま接続できるintegrationだけが並びます。対応予定のものは表示しません。Vercel と PostHog は、ワークスペースにすでに接続がある場合だけ表示されます。Google カレンダーがconnectしない
次の操作を行います。- 連携 → Google カレンダー を開く。
- Connect my Google カレンダー を選択する。
- Google account flowを完了する。
- integration pageに戻り、自分のmember rowがconnectedになっていることを確認する。
カレンダー meetingsにnotetakerが入らない
確認します。- meetingに招待されているmember自身がGoogle カレンダーを接続している。
- eventにmeeting linkがある(Google Meet / Zoom / Microsoft Teams / Webex)。
- eventの開始が10分以上先で、今後のミーティング の設定にある Cognoを参加させる がOnになっている。
- eventが接続済みカレンダー上にある。共有・委任カレンダーのeventも対象です。
- integration pageでaccountがconnectedになっている。
API keysとマシン
Raw API keyが見えなくなった
新しいkeyを作成してください。Cognoはraw keyを作成直後に1回だけ表示し、その後は再表示しません。API key creationが失敗する
確認します。- 自分がワークスペース memberである。
- current user / ワークスペースのactive keysが25個未満である。
- key nameが255文字以下である。
「コンピューター」の項目がブラウザでは出ない
設定 → コンピューター は、いま使っているパソコンを扱う項目を含みます。ブラウザではその項目が出ません。 ブラウザで出るのは あなたのコンピューター — アカウントにサインインしているすべてのコンピューターの一覧 — だけです。このコンピューター(Engine パネル)、ログイン時に Cogno を開く、サーバーの追加は、そのパソコンのCognoデスクトップアプリからしか開けません。 セッションの作業フォルダーは自動でクリーンアップされ、この画面には表示されません。 デスクトップアプリは、ブラウザ右上のアバターメニューの デスクトップアプリを入手 から取得します。プロジェクトを動かす場所がない
environmentとは、マシン上のフォルダーと、そこで作業を動かす設定(AIツール、モデル)のことです。自分のフォルダーはProjectの設定から紐づけます。 次の操作を行います。- サイドバーからプロジェクトを開き、名前の横の ⚙ を選ぶ。
- Source Folders の Add Folder を選ぶ。CognoデスクトップアプリがOS標準のフォルダー選択画面を開き、選んだフォルダーを紐づけます。
- そのフォルダーを持つパソコンで操作する。ブラウザでは Cogno アプリで開く を選びます。
マシンが仕事を受け取らない
確認します。- そのパソコンでCognoが動いている。デスクトップアプリの 設定 → コンピューター → このコンピューター の Engine パネルが 登録済み かつ 接続中 であることを確認します。停止していれば 開始 / 再起動 を選びます。macOSでは閉じるボタンでウィンドウがしまわれるだけで、Cognoはメニューバーに残ります。終了はそこの Quit Cogno です。
- machineにnetwork accessがある。
- 作業に必要なツールが揃っている。あなたのコンピューター の各行に 準備完了 / 注意 / 実行不可 / 未報告 が付き、足りないものはそのまま文になって出ます — エージェント CLI が未インストールです、git が未インストールです、GitHub CLI が未インストールです など。
- 登録済みサーバーの場合は、そのサーバーで
cogno doctorを実行します。各チェックが判定を返し、失敗したチェックには修正コマンドが表示されます。自社サーバーでCognoを動かす を参照してください。
Runが「このマシンの Claude Code が未接続です」で止まった
Cognoの不具合でも、Taskの問題でもありません。そのターンを実行したマシンの Claude Code（または Codex）CLI のサインインが切れた（期限切れ、またはサインアウト）ため、Run は接続待ちで止まっています。- そのマシンのCognoデスクトップアプリでTaskのセッションを開きます。スレッド内の通知に サインイン が出ており、選ぶと
claude auth login/codex loginを実行するターミナルが開きます。 - そこでサインインを完了します。Cognoはサインインが通るのを見て、Run を自動で再開します。サインインするまで Run は再開できないため、それまで再開の操作は表示されません。
- Webアプリから見ている場合や、別のマシンの Run の場合は、通知にそのマシンで実行するコマンドが表示されます。そのマシンでサインインすると、Cognoがそれを検知して通知に Run を再開 を表示します。
WindowsでClaudeが「The filename or extension is too long」で起動しない
Claudeに渡す起動設定の量がWindowsの上限を超えると、このエラーが出ることがあります。 エラーに表示される実行ファイルのパスだけでは、どの部分が長すぎるかは分かりません。1
失敗したパソコンを更新する
そのパソコンに利用可能なCognoデスクトップの更新をインストールし、もう一度作業を実行します。
Desktopのupdateが必要な場合 を参照してください。
2
エラーが続く場合は報告する
エラーが続く場合は、エラー文、デスクトップとEngineのバージョン、影響するWorkspaceをサポートに伝えてください。
Revokeでマシンが切れた
CLIで動かしているマシンなら、replacement keyを作成し、そのマシンで認証し直します。cogno server install を再実行します。revokeは認証情報のすべての世代を一度に無効化するため、サーバーはもう一度承認される必要があります。
メモリ
メモリがsaveできない
次の操作を行います。- 設定 → メモリ をrefreshする。
- sign in状態を確認する。
- 小さなeditを行い、もう一度saveする。
- saveが失敗し続ける場合はvisible error textを控える。
メモリのrenderingがおかしい
メモリはMarkdownです。headings、bullet indentation、fenced code blocks、閉じていないlinksを確認します。DocsとCopy for LLM
Copy for LLMがcopyしない
確認します。- browser clipboard permission。
- pageにfocusがある。
- browser privacy settingsがclipboard writesをblockしていない。
違う言語が表示される
上部ナビゲーションのlanguage switcherを使うか、目的の言語のページを直接開きます。Escalation package
Cognoのチームに連絡するには、アプリ内のフォームを使います。問題・要望を報告するを参照してください。ページ、リリース、ワークスペースは自動で添えられ、返信はメールで届きます。 teammateまたはassistantに相談する時は、次を集めます。- ワークスペース nameまたはID
- page URL
- exact visible error text
- problemを起こしたaction
- refresh後も再現するか
- sanitized screenshotまたはterminal output
- CSV import問題の場合はrelated file headerまたはsample row