idea-manager 0.7.7 → 0.7.8
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 +1 -1
- package/README.ko.md +127 -0
- package/README.md +57 -57
- package/README.zh.md +1 -1
- package/package.json +1 -1
- package/README.en.md +0 -127
package/README.ja.md
CHANGED
package/README.ko.md
ADDED
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
# IM (Idea Manager)
|
|
2
|
+
|
|
3
|
+
[English](README.md) | **한국어** | [日本語](README.ja.md) | [中文](README.zh.md)
|
|
4
|
+
|
|
5
|
+
> 아이디어에서 실행 가능한 프롬프트까지, 멀티 프로젝트 워크플로우 매니저
|
|
6
|
+
|
|
7
|
+
여러 프로젝트를 동시에 진행하는 개발자를 위한 태스크 관리 도구입니다. 아이디어를 서브 프로젝트와 태스크로 조직화하고, 각 태스크별 프롬프트를 정제하여 Claude Code 등 AI 에이전트에게 전달할 수 있습니다. MCP Server를 내장하고 있어 AI 에이전트가 자율적으로 태스크를 가져가 실행할 수 있습니다.
|
|
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
|
+
## 설치
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
npm install -g idea-manager
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
## 사용법
|
|
44
|
+
|
|
45
|
+
### 웹 UI 실행
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
im start
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
`http://localhost:3456`에서 웹 UI가 열립니다.
|
|
52
|
+
|
|
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
|
+
```
|
|
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` | 태스크 완료 보고 |
|
|
93
|
+
|
|
94
|
+
## 주요 기능
|
|
95
|
+
|
|
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
|
+
| 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 키 불필요) |
|
|
117
|
+
| MCP | Model Context Protocol (stdio) |
|
|
118
|
+
| CLI | Commander.js |
|
|
119
|
+
|
|
120
|
+
## 요구 사항
|
|
121
|
+
|
|
122
|
+
- **Node.js** 18+
|
|
123
|
+
- **Claude CLI** — AI 채팅/다듬기 기능 사용 시 필요 (Claude 구독 필요). 없어도 태스크 관리, 프롬프트 작성 등 기본 기능은 정상 동작합니다.
|
|
124
|
+
|
|
125
|
+
## 라이선스
|
|
126
|
+
|
|
127
|
+
MIT
|
package/README.md
CHANGED
|
@@ -1,67 +1,67 @@
|
|
|
1
1
|
# IM (Idea Manager)
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**English** | [한국어](README.ko.md) | [日本語](README.ja.md) | [中文](README.zh.md)
|
|
4
4
|
|
|
5
|
-
>
|
|
5
|
+
> From ideas to executable prompts — a multi-project workflow manager
|
|
6
6
|
|
|
7
|
-
|
|
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.
|
|
8
8
|
|
|
9
9
|
|
|
10
10
|
|
|
11
|
-
##
|
|
11
|
+
## Core Workflow
|
|
12
12
|
|
|
13
13
|
```
|
|
14
|
-
|
|
14
|
+
Brainstorming → Organize into Sub-projects/Tasks → Refine Prompts → Execute via MCP
|
|
15
15
|
```
|
|
16
16
|
|
|
17
|
-
###
|
|
17
|
+
### Hierarchy
|
|
18
18
|
|
|
19
19
|
```
|
|
20
|
-
|
|
21
|
-
├──
|
|
22
|
-
│ ├──
|
|
23
|
-
│ ├──
|
|
24
|
-
│ └──
|
|
25
|
-
└──
|
|
26
|
-
├──
|
|
27
|
-
└──
|
|
20
|
+
Project
|
|
21
|
+
├── Sub-project A
|
|
22
|
+
│ ├── Task 1 → Prompt
|
|
23
|
+
│ ├── Task 2 → Prompt
|
|
24
|
+
│ └── Task 3 → Prompt
|
|
25
|
+
└── Sub-project B
|
|
26
|
+
├── Task 4 → Prompt
|
|
27
|
+
└── Task 5 → Prompt
|
|
28
28
|
```
|
|
29
29
|
|
|
30
|
-
###
|
|
30
|
+
### Task Status Flow
|
|
31
31
|
|
|
32
32
|
```
|
|
33
33
|
💡 Idea → ✏️ Writing → 🚀 Submitted → 🧪 Testing → ✅ Done
|
|
34
34
|
🔴 Problem
|
|
35
35
|
```
|
|
36
36
|
|
|
37
|
-
##
|
|
37
|
+
## Installation
|
|
38
38
|
|
|
39
39
|
```bash
|
|
40
40
|
npm install -g idea-manager
|
|
41
41
|
```
|
|
42
42
|
|
|
43
|
-
##
|
|
43
|
+
## Usage
|
|
44
44
|
|
|
45
|
-
###
|
|
45
|
+
### Start Web UI
|
|
46
46
|
|
|
47
47
|
```bash
|
|
48
48
|
im start
|
|
49
49
|
```
|
|
50
50
|
|
|
51
|
-
`http://localhost:3456
|
|
51
|
+
Opens the web UI at `http://localhost:3456`.
|
|
52
52
|
|
|
53
53
|
```bash
|
|
54
|
-
#
|
|
54
|
+
# Custom port
|
|
55
55
|
im start -p 4000
|
|
56
56
|
```
|
|
57
57
|
|
|
58
|
-
### MCP Server
|
|
58
|
+
### Start MCP Server
|
|
59
59
|
|
|
60
60
|
```bash
|
|
61
61
|
im mcp
|
|
62
62
|
```
|
|
63
63
|
|
|
64
|
-
#### Claude Desktop
|
|
64
|
+
#### Claude Desktop Configuration (claude_desktop_config.json)
|
|
65
65
|
|
|
66
66
|
```json
|
|
67
67
|
{
|
|
@@ -74,54 +74,54 @@ im mcp
|
|
|
74
74
|
}
|
|
75
75
|
```
|
|
76
76
|
|
|
77
|
-
#### Claude Code
|
|
77
|
+
#### Claude Code Configuration
|
|
78
78
|
|
|
79
79
|
```bash
|
|
80
80
|
claude mcp add idea-manager -- npx -y idea-manager mcp
|
|
81
81
|
```
|
|
82
82
|
|
|
83
|
-
### MCP
|
|
84
|
-
|
|
85
|
-
|
|
|
86
|
-
|
|
87
|
-
| `list-projects` |
|
|
88
|
-
| `get-project-context` |
|
|
89
|
-
| `get-next-task` |
|
|
90
|
-
| `get-task-prompt` |
|
|
91
|
-
| `update-status` |
|
|
92
|
-
| `report-completion` |
|
|
93
|
-
|
|
94
|
-
##
|
|
95
|
-
|
|
96
|
-
-
|
|
97
|
-
- **3
|
|
98
|
-
-
|
|
99
|
-
-
|
|
100
|
-
-
|
|
101
|
-
- **AI
|
|
102
|
-
- **3
|
|
103
|
-
-
|
|
104
|
-
- **PWA
|
|
105
|
-
- **Watch
|
|
106
|
-
- **MCP Server
|
|
107
|
-
-
|
|
108
|
-
|
|
109
|
-
##
|
|
110
|
-
|
|
111
|
-
|
|
|
112
|
-
|
|
83
|
+
### MCP Tools
|
|
84
|
+
|
|
85
|
+
| Tool | Description |
|
|
86
|
+
|------|-------------|
|
|
87
|
+
| `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/`
|
|
108
|
+
|
|
109
|
+
## Tech Stack
|
|
110
|
+
|
|
111
|
+
| Area | Technology |
|
|
112
|
+
|------|------------|
|
|
113
113
|
| Frontend | Next.js 15, React 19, TypeScript, Tailwind CSS 4 |
|
|
114
114
|
| Backend | Next.js API Routes |
|
|
115
115
|
| Database | SQLite (better-sqlite3) |
|
|
116
|
-
| AI | Claude CLI (
|
|
116
|
+
| AI | Claude CLI (subscription-based, no API key needed) |
|
|
117
117
|
| MCP | Model Context Protocol (stdio) |
|
|
118
118
|
| CLI | Commander.js |
|
|
119
119
|
|
|
120
|
-
##
|
|
120
|
+
## Requirements
|
|
121
121
|
|
|
122
122
|
- **Node.js** 18+
|
|
123
|
-
- **Claude CLI** —
|
|
123
|
+
- **Claude CLI** — Required for AI chat/refinement features (Claude subscription needed). Core features like task management and prompt editing work without it.
|
|
124
124
|
|
|
125
|
-
##
|
|
125
|
+
## License
|
|
126
126
|
|
|
127
127
|
MIT
|
package/README.zh.md
CHANGED
package/package.json
CHANGED
package/README.en.md
DELETED
|
@@ -1,127 +0,0 @@
|
|
|
1
|
-
# IM (Idea Manager)
|
|
2
|
-
|
|
3
|
-
[한국어](README.md) | **English** | [日本語](README.ja.md) | [中文](README.zh.md)
|
|
4
|
-
|
|
5
|
-
> From ideas to executable prompts — a multi-project workflow manager
|
|
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.
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
## Core Workflow
|
|
12
|
-
|
|
13
|
-
```
|
|
14
|
-
Brainstorming → Organize into Sub-projects/Tasks → Refine Prompts → Execute via MCP
|
|
15
|
-
```
|
|
16
|
-
|
|
17
|
-
### Hierarchy
|
|
18
|
-
|
|
19
|
-
```
|
|
20
|
-
Project
|
|
21
|
-
├── Sub-project A
|
|
22
|
-
│ ├── Task 1 → Prompt
|
|
23
|
-
│ ├── Task 2 → Prompt
|
|
24
|
-
│ └── Task 3 → Prompt
|
|
25
|
-
└── Sub-project B
|
|
26
|
-
├── Task 4 → Prompt
|
|
27
|
-
└── Task 5 → Prompt
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
### Task Status Flow
|
|
31
|
-
|
|
32
|
-
```
|
|
33
|
-
💡 Idea → ✏️ Writing → 🚀 Submitted → 🧪 Testing → ✅ Done
|
|
34
|
-
🔴 Problem
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
## Installation
|
|
38
|
-
|
|
39
|
-
```bash
|
|
40
|
-
npm install -g idea-manager
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
## Usage
|
|
44
|
-
|
|
45
|
-
### Start Web UI
|
|
46
|
-
|
|
47
|
-
```bash
|
|
48
|
-
im start
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
Opens the web UI at `http://localhost:3456`.
|
|
52
|
-
|
|
53
|
-
```bash
|
|
54
|
-
# Custom port
|
|
55
|
-
im start -p 4000
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
### Start MCP Server
|
|
59
|
-
|
|
60
|
-
```bash
|
|
61
|
-
im mcp
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
#### Claude Desktop Configuration (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 Configuration
|
|
78
|
-
|
|
79
|
-
```bash
|
|
80
|
-
claude mcp add idea-manager -- npx -y idea-manager mcp
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
### MCP Tools
|
|
84
|
-
|
|
85
|
-
| Tool | Description |
|
|
86
|
-
|------|-------------|
|
|
87
|
-
| `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/`
|
|
108
|
-
|
|
109
|
-
## Tech Stack
|
|
110
|
-
|
|
111
|
-
| Area | Technology |
|
|
112
|
-
|------|------------|
|
|
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 (subscription-based, no API key needed) |
|
|
117
|
-
| MCP | Model Context Protocol (stdio) |
|
|
118
|
-
| CLI | Commander.js |
|
|
119
|
-
|
|
120
|
-
## Requirements
|
|
121
|
-
|
|
122
|
-
- **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.
|
|
124
|
-
|
|
125
|
-
## License
|
|
126
|
-
|
|
127
|
-
MIT
|