mcpField
D
deepwork-tracker

deepwork-tracker

github.com/adunne09生産性037 回インストール40 週間前に更新
リポジトリ

deepwork-tracker について

deepwork-tracker は、SQLite ベースのローカルアプリで集中作業セッションを管理するスキルです。macOS Clock のタイマー起動を試み、レポートも作成できます。

主な機能

  1. 01集中作業セッションの開始と停止
  2. 02現在のセッション状態の確認
  3. 03テキストまたは Telegram レポートの作成
  4. 04週単位のヒートマップ作成
  5. 05macOS Clock タイマーの起動

活用シーン

  1. 01目標時間を設定して集中作業を始める
  2. 02現在のセッション状態を確認する
  3. 03直近の日々の集中作業レポートを確認する

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/adunne09/deepwork-tracker --skill deepwork-tracker

インストール後、Claude Code で/deepwork-trackerを入力して読み込まれたか確認します。

詳細

Deepwork Tracker

~/clawd/deepwork/deepwork.js にあるローカルの deepwork アプリ（SQLite ベース）を使用します。

ブートストラップ（スクリプトが見つからない場合）

~/clawd/deepwork/deepwork.js が存在しない場合は、公開リポジトリからブートストラップします。

mkdir -p ~/clawd
cd ~/clawd

# Clone if missing
[ -d ~/clawd/deepwork-tracker/.git ] || git clone https://github.com/adunne09/deepwork-tracker.git ~/clawd/deepwork-tracker

# Ensure expected runtime path exists
mkdir -p ~/clawd/deepwork
cp -f ~/clawd/deepwork-tracker/app/deepwork.js ~/clawd/deepwork/deepwork.js
chmod +x ~/clawd/deepwork/deepwork.js

（クローンまたはコピーに失敗しても、ユーザーのリクエストを中断しないでください。他の手順も試し、不足しているものを報告してください。）

コマンド

exec 経由で実行します。

  • セッションを開始します（macOS の Clock タイマーも開始します。目標時間はデフォルトで 60 分です）。
    • ~/clawd/deepwork/deepwork.js start --target-min 60
  • セッションを停止します。
    • ~/clawd/deepwork/deepwork.js stop
  • 状態を確認します。
    • ~/clawd/deepwork/deepwork.js status
  • レポートを生成します。
    • 直近 7 日間（デフォルト）：~/clawd/deepwork/deepwork.js report --days 7 --format text
    • Telegram 用の直近 7 日間：~/clawd/deepwork/deepwork.js report --days 7 --format telegram
    • ヒートマップ（任意）：~/clawd/deepwork/deepwork.js report --mode heatmap --weeks 52 --format telegram

チャットでのワークフロー

ディープワークを開始する
  1. ~/clawd/deepwork/deepwork.js start --target-min 60 を実行します（ユーザーが別の目標時間を指定した場合は、その時間を使用します）。
  2. 指定した時間の macOS Clock タイマーも開始されます（ベストエフォートで実行されます。アクセシビリティの権限が必要な場合があります）。
  3. 確認メッセージを返信します。
ディープワークを停止する
  1. ~/clawd/deepwork/deepwork.js stop を実行します。
  2. 所要時間を返信します。
ディープワークのグラフを表示する
  1. ~/clawd/deepwork/deepwork.js report --days 7 --format telegram を実行します。
  2. message ツールを使い、Markdown の等幅フォントのコードブロックで、出力を必ず Telegram の Alex（ID 8551040296）に送信します。
  3. 任意で、現在のチャットでも送信したことを伝えます。

ユーザーが別の期間を希望する場合は、--days 7|14|30|60 に対応します。 （ヒートマップは、明示的に要求された場合に --mode heatmap --weeks ... で引き続き利用できます。）

コメント

Markdown 対応