timeSlice マニュアル

「今すぐ記録」について

「今すぐ記録」を実行すると、Spotlight に似たコメント入力ポップアップが表示されます。コメントを入力して Enter を押すと、すぐにウィンドウキャプチャ・テキスト認識・保存が実行されます。コメントは省略可能です。

⌘ + ENTER を押すとコメントは保存せず、入力内容をキーワードとしてキャプチャビューア検索を実行します。Esc を押すとキャンセルになり、保存は行われません。

ポップアップ上部には、記録対象のアプリ名とウィンドウタイトルがラベルなしで2行表示されます（タイトルが取得できない場合は「（タイトルなし）」を表示）。

ポップアップが開いたとき、前面アプリで選択中のテキストがあれば自動的にコメント欄に入力されます（アクセシビリティ権限が必要です）。

グローバルショートカットキーを設定しておくと、どのアプリを操作中でも「今すぐ記録」を呼び出せます。ショートカットの設定は一般タブをご覧ください。

「選択範囲をキャプチャ」について

「選択範囲をキャプチャ」を実行すると、macOS の screencapture コマンドを使って画面上で任意の矩形領域を選択できます。

選択後にキャプチャ画像のテキスト認識が行われ、「今すぐ記録」と同様のコメント入力ポップアップが表示されます。コメントを入力して Enter を押すと記録が保存されます。Esc を押すとキャプチャ自体がキャンセルされ、保存は行われません。

定期キャプチャとは独立して動作するため、記録中・停止中を問わずいつでも実行できます。記録データの captureTrigger は rectangleCapture となります。

グローバルショートカットキーを設定しておくと、どのアプリを操作中でも「選択範囲をキャプチャ」を呼び出せます。ショートカットの設定は一般タブをご覧ください。

ブラウザURL取得

フロントアプリがブラウザの場合、アクティブタブの URL を AppleScript 経由で自動取得し、記録に含めます。対応ブラウザは以下の通りです。

ブラウザ	対応状況
Safari（Technology Preview を含む）	✅
Google Chrome（Beta / Dev / Canary を含む）	✅
Microsoft Edge（Beta / Dev / Canary を含む）	✅
Brave Browser（Beta / Nightly を含む）	✅
Arc	✅
Vivaldi	✅
Firefox	❌（AppleScript 非対応）

初めてブラウザの URL を取得するとき、macOS がオートメーション権限の確認ダイアログを表示します。「OK」を押して許可してください。許可はブラウザごとに個別に必要です。拒否した場合でも URL が null になるだけでキャプチャ自体は正常に続行されます。

出力サンプル

上記は以下のプロンプトで生成した日報の例です。プロンプトは自由にカスタマイズできます。

以下は{{DATE}} ({{TIME_RANGE}}) の作業記録データです。
いまの作業ディレクトリは `timeSlice/data` です。
次のファイルを読み込んで、内容を要約して日報を作成してください:
{{JSON_FILE_LIST}}

期待レコード件数の目安: {{RECORD_COUNT}} 件

各 JSON の構造:
- `applicationName`: フロントアプリ名
- `windowTitle`: ウィンドウタイトル（null の場合あり）
- `capturedAt`: ISO 8601 の記録時刻
- `recognizedText`: 認識テキスト
- `hasImage`: 画像保存フラグ
- `captureTrigger`: 記録トリガー（`manual` = 今すぐ記録、`scheduled` = 定期キャプチャ、`rectangleCapture` = 選択範囲キャプチャ）
- `comments`: 手動記録コメント（空文字の場合あり）
- `browserURL`: ブラウザのアクティブタブURL（null の場合あり、ブラウザアプリのみ）
- `documentPath`: ドキュメントのファイルパス（null の場合あり、対応アプリのみ）
- `applicationBundlePath`: アプリバンドルのパス（null の場合あり、アイコン解決用）

