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 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
- 複数のプロジェクトを同時に進めるデベロッパー向けのタスク管理ツールです。アイデアをサブプロジェクトとタスクに整理し、各タスクごとにプロンプトを磨いてClaude CodeなどのAIエージェントに渡すことができます。MCP Serverを内蔵しており、AIエージェントが自律的にタスクを取得して実行できます。
7
+ 開発者向けのローカルファーストタスク管理ツール。アイデアをサブプロジェクトとタスクに整理し、各タスクにプロンプトを作成してAIエージェントに渡せます。内蔵MCPサーバーでAIエージェントの自律実行をサポート。Git経由のPC間同期。
8
8
 
9
- ![IM Workspace](docs/screenshot.png)
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
- `http://localhost:3456`でWeb UIが開きます。
16
+ ネイティブアプリのような独立ウィンドウで開きます(Chrome/Edge `--app`モード)。初回実行時に自動ビルドされます。
52
17
 
53
- ```bash
54
- # ポート変更
55
- im start -p 4000
56
- ```
18
+ ## CLIコマンド
57
19
 
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
- ```
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
- - **タブベースのマルチプロジェクト**ブラウザ/IDEのように複数プロジェクトをタブで同時に開き、タブ切替時に状態を保持
97
- - **3パネルワークスペース**ブレインストーミング | プロジェクトツリー | タスク詳細、パネル間ドラッグでサイズ調整
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/`に保存
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
- - **Claude CLI** AIチャット/磨き上げ機能に必要(Claudeサブスクリプション必要)。なくてもタスク管理やプロンプト作成などの基本機能は正常に動作します。
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
- 여러 프로젝트를 동시에 진행하는 개발자를 위한 태스크 관리 도구입니다. 아이디어를 서브 프로젝트와 태스크로 조직화하고,태스크별 프롬프트를 정제하여 Claude Code 등 AI 에이전트에게 전달할 수 있습니다. MCP Server를 내장하고 있어 AI 에이전트가 자율적으로 태스크를 가져가 실행할 있습니다.
7
+ 개발자를 위한 로컬 기반 태스크 관리 도구. 아이디어를 서브 프로젝트와 태스크로 정리하고,태스크에 프롬프트를 작성한 AI 에이전트에게 넘길 수 있습니다. 내장 MCP 서버로 AI 에이전트의 자율 실행을 지원합니다. Git을 통한 PC 동기화.
8
8
 
9
- ![IM Workspace](docs/screenshot.png)
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
- 브레인스토밍 → 서브 프로젝트/태스크 조직화 → 프롬프트 정제 MCP로 AI 실행
21
+ 브레인스토밍 → 서브 프로젝트 / 태스크 → 프롬프트 → AI 에이전트 실행
15
22
  ```
16
23
 
17
24
  ### 계층 구조
@@ -30,38 +37,58 @@
30
37
  ### 태스크 상태 흐름
31
38
 
32
39
  ```
33
- 💡 Idea → ✏️ Writing → 🚀 Submitted → 🧪 Testing → ✅ Done
34
- 🔴 Problem
40
+ 💡 아이디어 → ✏️ 작성중 → 🚀 제출 → 🧪 테스트 → ✅ 완료
41
+ 🔴 문제
35
42
  ```
36
43
 
37
- ## 설치
44
+ ## CLI 명령어
38
45
 
39
- ```bash
40
- npm install -g idea-manager
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
- ### UI 실행
59
+ ### 멀티 에이전트 지원
46
60
 
47
- ```bash
48
- im start
49
- ```
61
+ 프로젝트별로 AI CLI를 선택할 수 있습니다:
50
62
 
51
- `http://localhost:3456`에서 UI가 열립니다.
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
- ```bash
54
- # 포트 변경
55
- im start -p 4000
56
- ```
69
+ 프로젝트 헤더의 드롭다운에서 선택. Watch 모드와 AI Chat에 적용됩니다.
70
+
71
+ ### PC 동기화
57
72
 
58
- ### MCP Server 실행
73
+ Git 리포지토리를 통해 여러 PC에서 데이터를 동기화합니다.
59
74
 
60
75
  ```bash
61
- im mcp
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
- #### Claude Desktop 설정 (claude_desktop_config.json)
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
- #### Claude Code 설정
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
- ### MCP 제공 도구
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
- - **탭 기반 멀티 프로젝트** 브라우저/IDE처럼 여러 프로젝트를 탭으로 동시에 열기, 탭 전환 시 상태 보존
97
- - **3-패널 워크스페이스**브레인스토밍 | 프로젝트 트리 | 태스크 상세, 패널 간 드래그로 크기 조절
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
- | Frontend | Next.js 15, React 19, TypeScript, Tailwind CSS 4 |
114
- | Backend | Next.js API Routes |
115
- | Database | SQLite (better-sqlite3) |
116
- | AI | Claude CLI (구독 기반, API 불필요) |
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
- - **Claude CLI** — AI 채팅/다듬기 기능 사용 필요 (Claude 구독 필요). 없어도 태스크 관리, 프롬프트 작성 기본 기능은 정상 동작합니다.
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
- > From ideas to executable prompts a multi-project workflow manager
5
+ > Turn free-form brainstorming into structured task trees with AI-generated prompts.
6
6
 
7
- A task management tool for developers juggling multiple projects simultaneously. Organize ideas into sub-projects and tasks, refine prompts for each task, and hand them off to AI agents like Claude Code. With a built-in MCP Server, AI agents can autonomously pick up and execute tasks.
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
- ![IM Workspace](docs/screenshot.png)
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 → Organize into Sub-projects/Tasks → Refine Prompts → Execute via MCP
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
- ## Installation
44
+ ## CLI Commands
38
45
 
39
- ```bash
40
- npm install -g idea-manager
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
- ## Usage
57
+ ## Features
44
58
 
