Track — 工数管理アプリ

React の画面と Bun のローカル API を Tauri にまとめた、macOS 向けの工数管理アプリです。SQLite データベースは利用者のホームディレクトリに保存します。

track/
├── src/
│   ├── client/       # React SPA（画面・コンポーネント・ブラウザ側処理）
│   ├── server/       # Bun + Hono API（ルート・DB・外部予定表）
│   └── shared/       # client/server 共通の型・日付処理・入力検証
├── database/
│   ├── migrations/   # 起動時に順番に適用する手書き SQL
│   └── schema.prisma # Prisma スキーマ
└── src-tauri/        # Tauri の Rustコード・設定・sidecarビルド処理

必要なものは Node.js、Bun、Rust です。

npm install

Prisma CLI を使う場合は、プロジェクトルートに .env を作成します。

DATABASE_URL=file:./database/dev.db

その後、クライアントを生成します。

npx prisma generate

ブラウザで開発するときは、ターミナルを2つ使います。

# Bun API（http://127.0.0.1:8787）
npm run local

# Vite（http://localhost:5173）
npm run dev

Vite は /api を Bun API にプロキシします。ローカル実行時のデータは既定で ~/.track/track.db に保存されます。

アップデート画面は、開発サーバーで次のURLを開くと実際の更新を行わずに確認できます。 アップデート中・完了・再起動の各状態も画面上で再現されます。この指定は本番ビルドでは 無視されます。

http://127.0.0.1:5173/calendar?trackUpdateVersion=0.4.0

デスクトップアプリとして開発する場合は次を使います。

npm run tauri:dev

APIとViteも同時に起動し、フロントエンドの変更はTauriウィンドウへ ホットリロードされます。別途npm run localやnpm run devを起動する必要はありません。

# Bun sidecar を同梱した macOS .app
npm run tauri:build

# 配布用 DMG
npm run tauri:dmg

.app は src-tauri/target/release/bundle/macos/Track.app に生成されます。Bun の実行環境、React のビルド成果物、SQLite マイグレーションを同梱するため、利用端末への Node.js や Bun のインストールは不要です。

現在のsidecarはaarch64-apple-darwin向けで最低動作環境がmacOS 13.0のため、配布対象はmacOS Ventura以降のApple Silicon Macです。Tauri側のLSMinimumSystemVersionもsidecarに合わせて13.0に設定しています。

本番アプリは空いているlocalhostポートを起動時に選びます。二度起動した場合は新しいプロセスを増やさず、既存ウィンドウを前面へ戻します。sidecarやDBの起動に失敗した場合は、macOSのエラーダイアログに原因を表示します。

バックアップ先は設定画面の「選択」ボタンからmacOS標準のフォルダ選択ダイアログで指定できます。ブラウザ開発時は従来どおりパスを直接入力します。

カレンダー、レポート、メモはヘッダー左側、または ⌘1（カレンダー）・⌘2（レポート）・⌘3（メモ）で切り替えます。メモ画面は左側の一覧と右側の編集ペインに分かれ、任意のプロジェクトに関連付けられます。本文にはMilkdown Crepeを使用し、見出しや太字、リンク、チェックリストなどをツールバーやMarkdownショートカットから編集して自動保存できます。ヘッダー中央には画面固有の操作、右側には日付選択とアプリメニューを表示します。表示期間は ⌘[・⌘] で前後へ移動し、⌘T で今日へ戻れます。表示中の期間に今日が含まれる場合は「今日」ボタンを強調します。カレンダーの時間軸は ⌘+・⌘- で拡大縮小できます。macOSのメニューバーは「ファイル」「編集」「表示」「ウインドウ」「ヘルプ」を含めて日本語で表示します。設定は「Track」メニューにある「設定…」または ⌘, でオーバーレイ表示し、勤務・プロジェクト・タグ・バックアップをまとめて管理します。

週表示のレポートでは「週報を生成」から、表示中の絞り込みに一致する工数を Apple Intelligenceの端末内モデルで週報にできます。出力形式は設定の「週報」で 編集でき、{{期間}}と{{合計時間}}をプレースホルダーとして使えます。 生成はmacOS 26以降のApple Intelligence対応Macでのみ利用でき、APIキーや通信は 不要です。生成結果はダイアログ内で編集してからコピーできます。

ヘッダーの操作部品以外の空白は、ウインドウを移動するドラッグ領域として動作します。 ヘッダーは緑がかったチャコールグレーを基調にし、操作グループは半透明、選択中の項目は明るい面で表示します。

