効率的な個人タスク管理のためのコマンドライン＆ウェブベースのタスク管理システム
このタスク管理システムは、マークダウンファイルベースでタスクを管理し、多様な利用シーンに対応する柔軟なタスク管理ツールです。タスクをディレクトリ構造で管理し、豊富なメタデータとマークダウン形式のメモを記録できます。コマンドラインとウェブの両方からアクセス可能で、プロジェクト別、優先度別のタスク管理を支援します。
- タスク管理の基本機能
- タスクの作成、ステータス変更、一覧表示
- タスクの削除と更新（開発中）
- 分類とフィルタリング
- 優先度（高、中、低）による分類
- プロジェクト別のグループ化
- タグによる分類
- 日付管理
- 期限日の設定と追跡
- 期限切れタスクの検出
- ダッシュボード機能
- タスク数の統計表示
- 優先度別、プロジェクト別の集計
- 期限切れタスクの一覧
- Node.js 14.0以上
- npm または yarn
# リポジトリをクローン
git clone https://github.com/yourusername/task-manager.git
cd task-manager
# 依存パッケージをインストール
npm install
# TypeScriptをビルド
npm run build# タスクを新規作成
npm run create-task
# または
npx ts-node src/scripts/create-task.ts
# タスク一覧を表示
npx ts-node src/scripts/list-tasks.ts
# 未着手のタスクのみ表示
npx ts-node src/scripts/list-tasks.ts todo
# 作業中のタスクのみ表示
npx ts-node src/scripts/list-tasks.ts wip
# プロジェクト別にグループ化して表示
npx ts-node src/scripts/list-tasks.ts --group-by-project
# 優先度でフィルタリング
npx ts-node src/scripts/list-tasks.ts --priority=high
# タスクを作業中に変更
npx ts-node src/scripts/change-task-status.ts start
# タスクを完了に変更
npx ts-node src/scripts/change-task-status.ts complete
# ダッシュボードを表示（開発中）
npx ts-node src/scripts/dashboard.ts# APIサーバーを起動
npm start
# 開発モードで実行（自動リロード）
npm run devブラウザで http://localhost:3000 にアクセスしてWebインターフェースを利用できます。
タスクファイルは以下のディレクトリ構造で管理されます：
tasks/
├── todo/ # 未着手のタスク
├── wip/ # 実行中のタスク
└── completed/ # 完了したタスク
├── YYYY-MM-DD/ # 完了日ごとのディレクトリ
└── ...
タスクはマークダウンファイルとして以下の形式で保存されます：
---
title: "タスクのタイトル"
id: "task-xxxxx"
priority: "high" # high, medium, low
project: "プロジェクト名"
due_date: "YYYY-MM-DD"
created_at: "YYYY-MM-DD"
tags: ["タグ1", "タグ2"]
---
# タスクのタイトル
## 備忘録
タスクに関する詳細なメモをここに記載します。
マークダウン形式で十分な量のメモを残すことができます。
## 参考リンク
- [関連ドキュメント](https://example.com)
## 進捗
- YYYY-MM-DD: 作業内容.
├── src/
│ ├── core/ # コアビジネスロジック
│ ├── mcp/ # 外部インターフェース層
│ │ ├── controllers/ # APIコントローラー
│ │ ├── utils/ # MCP層ユーティリティ
│ │ └── ...
│ ├── scripts/ # コマンドラインスクリプト
│ └── utils/ # 共通ユーティリティ
├── docs/ # ドキュメント
│ ├── insights/ # 技術的知見
│ ├── reports/ # 進捗レポート
│ ├── changelog.md # 変更履歴
│ └── overview.md # プロジェクト概要
├── tasks/ # タスクデータ（ディレクトリ構造）
├── tests/ # テストファイル
├── package.json # npm設定
└── tsconfig.json # TypeScript設定
# 開発モードで実行（変更監視）
npm run dev
# テスト実行
npm test
# 特定のテストファイルを実行
npm test src/mcp/__tests__/dashboard.test.ts
# ビルド
npm run buildこのプロジェクトではGitHub MCPを使ってIssue管理や開発タスクの自動化を行っています。以下の手順で設定してください。
- Docker Desktop（または同等のDockerランタイム環境）がインストールされていること
- GitHubアカウントを持っていること
- Cursorなどのテキストエディタ/IDE（MCP対応）を使用していること
-
GitHubでPersonal Access Token (PAT)を作成
- GitHubアカウント設定 > Developer settings > Personal access tokens > Generate new token
- 必要な権限:
repo,workflow,read:org - トークンをコピーしておく
-
重要: リポジトリ内の
.mcp/configs/github.jsonはテンプレートです- このファイルをMCPホストの設定ディレクトリにコピーします
- Cursorの場合:
~/.cursor/mcp.json
-
コピーした設定ファイルを編集し、以下の項目を自分の環境に合わせて変更
mcpServers.github.env.GITHUB_PERSONAL_ACCESS_TOKEN: 作成したPATconfig.owner: あなたのGitHubユーザー名またはOrganization名config.repo: リポジトリ名
-
変更を保存
- 機密情報（トークンなど）は絶対にリポジトリ内のファイルに保存しないでください
- 各開発者は自分のローカル環境のMCPホスト設定にのみトークンを設定してください
GitHub MCPはDockerコンテナとして実行されます。以下のコマンドでDockerが正しく設定されているか確認できます：
docker --version// GitHubのIssueを取得する例
import { mcp_github_list_issues } from './mcp';
async function getOpenIssues() {
try {
const result = await mcp_github_list_issues({
owner: 'your-username', // MCPホスト設定から自動読み込みされる
repo: 'your-repo', // MCPホスト設定から自動読み込みされる
state: 'open'
});
console.log('Open issues:', result);
} catch (error) {
console.error('Error fetching issues:', error);
}
}すべてのMCP設定テンプレートは.mcp/configs/ディレクトリに保存されています。現在は以下のMCPが利用可能です：
- GitHub MCP:
.mcp/configs/github.json
詳しい説明は.mcp/README.mdを参照してください。
MIT