Claudoro: Claude Code 用ポモドーロタイマー
Claudoro: Claude Code 用ポモドーロタイマー
Claudoro は Claude Code ターミナルに時間管理を直接統合します
Claudoro は Claude Code 環境専用に設計されたポモドーロタイマーで、ライブカウントダウンとサイクルトラッカーをターミナルのステータスラインに直接埋め込みます。開発者の目線がすでに向いている場所にタイマーを配置することで、外部アプリやブラウザタブ、電話の通知といったコンテキストスイッチを必要とせず、深い作業フローを妨げません。
インストールとセットアップ
Claudoro は Node.js バージョン 22 以上が必要です。npm でグローバルにインストールするか、開発目的でソースからインストールできます。
インストール手順:
- npm でインストール:
npm install -g claudoro - 初期化:
pomo setupを実行してツールを Claude Code に組み込みます。このプロセスは/pomoコマンドファイルを作成し、settings.jsonファイルに必要なstatusLine設定をマージします（バックアップ作成後）。
セットアップが完了したら、/pomo start を実行して新しい Claude Code セッションでタイマーを開始できます。
コア機能と使用方法
Claudoro は CLI ツールとして動作し、タイマー状態の唯一の情報源を提供し、それが Claude Code のステータスラインに反映されます。モデルへの往復リクエストは不要で、API トークンを消費しません。
タイマー制御
ユーザーは以下のコマンドで集中セッションを管理できます:
/pomo start [mins]: 集中ブロックを開始します。フラグでデフォルトを上書き可能です:-w（作業）、-s（短い休憩）、-l（長い休憩）、-f（長い休憩の頻度）。/pomo pause | resume | stop: 現在のタイマー状態を制御します。/pomo skip: ポモドーロサイクルの次のフェーズへ進めます。/pomo reset: 現在のフェーズを再開します。/pomo extend [N]: 現在のフェーズに N 分を追加します。
ステータスラインビュー
Claudoro は /pomo view <mode> で切り替え可能な 3 つのビジュアルモードを提供します:
- Minimal: タイマーとプログレスバーのみを表示 (
🍅 22:47 ▕████████░░▏)。 - Classic (Default): 長い休憩に向けたサイクルドットを追加 (
🍅 22:47 ▕████████░░▏ ●●○○)。 - Full: 現在のタスクラベルをステータスラインに追加 (
🍅 22:47 ▕████████░░▏ ●●○○ write tests)。
トランジションモード
異なる作業スタイルに対応するため、Claudoro は /pomo mode <mode> で 3 つの遷移動作を提供します:
- Auto (Default): 集中フェーズと休憩フェーズを自動的に遷移します。
- Balanced: 休憩は自動開始しますが、次の集中ブロックは手動入力を待ち、集中時間の無駄を防ぎます。
- Manual: すべてのフェーズ遷移を手動で行う必要があり、深いフロー作業に最適です。
データ管理とプライバシー
Claudoro はローカルファーストのアーキテクチャに従います。すべてのデータはユーザーのマシン上の XDG ステートディレクトリに保存され、ネットワークやアカウント、テレメトリは不要です。
- ロギング: 完了した集中ブロックは日次 JSONL ログに不変レコードとして保存されます。統計はこれらのログから算出され、カウンタとして保存されないため、
pomo undoコマンドでレコードを削除してもデータがずれません。 - 分析:
pomo statsコマンドはターミナルベースの分析を提供し、ストリークや集中ヒートマップを表示します。pomo stats --webを実行すると、自己完結型 HTML ダッシュボードが生成され、視覚的に分析できます。 - プライバシー: 生成された HTML ダッシュボードはローカルの
~/.local/state/claudoro/dashboard.htmlに保存され、サーバーへアップロードされることはありません。
技術アーキテクチャとガードレール
システム設計
pomo CLI が中心コントローラとして機能します。ステータスラインと /pomo コマンドは CLI と通信する薄いインターフェースです。アラーム（音と OS 通知）を処理する独立したデタッチドプロセスがあり、ターミナルセッションが閉じても確実に発火します。
放棄ガード
タイマーが誤って長時間走り続けた場合の統計歪みを防ぐため、Claudoro は放棄ガードを実装しています。ブロックが計画時間を大幅に超過した場合（デフォルトは 30 分のオーバータイム）、ツールは閾値までの集中時間のみを記録し、ログではそのレコードを abandoned とフラグ付けします。
コミュニティの洞察
このツールは既存のワークフローへの統合が高く評価されていますが、複数の AI エージェントを同時に管理する際の「深い作業」の維持が課題と指摘するユーザーもいます。あるユーザーは次のように述べています:
"If you're following Cal Newport-ian rules, watching over multiple agents doing their work is no longer a 25 minute 'deep work' Pomodoro."
他のユーザーは、スタンドアロンの生産性アプリよりも小さく統合されたツールの価値を強調し、別アプリを開く摩擦が減ることでシステムの利用率が上がると指摘しています。
要約: Claudoro は Claude Code のステータスラインに直接埋め込まれる機能豊富なポモドーロタイマーで、ターミナル内で時間管理を完結させることでコンテキストスイッチを排除します。
タイトル: Claudoro: Claude Code 用ポモドーロタイマー