重要:
- 対象時間帯は {{TIME_RANGE}} です。`capturedAt` の時刻がこの範囲に含まれるレコードのみを対象にしてください。
- `captureTrigger` が `manual` または `rectangleCapture` の記録は、ユーザーが意図的に残した重要ログとして優先的に扱ってください。
- `comments` が空でない記録は、意図付きの重要メモとして最優先で要約に反映してください。
- 概要・作業タイムライン・成果物/進捗には、`manual` / `rectangleCapture` の記録に基づく内容を必ず含めてください。

日報を Markdown で作成してください。次の構成を厳守してください:
1. 概要（2-3文）
2. 作業タイムライン（時間帯ごと）
3. 使用アプリケーション一覧と使用時間
4. 成果物・進捗
5. 所感（任意）

生成の流れ

日報生成を実行すると、timeSlice はプロンプトテンプレートを展開し、data/ ディレクトリをカレントディレクトリとして AI CLI を起動します。AI CLI はプロンプトに記載されたパスから直接 JSON ファイルを読み込み、日報を生成して標準出力に返します。timeSlice はその出力を受け取り、Markdown ファイルとして保存します。

タイムスロットと保存ファイル名

有効なタイムスロットが 1 つだけの場合は report.md として保存されます。複数のスロットが有効な場合は report-0800-1200.md のように時刻をファイル名に含めて区別します。

同じ日に日報を再生成すると、上書き前のファイルは report-YYYY-MM-DD-HHmmss.md という名前でバックアップされます。

定時自動生成は、各タイムスロットの終了時刻ごとに 1 回だけ実行される想定です。 report-1800-2410-YYYY-MM-DD-HHmmss.md のようなバックアップが同一スロットで複数残っている場合は、その時刻帯で同じ出力ファイルが複数回上書きされたことを意味します。

翌日をまたぐスロット

18:00-25:00 のように終了時刻が 24:00 を超えるスロットは、翌日の早朝に実行され、前日分のレコードを対象に日報を生成します。たとえば 25:00（翌 1:00）に実行すると、前日 18:00 以降のレコードをまとめた日報が作られます。

通知

日報の生成が成功すると通知センターに通知が届きます。通知をクリックすると保存済みのレポートファイルが開きます。生成に失敗した場合もエラー内容を示す通知が届きます。

「今すぐ記録」または「選択範囲をキャプチャ」の完了通知をクリックすると、キャプチャビューアが開き、該当レコードが選択された状態で表示されます。

直近の実行結果（コマンド・プロンプト・出力・成否・エラー内容）は logs/report-last-run.json に保存されるので、うまくいかないときの確認に使えます。

一般タブ

権限（画面収録 / アクセシビリティ / オートメーション）

一般タブでは次の3種類の権限を確認できます。

• 画面収録（キャプチャ実行に必要）
• アクセシビリティ（「今すぐ記録」ポップアップへの選択テキスト自動入力と、ドキュメントパス取得に必要）
• オートメーション（ブラウザURL取得に必要）

画面収録とアクセシビリティは各行の「要求」ボタンで権限ダイアログ表示を試行できます。「権限状態を更新」ボタンを押すと最新の状態を再確認できます。

オートメーション権限はブラウザごとに個別管理されるため、一括での状態確認はできません。「システム設定を開く」ボタンからプライバシー設定のオートメーション画面を直接開けます。初回のブラウザURL取得時にmacOSが自動で確認ダイアログを表示するため、事前設定は不要です。

キーボードショートカット

「今すぐ記録」「選択範囲をキャプチャ」「ビューアを開く」の 3 つのグローバルショートカットをそれぞれ設定できます。ショートカット欄をクリックして入力待ち状態にし、⌘ / ⌥ / ⇧ / ⌃ のいずれかの修飾キーと組み合わせてキーを押すと登録されます。Esc を押すと入力をキャンセル、Delete を押すとショートカットを解除します。

設定したショートカットは、他のアプリを操作中でもシステム全体で有効です。「今すぐ記録」のショートカットを押すとコメント入力ポップアップが表示され、前面アプリで選択中のテキストがあれば自動的に入力されます（アクセシビリティ権限が必要です。未許可の場合、初回実行時に許可を促すダイアログが表示されます）。