45
- ### Start Web UI
59
+ ### Multi-Agent Support
46
60
 
47
- ```bash
48
- im start
49
- ```
61
+ Choose your AI CLI per project:
50
62
 
51
- Opens the web UI at `http://localhost:3456`.
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
- ```bash
54
- # Custom port
55
- im start -p 4000
56
- ```
69
+ Select from the project header dropdown. Used for Watch mode and AI Chat.
70
+
71
+ ### Cross-PC Sync
57
72
 
58
- ### Start MCP Server
73
+ Sync your data across machines via a private Git repository.
59
74
 
60
75
  ```bash
61
- im mcp
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
- #### Claude Desktop Configuration (claude_desktop_config.json)
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
- #### Claude Code Configuration
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
- ### MCP Tools
110
+ #### MCP Tools
84
111
 
85
112
  | Tool | Description |
86
113
  |------|-------------|
87
114
  | `list-projects` | List all projects |
88
- | `get-project-context` | Get full sub-project + task tree |
89
- | `get-next-task` | Get next task to execute (status=submitted) |
90
- | `get-task-prompt` | Get prompt for a specific task |
91
- | `update-status` | Change task status (idea/writing/submitted/testing/done/problem) |
92
- | `report-completion` | Report task completion |
93
-
94
- ## Key Features
95
-
96
- - **Tab-based Multi-project** Open multiple projects in tabs like a browser/IDE, state preserved on tab switch
97
- - **3-Panel Workspace** — Brainstorming | Project Tree | Task Detail, drag to resize panels
98
- - **Tree-structured Projects** — Tasks displayed hierarchically under sub-projects
99
- - **Brainstorming Panel** — Free-form notes, collapsible
100
- - **Prompt Editor** Write/edit/copy prompts per task, AI refinement
101
- - **AI Chat** Per-task AI conversations to refine prompts
102
- - **3-Tab Dashboard** — Active / All / Today
103
- - **Keyboard Shortcuts** — Ctrl+Tab/Ctrl+Shift+Tab for tab navigation, B: toggle brainstorm, N: add sub-project, T: add task, Cmd+1~6: change status
104
- - **PWA Support** — Install as an app for a standalone window experience
105
- - **Watch Mode** — Auto-execute submitted tasks via Claude CLI with real-time progress
106
- - **Built-in MCP Server** — Supports autonomous AI agent execution
107
- - **Local-first** — SQLite-based, data stored in `~/.idea-manager/`
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 15, React 19, TypeScript, Tailwind CSS 4 |
153
+ | Frontend | Next.js 16, React 19, TypeScript, Tailwind CSS 4 |
114
154
  | Backend | Next.js API Routes |
115
- | Database | SQLite (better-sqlite3) |
116
- | AI | Claude CLI (subscription-based, no API key needed) |
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
- - **Claude CLI** — Required for AI chat/refinement features (Claude subscription needed). Core features like task management and prompt editing work without it.
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
- 专为同时管理多个项目的开发者设计的任务管理工具。将创意组织成子项目和任务,为每个任务精炼提示词,并交给 Claude Code 等 AI 代理执行。内置 MCP Server,AI 代理可以自主获取并执行任务。
7
+ 面向开发者的本地优先任务管理工具。将想法组织成子项目和任务,为每个任务编写提示词,然后交给AI代理执行。内置MCP服务器支持AI代理自主执行。通过Git实现跨PC同步。
8
8
 
9
- ![IM Workspace](docs/screenshot.png)
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
- `http://localhost:3456` 打开 Web UI。
16
+ 以原生应用般的独立窗口打开(Chrome/Edge `--app` 模式)。首次运行时自动构建。
52
17
 
53
- ```bash
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
- #### Claude Code 配置
78
-
79
- ```bash
80
- claude mcp add idea-manager -- npx -y idea-manager mcp
81
- ```
82
-
83
- ### MCP 工具
84
-
85
- | 工具 | 描述 |
20
+ | 命令 | 说明 |
86
21
  |------|------|
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` | 报告任务完成 |
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
- - **标签式多项目**像浏览器/IDE一样用标签页同时打开多个项目,切换标签时保持状态
97
- - **三栏工作区**头脑风暴 | 项目树 | 任务详情,拖拽调整面板大小
98
- - **树形项目结构**任务在子项目下层级展示
99
- - **头脑风暴面板**自由格式笔记,可折叠/展开
100
- - **提示词编辑器**按任务编写/编辑/复制提示词,AI 润色
101
- - **AI 聊天** 按任务进行 AI 对话以细化提示词
102
- - **三标签仪表盘**进行中 / 全部 / 今日待办
103
- - **键盘快捷键**Ctrl+Tab/Ctrl+Shift+Tab 切换标签,B:切换头脑风暴,N:添加子项目,T:添加任务,Cmd+1~6:更改状态
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
- - **Claude CLI** AI 聊天/润色功能需要(需要 Claude 订阅)。即使没有,任务管理和提示词编写等基本功能也可正常使用。
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.5",
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",