macOSアプリの開発言語はsrc-tauri/Info.plistで日本語に設定し、OSが「ウインドウ」メニューへ自動追加するタイル表示やディスプレイ移動などの項目も日本語で表示します。

配布開始後は、hako・nerunaと同じtapからインストールできます。

brew install --cask nemooon/tap/track

現時点のアプリはApple Developer IDではなくad-hoc署名です。macOSに初回起動を止められた場合は、次のコマンドで隔離属性を削除します。

xattr -dr com.apple.quarantine /Applications/Track.app

リリースの流れは次のとおりです。

1. npm run version:set -- 0.3.0でpackage.json、Tauri、Cargoのバージョンをまとめて更新する
2. npm run version:checkでバージョンの一致を確認する
3. 変更をコミットし、GitHubへpushする
4. npm run releaseでApple Silicon向け.appをビルドし、Track-<version>.zipをGitHub Releaseへ公開する
5. .github/workflows/bump-cask.ymlがsha256を計算し、nemooon/homebrew-tapのCasks/track.rbを更新する

リリースノートを指定する場合はnpm run release -- path/to/notes.mdを使います。省略時はGitHubが前回のタグとの差分からリリースノートを生成します。zipだけをローカルで確認するときはnpm run release:packageを使います。

初回リリース前に、次の準備が必要です。

• nemooon/trackをpublicリポジトリにする（通常のHomebrew CaskはprivateなGitHub Releaseを取得できません）
• TrackリポジトリのActions secret TAP_GITHUB_TOKENに、nemooon/homebrew-tapへ書き込めるfine-grained PATを登録する
• GitHub Actionsを有効にする

Homebrew Caskの原型はpackaging/homebrew/track.rb.templateに置いてあります。release workflowは実際のバージョンとsha256を埋め、tap側のCaskを新規作成または更新します。

デスクトップアプリは起動時と24時間ごとにGitHub Releasesを確認します。新しい バージョンがある場合はヘッダー右側のアプリメニューに表示され、案内画面から Homebrewによるアップデートを実行できます。更新中は起動中のTrackを終了せず、 インストール完了後に「再起動」を選ぶと新しいバージョンへ切り替わります。 手動確認はmacOSの「Track」メニューとヘッダー右側のアプリメニューにある 「アップデートを確認…」から実行できます。

TrackにはAIツール連携専用のCLIをTrack.app/Contents/MacOS/track-cliとして 同梱します。ユーザー向けコマンドとしてPATHへインストールはしません。 Trackの起動中はローカルAPIと同梱CLIの実体パスを~/.track/runtime.jsonへ 自動的に書き出します。ファイルのパーミッションは所有者のみ読み書き可能な 0600です。

Codex用スキルとClaude Code用コマンドもTrack.appへ同梱します。macOSの「Track」 メニューから「AI連携をインストール…」を選ぶと、次の場所へインストールします。

• Codex: ~/.codex/skills/track
• Claude Code: ~/.claude/commands/track.md

再実行するとTrackの連携ファイルだけを最新版へ更新します。同名の無関係なスキルや コマンドは上書きしません。インストール後、新しいCodexまたはClaude Codeセッション から利用できます。

どちらもruntime.jsonから同梱CLIを特定して直接実行し、現在のセッションから 作業時間帯を推定します。プロジェクト・タイトル・既存エントリとの重複を提示し、 利用者が明示的に確認した後にだけ登録します。

• Codex: 「$trackで今の作業を記録して」
• Claude Code: 「/track」

AIツールが内部で同梱CLIを取得する例です。通常、利用者がこのコマンドを直接 実行する必要はありません。

TRACK_CLI=$(/usr/bin/plutil -extract cliPath raw ~/.track/runtime.json)
"$TRACK_CLI" prepare --source codex

開発時はnpm run cli -- <command>で直接実行できます。

macOS 26以降のFoundation Modelsを使い、端末内だけで週報の下書きを生成する サンプルを/samples/apple-intelligenceに置いています。APIキーや通信は不要です。 コマンドは一時的なad-hoc署名のmacOSアプリを.buildへ作り、画面を表示せずに LaunchServices経由で実行します。

モデルが利用可能かだけを確認します。

npm run sample:apple-intelligence -- --check

同梱した工数例から週報を生成します。

npm run sample:apple-intelligence

任意の工数テキストを渡すこともできます。

npm run sample:apple-intelligence -- \
  "月曜: A社定例 1時間。火曜: レポート画面の改善 4時間。"

実行にはmacOS 26 SDKを含むXcodeまたはCommand Line Toolsと、Apple Intelligenceが 有効な対応Macが必要です。生成内容はモデルによって変わるため、事実確認してから 利用してください。