idea-manager 1.1.5 → 1.1.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ja.md +23 -103
- package/README.ko.md +98 -52
- package/README.md +108 -47
- package/README.zh.md +22 -102
- package/package.json +1 -1
package/README.ja.md
CHANGED
|
@@ -2,125 +2,45 @@
|
|
|
2
2
|
|
|
3
3
|
[English](README.md) | [한국어](README.ko.md) | **日本語** | [中文](README.zh.md)
|
|
4
4
|
|
|
5
|
-
>
|
|
5
|
+
> 自由なブレインストーミングを構造化されたタスクツリーとAIプロンプトに変換
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
開発者向けのローカルファーストタスク管理ツール。アイデアをサブプロジェクトとタスクに整理し、各タスクにプロンプトを作成してAIエージェントに渡せます。内蔵MCPサーバーでAIエージェントの自律実行をサポート。Git経由のPC間同期。
|
|
8
8
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
## コアワークフロー
|
|
12
|
-
|
|
13
|
-
```
|
|
14
|
-
ブレインストーミング → サブプロジェクト/タスクに整理 → プロンプト精製 → MCPでAI実行
|
|
15
|
-
```
|
|
16
|
-
|
|
17
|
-
### 階層構造
|
|
18
|
-
|
|
19
|
-
```
|
|
20
|
-
プロジェクト
|
|
21
|
-
├── サブプロジェクト A
|
|
22
|
-
│ ├── タスク 1 → プロンプト
|
|
23
|
-
│ ├── タスク 2 → プロンプト
|
|
24
|
-
│ └── タスク 3 → プロンプト
|
|
25
|
-
└── サブプロジェクト B
|
|
26
|
-
├── タスク 4 → プロンプト
|
|
27
|
-
└── タスク 5 → プロンプト
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
### タスクステータスフロー
|
|
31
|
-
|
|
32
|
-
```
|
|
33
|
-
💡 Idea → ✏️ Writing → 🚀 Submitted → 🧪 Testing → ✅ Done
|
|
34
|
-
🔴 Problem
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
## インストール
|
|
9
|
+
## クイックスタート
|
|
38
10
|
|
|
39
11
|
```bash
|
|
40
12
|
npm install -g idea-manager
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
## 使い方
|
|
44
|
-
|
|
45
|
-
### Web UIの起動
|
|
46
|
-
|
|
47
|
-
```bash
|
|
48
13
|
im start
|
|
49
14
|
```
|
|
50
15
|
|
|
51
|
-
|
|
16
|
+
ネイティブアプリのような独立ウィンドウで開きます(Chrome/Edge `--app`モード)。初回実行時に自動ビルドされます。
|
|
52
17
|
|
|
53
|
-
|
|
54
|
-
# ポート変更
|
|
55
|
-
im start -p 4000
|
|
56
|
-
```
|
|
18
|
+
## CLIコマンド
|
|
57
19
|
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
im mcp
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
```json
|
|
67
|
-
{
|
|
68
|
-
"mcpServers": {
|
|
69
|
-
"idea-manager": {
|
|
70
|
-
"command": "npx",
|
|
71
|
-
"args": ["-y", "idea-manager", "mcp"]
|
|
72
|
-
}
|
|
73
|
-
}
|
|
74
|
-
}
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
#### Claude Code設定
|
|
78
|
-
|
|
79
|
-
```bash
|
|
80
|
-
claude mcp add idea-manager -- npx -y idea-manager mcp
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
### MCPツール
|
|
84
|
-
|
|
85
|
-
| ツール | 説明 |
|
|
86
|
-
|--------|------|
|
|
87
|
-
| `list-projects` | プロジェクト一覧の取得 |
|
|
88
|
-
| `get-project-context` | サブプロジェクト+タスクツリー全体の取得 |
|
|
89
|
-
| `get-next-task` | 次に実行するタスクとプロンプトの取得(status=submitted) |
|
|
90
|
-
| `get-task-prompt` | 特定タスクのプロンプト取得 |
|
|
91
|
-
| `update-status` | タスクステータスの変更(idea/writing/submitted/testing/done/problem) |
|
|
92
|
-
| `report-completion` | タスク完了の報告 |
|
|
20
|
+
| コマンド | 説明 |
|
|
21
|
+
|----------|------|
|
|
22
|
+
| `im start` | Web UIを起動(ポート3456) |
|
|
23
|
+
| `im mcp` | MCPサーバーを起動(stdio) |
|
|
24
|
+
| `im watch` | 提出済みタスクをAIで自動実行 |
|
|
25
|
+
| `im sync init` | PC間同期の初期化 |
|
|
26
|
+
| `im sync push` | データエクスポート + push |
|
|
27
|
+
| `im sync pull` | データインポート |
|
|
93
28
|
|
|
94
29
|
## 主な機能
|
|
95
30
|
|
|
96
|
-
-
|
|
97
|
-
- **
|
|
98
|
-
-
|
|
99
|
-
-
|
|
100
|
-
-
|
|
101
|
-
-
|
|
102
|
-
- **
|
|
103
|
-
-
|
|
104
|
-
- **PWA対応** — アプリとしてインストールして独立ウィンドウで使用可能
|
|
105
|
-
- **Watchモード** — submittedタスクをClaude CLIで自動実行、リアルタイム進捗表示
|
|
106
|
-
- **MCP Server内蔵** — AIエージェントの自律実行をサポート
|
|
107
|
-
- **ローカルファースト** — SQLiteベース、データは`~/.idea-manager/`に保存
|
|
108
|
-
|
|
109
|
-
## 技術スタック
|
|
110
|
-
|
|
111
|
-
| 領域 | 技術 |
|
|
112
|
-
|------|------|
|
|
113
|
-
| フロントエンド | Next.js 15, React 19, TypeScript, Tailwind CSS 4 |
|
|
114
|
-
| バックエンド | Next.js API Routes |
|
|
115
|
-
| データベース | SQLite (better-sqlite3) |
|
|
116
|
-
| AI | Claude CLI(サブスクリプションベース、APIキー不要) |
|
|
117
|
-
| MCP | Model Context Protocol (stdio) |
|
|
118
|
-
| CLI | Commander.js |
|
|
31
|
+
- **マルチエージェント** — プロジェクトごとにClaude / Gemini / Codexを選択
|
|
32
|
+
- **PC間同期** — Gitリポジトリ経由でデータを同期
|
|
33
|
+
- **MCPサーバー** — 外部AIエージェントにタスクを公開
|
|
34
|
+
- **3パネルレイアウト** — ブレスト | プロジェクトツリー | タスク詳細
|
|
35
|
+
- **タブナビゲーション** — 複数プロジェクトを同時に開く
|
|
36
|
+
- **ファイルツリー** — リンクされたディレクトリを閲覧
|
|
37
|
+
- **AIチャット** — タスクごとの対話で作業を改善
|
|
38
|
+
- **ローカルファースト** — SQLite (sql.js)、ネイティブ依存なし
|
|
119
39
|
|
|
120
|
-
##
|
|
40
|
+
## 要件
|
|
121
41
|
|
|
122
42
|
- **Node.js** 18+
|
|
123
|
-
- **
|
|
43
|
+
- **AI CLI**(オプション)— Claude / Gemini / Codex CLI
|
|
124
44
|
|
|
125
45
|
## ライセンス
|
|
126
46
|
|
package/README.ko.md
CHANGED
|
@@ -2,16 +2,23 @@
|
|
|
2
2
|
|
|
3
3
|
[English](README.md) | **한국어** | [日本語](README.ja.md) | [中文](README.zh.md)
|
|
4
4
|
|
|
5
|
-
>
|
|
5
|
+
> 자유로운 브레인스토밍을 구조화된 태스크 트리와 AI 프롬프트로 변환
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
개발자를 위한 로컬 기반 태스크 관리 도구. 아이디어를 서브 프로젝트와 태스크로 정리하고, 각 태스크에 프롬프트를 작성한 뒤 AI 에이전트에게 넘길 수 있습니다. 내장 MCP 서버로 AI 에이전트의 자율 실행을 지원합니다. Git을 통한 PC 간 동기화.
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
## 빠른 시작
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
npm install -g idea-manager
|
|
13
|
+
im start
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
네이티브 앱처럼 독립 윈도우로 열립니다 (Chrome/Edge `--app` 모드). 첫 실행 시 자동 빌드됩니다.
|
|
10
17
|
|
|
11
18
|
## 핵심 워크플로우
|
|
12
19
|
|
|
13
20
|
```
|
|
14
|
-
브레인스토밍 → 서브
|
|
21
|
+
브레인스토밍 → 서브 프로젝트 / 태스크 → 프롬프트 → AI 에이전트 실행
|
|
15
22
|
```
|
|
16
23
|
|
|
17
24
|
### 계층 구조
|
|
@@ -30,38 +37,58 @@
|
|
|
30
37
|
### 태스크 상태 흐름
|
|
31
38
|
|
|
32
39
|
```
|
|
33
|
-
💡
|
|
34
|
-
|
|
40
|
+
💡 아이디어 → ✏️ 작성중 → 🚀 제출 → 🧪 테스트 → ✅ 완료
|
|
41
|
+
🔴 문제
|
|
35
42
|
```
|
|
36
43
|
|
|
37
|
-
##
|
|
44
|
+
## CLI 명령어
|
|
38
45
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
46
|
+
| 명령어 | 설명 |
|
|
47
|
+
|--------|------|
|
|
48
|
+
| `im start` | 웹 UI 시작 (포트 3456) |
|
|
49
|
+
| `im start -p 4000` | 커스텀 포트 |
|
|
50
|
+
| `im mcp` | MCP 서버 시작 (stdio) |
|
|
51
|
+
| `im watch` | 제출된 태스크 AI 자동 실행 |
|
|
52
|
+
| `im sync init` | PC 간 동기화 초기화 |
|
|
53
|
+
| `im sync push` | 데이터 내보내기 + push |
|
|
54
|
+
| `im sync pull` | 데이터 가져오기 |
|
|
55
|
+
| `im sync` | 동기화 상태 확인 |
|
|
42
56
|
|
|
43
|
-
##
|
|
57
|
+
## 주요 기능
|
|
44
58
|
|
|
45
|
-
###
|
|
59
|
+
### 멀티 에이전트 지원
|
|
46
60
|
|
|
47
|
-
|
|
48
|
-
im start
|
|
49
|
-
```
|
|
61
|
+
프로젝트별로 AI CLI를 선택할 수 있습니다:
|
|
50
62
|
|
|
51
|
-
|
|
63
|
+
| 에이전트 | CLI | 설명 |
|
|
64
|
+
|----------|-----|------|
|
|
65
|
+
| **Claude** | `claude` | Anthropic Claude Code CLI |
|
|
66
|
+
| **Gemini** | `gemini` | Google Gemini CLI |
|
|
67
|
+
| **Codex** | `codex` | OpenAI Codex CLI |
|
|
52
68
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
```
|
|
69
|
+
프로젝트 헤더의 드롭다운에서 선택. Watch 모드와 AI Chat에 적용됩니다.
|
|
70
|
+
|
|
71
|
+
### PC 간 동기화
|
|
57
72
|
|
|
58
|
-
|
|
73
|
+
Git 리포지토리를 통해 여러 PC에서 데이터를 동기화합니다.
|
|
59
74
|
|
|
60
75
|
```bash
|
|
61
|
-
|
|
76
|
+
# 첫 번째 PC
|
|
77
|
+
im sync init # Git 리포 생성/연결
|
|
78
|
+
im sync push # 내보내기 + push
|
|
79
|
+
|
|
80
|
+
# 다른 PC
|
|
81
|
+
im sync init # 같은 리포 URL 입력
|
|
82
|
+
im sync pull # 가져오기
|
|
62
83
|
```
|
|
63
84
|
|
|
64
|
-
|
|
85
|
+
[GitHub CLI](https://cli.github.com) (`gh`)가 있으면 리포 자동 생성을 지원합니다.
|
|
86
|
+
|
|
87
|
+
### MCP 서버
|
|
88
|
+
|
|
89
|
+
Model Context Protocol로 외부 AI 에이전트에 태스크를 노출합니다.
|
|
90
|
+
|
|
91
|
+
**Claude Desktop** (`claude_desktop_config.json`):
|
|
65
92
|
|
|
66
93
|
```json
|
|
67
94
|
{
|
|
@@ -74,53 +101,72 @@ im mcp
|
|
|
74
101
|
}
|
|
75
102
|
```
|
|
76
103
|
|
|
77
|
-
|
|
104
|
+
**Claude Code**:
|
|
78
105
|
|
|
79
106
|
```bash
|
|
80
107
|
claude mcp add idea-manager -- npx -y idea-manager mcp
|
|
81
108
|
```
|
|
82
109
|
|
|
83
|
-
###
|
|
110
|
+
### Watch 모드
|
|
84
111
|
|
|
85
|
-
|
|
86
|
-
|------|------|
|
|
87
|
-
| `list-projects` | 프로젝트 목록 조회 |
|
|
88
|
-
| `get-project-context` | 서브 프로젝트 + 태스크 트리 전체 조회 |
|
|
89
|
-
| `get-next-task` | 다음 실행할 태스크와 프롬프트 조회 (status=submitted) |
|
|
90
|
-
| `get-task-prompt` | 특정 태스크의 프롬프트 조회 |
|
|
91
|
-
| `update-status` | 태스크 상태 변경 (idea/writing/submitted/testing/done/problem) |
|
|
92
|
-
| `report-completion` | 태스크 완료 보고 |
|
|
112
|
+
제출된 태스크를 AI로 자동 실행 (실시간 스트리밍 출력):
|
|
93
113
|
|
|
94
|
-
|
|
114
|
+
```bash
|
|
115
|
+
im watch # Watch 활성화된 모든 프로젝트
|
|
116
|
+
im watch --project <id> # 특정 프로젝트
|
|
117
|
+
im watch --interval 30 --dry-run # 미리보기 모드
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
### 워크스페이스
|
|
121
|
+
|
|
122
|
+
- **3-패널 레이아웃** — 브레인스토밍 | 프로젝트 트리 | 태스크 상세 (드래그로 크기 조절)
|
|
123
|
+
- **탭 기반 네비게이션** — 여러 프로젝트 동시 열기
|
|
124
|
+
- **파일 트리 드로어** — 연결된 프로젝트 디렉토리 탐색
|
|
125
|
+
- **브레인스토밍 패널** — 자유로운 메모 + AI 인라인 메모
|
|
126
|
+
- **프롬프트 에디터** — 태스크별 프롬프트 작성/편집/복사
|
|
127
|
+
- **AI 채팅** — 태스크별 대화로 작업 개선
|
|
128
|
+
- **대시보드** — Active / All / Today 뷰
|
|
129
|
+
- **키보드 단축키** — `B` 브레인스토밍, `N` 서브 프로젝트, `T` 태스크, `Cmd+1~6` 상태 변경
|
|
130
|
+
|
|
131
|
+
### 데이터
|
|
95
132
|
|
|
96
|
-
-
|
|
97
|
-
-
|
|
98
|
-
-
|
|
99
|
-
-
|
|
100
|
-
- **프롬프트 에디터** — 태스크별 프롬프트 작성/편집/복사, AI 다듬기
|
|
101
|
-
- **AI 채팅** — 태스크별 AI 대화로 프롬프트 구체화
|
|
102
|
-
- **3탭 대시보드** — 진행 중 / 전체 / 오늘 할 일
|
|
103
|
-
- **키보드 단축키** — Ctrl+Tab/Ctrl+Shift+Tab으로 탭 이동, B: 브레인스토밍 토글, N: 서브 프로젝트 추가, T: 태스크 추가, Cmd+1~6: 상태 변경 (한영 전환 상관없이 동작)
|
|
104
|
-
- **PWA 지원** — 앱으로 설치하여 독립 창에서 사용 가능
|
|
105
|
-
- **Watch 모드** — submitted 태스크를 Claude CLI로 자동 실행, 실시간 진행 표시
|
|
106
|
-
- **MCP Server 내장** — AI 에이전트 자율 실행 지원
|
|
107
|
-
- **로컬 우선** — SQLite 기반, 데이터는 `~/.idea-manager/`에 저장
|
|
133
|
+
- **로컬 우선** — 모든 데이터는 `~/.idea-manager/data/`에 저장 (SQLite via sql.js)
|
|
134
|
+
- **네이티브 의존성 없음** — 순수 JavaScript, C++ 빌드 도구 불필요
|
|
135
|
+
- **자동 백업** — sync pull 시 기존 DB 자동 백업
|
|
136
|
+
- **앱 모드** — 주소창 없는 독립 윈도우로 실행
|
|
108
137
|
|
|
109
138
|
## 기술 스택
|
|
110
139
|
|
|
111
140
|
| 영역 | 기술 |
|
|
112
141
|
|------|------|
|
|
113
|
-
|
|
|
114
|
-
|
|
|
115
|
-
|
|
|
116
|
-
| AI | Claude
|
|
142
|
+
| 프론트엔드 | Next.js 16, React 19, TypeScript, Tailwind CSS 4 |
|
|
143
|
+
| 백엔드 | Next.js API Routes |
|
|
144
|
+
| 데이터베이스 | SQLite (sql.js, 순수 JS) |
|
|
145
|
+
| AI | Claude / Gemini / Codex CLI |
|
|
117
146
|
| MCP | Model Context Protocol (stdio) |
|
|
118
147
|
| CLI | Commander.js |
|
|
119
148
|
|
|
120
|
-
##
|
|
149
|
+
## 요구사항
|
|
121
150
|
|
|
122
151
|
- **Node.js** 18+
|
|
123
|
-
- **
|
|
152
|
+
- **AI CLI** (선택) — [Claude CLI](https://docs.anthropic.com/en/docs/claude-code), [Gemini CLI](https://github.com/google-gemini/gemini-cli), 또는 [Codex CLI](https://github.com/openai/codex). AI 기능에 필요하며, 태스크 관리는 CLI 없이도 사용 가능.
|
|
153
|
+
|
|
154
|
+
## 문제 해결
|
|
155
|
+
|
|
156
|
+
**설치 후 `im` 명령어를 찾을 수 없음**
|
|
157
|
+
|
|
158
|
+
```bash
|
|
159
|
+
# npm 글로벌 경로를 PATH에 추가
|
|
160
|
+
export PATH="$(npm prefix -g)/bin:$PATH"
|
|
161
|
+
# ~/.zshrc 또는 ~/.bashrc에 위 줄 추가 후
|
|
162
|
+
source ~/.zshrc
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
**포트가 이미 사용 중**
|
|
166
|
+
|
|
167
|
+
```bash
|
|
168
|
+
lsof -t -i :3456 | xargs kill -9 # macOS/Linux
|
|
169
|
+
```
|
|
124
170
|
|
|
125
171
|
## 라이선스
|
|
126
172
|
|
package/README.md
CHANGED
|
@@ -2,16 +2,23 @@
|
|
|
2
2
|
|
|
3
3
|
**English** | [한국어](README.ko.md) | [日本語](README.ja.md) | [中文](README.zh.md)
|
|
4
4
|
|
|
5
|
-
>
|
|
5
|
+
> Turn free-form brainstorming into structured task trees with AI-generated prompts.
|
|
6
6
|
|
|
7
|
-
A task management tool for developers
|
|
7
|
+
A local-first task management tool for developers. Organize ideas into sub-projects and tasks, refine prompts for each task, and hand them off to AI agents. Built-in MCP Server enables autonomous AI agent execution. Cross-PC sync via Git.
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
## Quick Start
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
npm install -g idea-manager
|
|
13
|
+
im start
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
Opens a native-like app window (Chrome/Edge `--app` mode). First run builds automatically.
|
|
10
17
|
|
|
11
18
|
## Core Workflow
|
|
12
19
|
|
|
13
20
|
```
|
|
14
|
-
Brainstorming →
|
|
21
|
+
Brainstorming → Sub-projects / Tasks → Prompts → AI Agent Execution
|
|
15
22
|
```
|
|
16
23
|
|
|
17
24
|
### Hierarchy
|
|
@@ -34,34 +41,54 @@ Project
|
|
|
34
41
|
🔴 Problem
|
|
35
42
|
```
|
|
36
43
|
|
|
37
|
-
##
|
|
44
|
+
## CLI Commands
|
|
38
45
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
46
|
+
| Command | Description |
|
|
47
|
+
|---------|-------------|
|
|
48
|
+
| `im start` | Start web UI (port 3456) |
|
|
49
|
+
| `im start -p 4000` | Custom port |
|
|
50
|
+
| `im mcp` | Start MCP server (stdio) |
|
|
51
|
+
| `im watch` | Auto-execute submitted tasks via AI CLI |
|
|
52
|
+
| `im sync init` | Initialize cross-PC sync |
|
|
53
|
+
| `im sync push` | Export data + push to Git |
|
|
54
|
+
| `im sync pull` | Pull + import data |
|
|
55
|
+
| `im sync` | Show sync status |
|
|
42
56
|
|
|
43
|
-
##
|
|
57
|
+
## Features
|
|
44
58
|
|
|
45
|
-
###
|
|
59
|
+
### Multi-Agent Support
|
|
46
60
|
|
|
47
|
-
|
|
48
|
-
im start
|
|
49
|
-
```
|
|
61
|
+
Choose your AI CLI per project:
|
|
50
62
|
|
|
51
|
-
|
|
63
|
+
| Agent | CLI | Description |
|
|
64
|
+
|-------|-----|-------------|
|
|
65
|
+
| **Claude** | `claude` | Anthropic Claude Code CLI |
|
|
66
|
+
| **Gemini** | `gemini` | Google Gemini CLI |
|
|
67
|
+
| **Codex** | `codex` | OpenAI Codex CLI |
|
|
52
68
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
```
|
|
69
|
+
Select from the project header dropdown. Used for Watch mode and AI Chat.
|
|
70
|
+
|
|
71
|
+
### Cross-PC Sync
|
|
57
72
|
|
|
58
|
-
|
|
73
|
+
Sync your data across machines via a private Git repository.
|
|
59
74
|
|
|
60
75
|
```bash
|
|
61
|
-
|
|
76
|
+
# First machine
|
|
77
|
+
im sync init # Create/connect a Git repo
|
|
78
|
+
im sync push # Export + push
|
|
79
|
+
|
|
80
|
+
# Other machines
|
|
81
|
+
im sync init # Same repo URL
|
|
82
|
+
im sync pull # Pull + import
|
|
62
83
|
```
|
|
63
84
|
|
|
64
|
-
|
|
85
|
+
Supports auto repo creation with [GitHub CLI](https://cli.github.com) (`gh`).
|
|
86
|
+
|
|
87
|
+
### MCP Server
|
|
88
|
+
|
|
89
|
+
Expose tasks to external AI agents via Model Context Protocol.
|
|
90
|
+
|
|
91
|
+
**Claude Desktop** (`claude_desktop_config.json`):
|
|
65
92
|
|
|
66
93
|
```json
|
|
67
94
|
{
|
|
@@ -74,53 +101,87 @@ im mcp
|
|
|
74
101
|
}
|
|
75
102
|
```
|
|
76
103
|
|
|
77
|
-
|
|
104
|
+
**Claude Code**:
|
|
78
105
|
|
|
79
106
|
```bash
|
|
80
107
|
claude mcp add idea-manager -- npx -y idea-manager mcp
|
|
81
108
|
```
|
|
82
109
|
|
|
83
|
-
|
|
110
|
+
#### MCP Tools
|
|
84
111
|
|
|
85
112
|
| Tool | Description |
|
|
86
113
|
|------|-------------|
|
|
87
114
|
| `list-projects` | List all projects |
|
|
88
|
-
| `get-project-context` |
|
|
89
|
-
| `get-next-task` |
|
|
90
|
-
| `get-task-prompt` | Get prompt for a
|
|
91
|
-
| `update-status` | Change task status
|
|
92
|
-
| `report-completion` | Report task
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
- **
|
|
107
|
-
- **
|
|
115
|
+
| `get-project-context` | Full sub-project + task tree |
|
|
116
|
+
| `get-next-task` | Next submitted task to execute |
|
|
117
|
+
| `get-task-prompt` | Get prompt for a task |
|
|
118
|
+
| `update-status` | Change task status |
|
|
119
|
+
| `report-completion` | Report task done |
|
|
120
|
+
|
|
121
|
+
### Watch Mode
|
|
122
|
+
|
|
123
|
+
Auto-execute submitted tasks with real-time streaming output:
|
|
124
|
+
|
|
125
|
+
```bash
|
|
126
|
+
im watch # All watch-enabled projects
|
|
127
|
+
im watch --project <id> # Specific project
|
|
128
|
+
im watch --interval 30 --dry-run # Preview mode
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
### Workspace
|
|
132
|
+
|
|
133
|
+
- **3-Panel Layout** — Brainstorming | Project Tree | Task Detail (drag to resize)
|
|
134
|
+
- **Tab-based Navigation** — Multiple projects open simultaneously
|
|
135
|
+
- **File Tree Drawer** — Browse linked project directories
|
|
136
|
+
- **Brainstorming Panel** — Free-form notes with inline AI memos
|
|
137
|
+
- **Prompt Editor** — Write/edit/copy prompts per task
|
|
138
|
+
- **AI Chat** — Per-task conversations to refine work
|
|
139
|
+
- **Dashboard** — Active / All / Today views
|
|
140
|
+
- **Keyboard Shortcuts** — `B` brainstorm, `N` sub-project, `T` task, `Cmd+1~6` status
|
|
141
|
+
|
|
142
|
+
### Data
|
|
143
|
+
|
|
144
|
+
- **Local-first** — All data in `~/.idea-manager/data/` (SQLite via sql.js)
|
|
145
|
+
- **Zero native deps** — Pure JavaScript, no C++ build tools needed
|
|
146
|
+
- **Auto backup** — Database backed up before each sync pull
|
|
147
|
+
- **App mode** — Opens in Chrome/Edge without address bar
|
|
108
148
|
|
|
109
149
|
## Tech Stack
|
|
110
150
|
|
|
111
151
|
| Area | Technology |
|
|
112
152
|
|------|------------|
|
|
113
|
-
| Frontend | Next.js
|
|
153
|
+
| Frontend | Next.js 16, React 19, TypeScript, Tailwind CSS 4 |
|
|
114
154
|
| Backend | Next.js API Routes |
|
|
115
|
-
| Database | SQLite (
|
|
116
|
-
| AI | Claude
|
|
155
|
+
| Database | SQLite (sql.js, pure JS) |
|
|
156
|
+
| AI | Claude / Gemini / Codex CLI |
|
|
117
157
|
| MCP | Model Context Protocol (stdio) |
|
|
118
158
|
| CLI | Commander.js |
|
|
119
159
|
|
|
120
160
|
## Requirements
|
|
121
161
|
|
|
122
162
|
- **Node.js** 18+
|
|
123
|
-
- **
|
|
163
|
+
- **AI CLI** (optional) — [Claude CLI](https://docs.anthropic.com/en/docs/claude-code), [Gemini CLI](https://github.com/google-gemini/gemini-cli), or [Codex CLI](https://github.com/openai/codex) for AI features. Core task management works without it.
|
|
164
|
+
|
|
165
|
+
## Troubleshooting
|
|
166
|
+
|
|
167
|
+
**`im` command not found after install**
|
|
168
|
+
|
|
169
|
+
Add npm's global bin directory to your PATH:
|
|
170
|
+
|
|
171
|
+
```bash
|
|
172
|
+
# Check the path
|
|
173
|
+
npm prefix -g
|
|
174
|
+
# Add to shell profile (~/.zshrc or ~/.bashrc)
|
|
175
|
+
export PATH="$(npm prefix -g)/bin:$PATH"
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
**Port already in use**
|
|
179
|
+
|
|
180
|
+
```bash
|
|
181
|
+
# Kill the process using the port
|
|
182
|
+
lsof -t -i :3456 | xargs kill -9 # macOS/Linux
|
|
183
|
+
netstat -ano | findstr :3456 # Windows (then taskkill /PID <pid> /F)
|
|
184
|
+
```
|
|
124
185
|
|
|
125
186
|
## License
|
|
126
187
|
|
package/README.zh.md
CHANGED
|
@@ -2,125 +2,45 @@
|
|
|
2
2
|
|
|
3
3
|
[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | **中文**
|
|
4
4
|
|
|
5
|
-
>
|
|
5
|
+
> 将自由头脑风暴转化为结构化任务树和AI提示词
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
面向开发者的本地优先任务管理工具。将想法组织成子项目和任务,为每个任务编写提示词,然后交给AI代理执行。内置MCP服务器支持AI代理自主执行。通过Git实现跨PC同步。
|
|
8
8
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
## 核心工作流
|
|
12
|
-
|
|
13
|
-
```
|
|
14
|
-
头脑风暴 → 组织成子项目/任务 → 精炼提示词 → 通过 MCP 执行 AI
|
|
15
|
-
```
|
|
16
|
-
|
|
17
|
-
### 层级结构
|
|
18
|
-
|
|
19
|
-
```
|
|
20
|
-
项目
|
|
21
|
-
├── 子项目 A
|
|
22
|
-
│ ├── 任务 1 → 提示词
|
|
23
|
-
│ ├── 任务 2 → 提示词
|
|
24
|
-
│ └── 任务 3 → 提示词
|
|
25
|
-
└── 子项目 B
|
|
26
|
-
├── 任务 4 → 提示词
|
|
27
|
-
└── 任务 5 → 提示词
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
### 任务状态流
|
|
31
|
-
|
|
32
|
-
```
|
|
33
|
-
💡 Idea → ✏️ Writing → 🚀 Submitted → 🧪 Testing → ✅ Done
|
|
34
|
-
🔴 Problem
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
## 安装
|
|
9
|
+
## 快速开始
|
|
38
10
|
|
|
39
11
|
```bash
|
|
40
12
|
npm install -g idea-manager
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
## 使用方法
|
|
44
|
-
|
|
45
|
-
### 启动 Web UI
|
|
46
|
-
|
|
47
|
-
```bash
|
|
48
13
|
im start
|
|
49
14
|
```
|
|
50
15
|
|
|
51
|
-
|
|
16
|
+
以原生应用般的独立窗口打开(Chrome/Edge `--app` 模式)。首次运行时自动构建。
|
|
52
17
|
|
|
53
|
-
|
|
54
|
-
# 自定义端口
|
|
55
|
-
im start -p 4000
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
### 启动 MCP Server
|
|
59
|
-
|
|
60
|
-
```bash
|
|
61
|
-
im mcp
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
#### Claude Desktop 配置 (claude_desktop_config.json)
|
|
65
|
-
|
|
66
|
-
```json
|
|
67
|
-
{
|
|
68
|
-
"mcpServers": {
|
|
69
|
-
"idea-manager": {
|
|
70
|
-
"command": "npx",
|
|
71
|
-
"args": ["-y", "idea-manager", "mcp"]
|
|
72
|
-
}
|
|
73
|
-
}
|
|
74
|
-
}
|
|
75
|
-
```
|
|
18
|
+
## CLI命令
|
|
76
19
|
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
```bash
|
|
80
|
-
claude mcp add idea-manager -- npx -y idea-manager mcp
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
### MCP 工具
|
|
84
|
-
|
|
85
|
-
| 工具 | 描述 |
|
|
20
|
+
| 命令 | 说明 |
|
|
86
21
|
|------|------|
|
|
87
|
-
| `
|
|
88
|
-
| `
|
|
89
|
-
| `
|
|
90
|
-
| `
|
|
91
|
-
| `
|
|
92
|
-
| `
|
|
22
|
+
| `im start` | 启动Web UI(端口3456) |
|
|
23
|
+
| `im mcp` | 启动MCP服务器(stdio) |
|
|
24
|
+
| `im watch` | AI自动执行已提交的任务 |
|
|
25
|
+
| `im sync init` | 初始化跨PC同步 |
|
|
26
|
+
| `im sync push` | 导出数据 + push |
|
|
27
|
+
| `im sync pull` | 导入数据 |
|
|
93
28
|
|
|
94
29
|
## 主要功能
|
|
95
30
|
|
|
96
|
-
-
|
|
97
|
-
-
|
|
98
|
-
-
|
|
99
|
-
-
|
|
100
|
-
-
|
|
101
|
-
-
|
|
102
|
-
-
|
|
103
|
-
-
|
|
104
|
-
- **PWA 支持** — 可安装为应用,在独立窗口中使用
|
|
105
|
-
- **Watch 模式** — 通过 Claude CLI 自动执行已提交的任务,实时显示进度
|
|
106
|
-
- **内置 MCP Server** — 支持 AI 代理自主执行
|
|
107
|
-
- **本地优先** — 基于 SQLite,数据存储在 `~/.idea-manager/`
|
|
108
|
-
|
|
109
|
-
## 技术栈
|
|
110
|
-
|
|
111
|
-
| 领域 | 技术 |
|
|
112
|
-
|------|------|
|
|
113
|
-
| 前端 | Next.js 15, React 19, TypeScript, Tailwind CSS 4 |
|
|
114
|
-
| 后端 | Next.js API Routes |
|
|
115
|
-
| 数据库 | SQLite (better-sqlite3) |
|
|
116
|
-
| AI | Claude CLI(基于订阅,无需 API 密钥) |
|
|
117
|
-
| MCP | Model Context Protocol (stdio) |
|
|
118
|
-
| CLI | Commander.js |
|
|
31
|
+
- **多代理支持** — 按项目选择 Claude / Gemini / Codex
|
|
32
|
+
- **跨PC同步** — 通过Git仓库同步数据
|
|
33
|
+
- **MCP服务器** — 向外部AI代理公开任务
|
|
34
|
+
- **三面板布局** — 头脑风暴 | 项目树 | 任务详情
|
|
35
|
+
- **标签导航** — 同时打开多个项目
|
|
36
|
+
- **文件树** — 浏览关联的项目目录
|
|
37
|
+
- **AI聊天** — 按任务对话改进工作
|
|
38
|
+
- **本地优先** — SQLite (sql.js),无原生依赖
|
|
119
39
|
|
|
120
|
-
##
|
|
40
|
+
## 要求
|
|
121
41
|
|
|
122
42
|
- **Node.js** 18+
|
|
123
|
-
- **
|
|
43
|
+
- **AI CLI**(可选)— Claude / Gemini / Codex CLI
|
|
124
44
|
|
|
125
45
|
## 许可证
|
|
126
46
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "idea-manager",
|
|
3
|
-
"version": "1.1.
|
|
3
|
+
"version": "1.1.6",
|
|
4
4
|
"description": "Turn free-form brainstorming into structured task trees with AI-generated prompts. Built-in MCP Server for autonomous AI agent execution. Local-first with SQLite, cross-PC sync via Git.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"brainstorm",
|