「選択範囲をキャプチャ」のショートカットを押すと画面選択モードに入り、選択後にコメント入力ポップアップが表示されます。ポップアップが表示されている間に同じショートカットをもう一度押すと、ポップアップが閉じてキャンセルになります。

「ビューアを開く」のショートカットを押すと、キャプチャビューアウィンドウを開きます。

起動設定

「アプリ起動と同時に記録を開始」をオンにすると、timeSlice を起動した直後から自動的に記録が始まります。「ログイン時起動」をオンにすると、macOS にログインするたびに timeSlice が自動起動します。

キャプチャタブ

キャプチャ間隔

スライダーで定期キャプチャの間隔を設定します（10〜600 秒、デフォルト 60 秒）。間隔を短くするほど細かい記録が残りますが、ストレージ消費も増えます。

最小テキスト長

定期キャプチャでは、OCR結果の各行のうちこの文字数未満の行を除外します（デフォルト 10 文字）。除外後に有効な行が残らない場合は記録をスキップします。空白画面や短い情報しかないウィンドウを無視するための設定です。

テキスト認識除外アプリ / テキスト認識除外キーワード

キーワードを追加すると、フロントアプリ名またはウィンドウタイトルがそのキーワードに部分一致するときにテキスト認識をスキップします。また定期キャプチャでは、テキスト認識結果にキーワードが部分一致した場合も同様にスキップします。

いずれの場合もテキストや画像は保存されず、アプリ名・ウィンドウタイトル等のメタデータのみ保存されます。パスワードマネージャーや個人的なメッセージアプリなど、キャプチャしたくないアプリを登録しておくと便利です。

また、apikey のように特定の文字列（変数名など）をキーワードにしておくと、APIキーなどの機密情報が含まれる可能性のあるキャプチャを除外できます。

画像も保存する

このトグルをオンにすると、認識テキストに加えてキャプチャ画像も保存されます。画像保存形式は PNG / JPG から選択できます（デフォルト: PNG）。画像は 3 日間保持されます。

CLI タブ

日報生成に使う AI エージェント CLI の設定を行います。

保存セット（コマンド + 引数）

CLI の設定は「セット」として複数保存できます。上部のプルダウンからセットを選択し、+ で追加、- で削除できます。

各セットには次の項目があります。

• セット名
• CLI コマンド名（例: codex、claude、gemini、opencode）
• 追加引数

追加引数には -p や --prompt を指定してください。プロンプト文字列は、ここで指定した引数の後に続けて渡されます。

• 例1: codex exec --skip-git-repo-check {{PROMPT}}
• 例2: claude -p {{PROMPT}}
• 例3: gemini -p {{PROMPT}}
• 例4: opencode --prompt {{PROMPT}}

手動生成・定時生成のどちらでも、現在選択中のセットが使われます。

タイムアウト

CLI の実行タイムアウトを設定します（30〜3600 秒、デフォルト 300 秒）。AI の処理に時間がかかる場合は長めに設定してください。

日報タブ

定時自動生成とタイムスロット

「定時自動生成」を有効にすると、設定したタイムスロットの終了時刻に自動で日報が生成されます。

タイムスロットは各行で開始時刻・終了時刻・有効 / 無効・使用するプロンプトを設定できます。時刻の増減は 10 分単位で、分が 50 → 00 になると時が 1 増え、00 → 50 になると時が 1 減ります。

各行のプロンプト欄でプルダウンを選ぶと、そのスロットの日報生成に使うテンプレートを個別に指定できます（「デフォルト」を選ぶとデフォルトテンプレートを使用）。

初期状態では次の 4 つのスロットが登録されています。

スロット	状態
08:00 〜 25:00（全日）	有効
08:00 〜 12:00（午前）	無効
12:00 〜 18:00（午後）	無効
18:00 〜 25:00（夜）	無効

