Uptier

🚀 UpTier

UpTierは、シンプルなMicrosoft To DoスタイルのインターフェースとClaude AIの力を組み合わせた、タスクの優先順位を自動で決定するデスクトップアプリケーションです。Model Context Protocol (MCP)を通じて、Claudeはあなたのタスクを分析し、最も重要なことに集中する手助けをします。

🚀 クイックスタート

前提条件

• Node.js 20+ (LTS推奨)
• pnpm 8+
• Claude Desktop (AI機能を使用する場合)

インストール

# リポジトリをクローン
git clone https://github.com/foxintheloop/uptier.git
cd uptier

# pnpmをインストール (まだインストールされていない場合)
npm install -g pnpm

# 依存関係をインストール
pnpm install

# ネイティブモジュール (canvas, sharp, electron) のビルドスクリプトを承認
pnpm approve-builds

# ネイティブモジュールを再構築
pnpm rebuild

# パッケージをビルド
pnpm --filter @uptier/shared build
pnpm --filter @uptier/mcp-server build

アプリケーションの実行

# 開発モード
pnpm dev:electron

# 本番ビルド
pnpm --filter @uptier/electron build

Claude Desktopとの統合

Claude Desktop用のMCPサーバーをデプロイします。

# MCPサーバーを独立したディレクトリにデプロイ
pnpm --filter @uptier/mcp-server deploy

これにより、MCPサーバーが~/.uptier/mcp-server/にデプロイされ、独自のnode_modulesが作成され、現在のNode.jsバージョンに自動的にコンパイルされます。Claude Desktopの設定も自動的に更新されます。

⚠️ 重要提示

なぜ独立したデプロイが必要なのか？ElectronアプリはNode.js 22 (バンドル済み) を使用しているのに対し、Claude Desktopは異なるNode.jsバージョンを使用する可能性があります。独立したデプロイでは、ネイティブモジュール (例: better-sqlite3) が正しいバージョンにコンパイルされ、競合を防ぎます。

デプロイ後:

1. Claude Desktopを再起動します。
2. UpTierのツールがClaudeで利用可能になります。

手動設定 (代替方法)

自動デプロイが機能しない場合は、Claude Desktopの設定に手動でUpTierを追加してください。

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "uptier": {
      "command": "node",
      "args": ["/path/to/.uptier/mcp-server/index.js"]
    }
  }
}

✨ 主な機能

タスク管理

• リストとタスク - カスタムリスト、サブタスク付きのタスクを作成し、作業を整理できます。
• スマートリスト - 「今日の予定」「重要なタスク」「予定されたタスク」「完了したタスク」などの組み込みビューがあります。
• タグ - 色付きのタグでタスクを分類し、簡単にフィルタリングできます。
• 期限日 - 通知付きで期限日を設定し、期限切れの追跡ができます。
• ドラッグアンドドロップ - リスト内でタスクの順序を並べ替えることができます。

AI機能

• インテリジェントな優先順位付け - Claudeがタスクを分析し、優先順位を決定します。
• 複数の戦略 - アイゼンハワー行列、短期的な成果、高い影響力などの戦略があります。
• 自動提案 - タスクの整理に関するAIの推奨事項を取得できます。

整理機能

• 目標追跡 - タスクを目標にリンクさせ、進捗状況を追跡できます。
• 優先順位階層 - 3段階のシステム (今すぐやる、近いうちにやる、バックログ) があります。
• 優先順位スコアリング - タスクを努力、影響力、緊急性、重要性で評価できます。
• データエクスポート - データをバックアップまたは分析のためにエクスポートできます。

マルチデータベースサポート

• 複数のプロファイル - 仕事、個人、プロジェクト用に別々のデータベースを作成できます。
• 簡単な切り替え - サイドバーからデータベースプロファイルを切り替えることができます。
• 分離されたデータ - 各プロファイルは独自のリスト、タスク、設定を保持します。

フォーカスタイマー

• 集中モード - 全画面のタイマーオーバーレイで集中力を維持できます。
• 柔軟な時間設定 - 事前設定されたオプション (30、45、60、90分) またはカスタム時間を設定できます。
• タスクコンテキスト - 作業中にタスクのタイトルとメモを確認できます。
• キーボードコントロール - スペースキーで一時停止/再開、エスケープキーでセッションを終了できます。

🔧 技術詳細

アーキテクチャ

uptier/
├── apps/
│   ├── electron/          # デスクトップアプリケーション (React + Electron)
│   └── mcp-server/        # Claude Desktop用のMCPサーバー
├── packages/
│   └── shared/            # 共有型とデータベーススキーマ
└── pnpm-workspace.yaml

MCPツール

UpTierは、タスクを管理するための強力なツールをClaudeに公開しています。

リスト

タスク

優先順位付け

目標

サブタスクとタグ

優先順位付けの戦略

Claudeにタスクの優先順位付けを依頼するとき、異なる戦略を要求できます。

優先順位階層

タスクは3つの階層に分類されます。

• 第1階層 (今すぐやる) - 高い影響力、緊急性、または他の作業を妨げるタスク
• 第2階層 (近いうちにやる) - 重要であるが時間的に敏感ではないタスク
• 第3階層 (バックログ) - 優先度が低く、いつかやるかもしれないタスク

データストレージ

データはローカルに保存されます。

• Windows: %APPDATA%\.uptier\tasks.db
• macOS/Linux: ~/.uptier/tasks.db

追加のデータベースプロファイルは、同じディレクトリにカスタム名で保存されます。

データベースはSQLiteをWALモードで使用しており、ElectronアプリとMCPサーバーが同時にアクセスしても競合しません。

ログ

アプリケーションのログは以下の場所に保存されます。

• Windows: %APPDATA%\UpTier\logs\
• macOS: ~/Library/Application Support/UpTier/logs/
• Linux: ~/.config/UpTier/logs/

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

フォーカスタイマーのショートカット

📚 ドキュメント

ロードマップ

• [x] スマートリスト (今日の予定、重要なタスク、予定されたタスク、完了したタスク)
• [x] ダークモード
• [x] キーボードショートカット
• [x] タグ
• [x] 期限日の通知
• [x] 複数のデータベースプロファイル
• [x] データエクスポート
• [x] リストの名前変更/削除
• [x] フォーカスタイマー
• [ ] 繰り返しタスク
• [ ] カスタムスマートリストフィルター
• [ ] カレンダー統合
• [ ] タスクテンプレート
• [ ] モバイルアプリ

トラブルシューティング

"Electron uninstall" エラー

pnpm dev:electronを実行したときにError: Electron uninstallが表示される場合は、Electronバイナリがダウンロードされていません。以下のコマンドを実行してください。

node node_modules/electron/install.js

MCPサーバーのネイティブモジュールエラー

Claude Desktopでbetter-sqlite3またはNODE_MODULE_VERSIONの不一致に関するエラーが表示される場合は、独立したデプロイを使用してください。

pnpm --filter @uptier/mcp-server deploy

これにより、~/.uptier/mcp-server/に別のMCPサーバーインストールが作成され、ネイティブモジュールが現在のNode.jsバージョンにコンパイルされ、Electronアプリとの競合が回避されます。

問題が解決しない場合は、Claude Desktopが使用するのと同じNode.jsバージョン (通常はNode.js 23) でデプロイコマンドを実行していることを確認してください。

ビルドスクリプトの警告

pnpm install中に「Ignored build scripts」に関する警告が表示される場合は、以下のコマンドを実行してください。

pnpm approve-builds

その後、ビルドスクリプトを実行する必要があるパッケージ (canvas, sharp, electron) を選択してください。

🤝 コントリビューション

コントリビューションは大歓迎です！以下の手順で始めることができます。

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更を加えます。
4. アプリを実行してテストします (pnpm dev:electron)。
5. 変更をコミットします (git commit -m 'Add amazing feature')。
6. ブランチにプッシュします (git push origin feature/amazing-feature)。
7. プルリクエストを開きます。

ヘルプ募集: macOSとLinuxのテスト

UpTierは現在Windowsでのみテストされています。macOSまたはLinuxを使用している場合は、テストを手伝って、プラットフォーム固有の問題を報告していただけると幸いです！

📄 ライセンス

MITライセンス - 詳細はLICENSEを参照してください。

Built with Electron, React, and Claude