複数のスロットを有効にすると時間帯別の日報が生成されます。有効なスロットが 1 つだけの場合は report.md として、複数の場合は report-0800-1200.md のように時刻付きのファイル名で保存されます。

「次回」の表示は有効なスロットから自動計算されます。有効なスロットがない場合は「有効なスロットがありません」と表示されます。

日報の保存先

保存先ディレクトリを変更したい場合はここで指定します。未指定の場合は ~/Library/Application Support/timeSlice/reports/ に保存されます。

手動生成

「対象日」を選択して「今すぐ日報生成」ボタンを押すと、選んだ日付の日報を即座に生成します。また、各タイムスロット行の ▶ ボタンを押すと、そのスロットのみを対象に手動生成できます。

メニューバーの「日報を生成」も同様にタイムスロット設定を反映します。有効スロットが 1 つのときはそのスロット、複数のときはサブメニューで対象スロットを選択して生成します。有効なスロットが存在しない場合は全日分の日報を生成します。

プロンプトタブ

AI CLI に渡すプロンプトのテンプレートを管理・編集します。

複数テンプレートの管理

プルダウンメニューでテンプレートを切り替えられます。「デフォルト」テンプレートは変更できません。「+」ボタンで新しいテンプレートを追加し、「−」ボタンで削除できます。テンプレート名は名前フィールドで直接編集できます。

「デフォルト内容に戻す」ボタンを押すと、現在選択中のテンプレートの内容が初期テンプレートにリセットされます。

編集内容は自動保存されます。

プレースホルダ

テンプレート内で以下のプレースホルダを使うと、日報生成時に実際の値に置き換えられます。

プレースホルダ	内容
{{DATE}}	対象日（例: 2026-02-16）
{{TIME_RANGE}}	対象時間帯（例: "08:00-12:00"、全日は "全日"）
{{JSON_GLOB_PATH}}	JSON ファイルの glob パス（スペース区切り）
{{JSON_FILE_LIST}}	JSON ファイルの glob パス（改行区切り）
{{RECORD_COUNT}}	対象レコード数の目安

アップデートタブ

Sparkle による自動アップデートを管理します。

• 現在のアプリバージョンと最終チェック日時を表示します。
• 「今すぐ確認」で手動アップデートチェックを開始します。
• 「自動でアップデートを確認する」で、起動時および定期バックグラウンドチェックの有効状態を切り替えます。
• 「すべてのリリースを表示」から GitHub Releases ページを開けます。

画面収録

キャプチャのために必須です。初回起動時に許可ダイアログが表示されますが、表示されなかった場合や誤って拒否した場合は次の手順で手動設定してください。

1. 「システム設定」を開きます。
2. 「プライバシーとセキュリティ」→「画面収録」に移動します。
3. 一覧から timeSlice を見つけてチェックを入れます。

アクセシビリティ（選択テキスト / ドキュメントパス取得）

「今すぐ記録」ポップアップで選択中テキストを自動入力する機能と、対応アプリからドキュメントパスを取得する機能で使用します。未許可でもキャプチャと保存は継続できますが、選択テキストの自動入力とドキュメントパス取得は無効になります。

初回実行時に許可を求めるダイアログが表示されない場合や誤って拒否した場合は、次の手順で手動設定してください。

1. 「システム設定」を開きます。
2. 「プライバシーとセキュリティ」→「アクセシビリティ」に移動します。
3. 一覧から timeSlice を見つけてチェックを入れます。

オートメーション（ブラウザURL取得）

ブラウザのアクティブタブ URL を AppleScript で取得するために必要です。初めて各ブラウザの URL を取得する際に macOS が自動で許可ダイアログを表示します。

誤って拒否した場合は次の手順で手動設定してください。

1. 「システム設定」を開きます。
2. 「プライバシーとセキュリティ」→「オートメーション」に移動します。
3. timeSlice の項目で対象ブラウザのチェックを入れます。

設定画面の一般タブにある「システム設定を開く」ボタンからも直接アクセスできます。