project-compass 4.1.6 → 4.1.7
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.md +26 -13
- package/package.json +1 -1
- package/src/cli.js +11 -0
package/README.md
CHANGED
|
@@ -14,14 +14,29 @@ npm install -g project-compass
|
|
|
14
14
|
- **NPM**: [npmjs.com/package/project-compass](https://www.npmjs.com/package/project-compass)
|
|
15
15
|
- **GitHub**: [github.com/CrimsonDevil333333/project-compass](https://github.com/CrimsonDevil333333/project-compass)
|
|
16
16
|
|
|
17
|
+
## 🌌 The Navigator
|
|
17
18
|

|
|
18
19
|
|
|
19
|
-
|
|
20
|
+
### 🌟 Premium Features
|
|
20
21
|
|
|
21
22
|
### 🌌 The Navigator (Main Interface)
|
|
22
23
|
- **Automatic Discovery**: Instantly identifies **Node.js, Python, Rust, Go, Java, PHP, Ruby, .NET, and Shell/Make**.
|
|
23
|
-
- **Paginated Control**: Optimized for massive workspaces.
|
|
24
|
-
- **Configurable UI**: Customize your view with `maxVisibleProjects`
|
|
24
|
+
- **Paginated Control**: Optimized for massive workspaces. View projects in clean, manageable pages with **Page Up / Page Down** support.
|
|
25
|
+
- **Configurable UI**: Customize your view with `maxVisibleProjects` and toggleable Art Boards and Help Cards.
|
|
26
|
+
|
|
27
|
+
### 🛰️ Orbit Task Manager (`Shift+T`)
|
|
28
|
+

|
|
29
|
+
- **Background Orchestration**: Keep tasks running while you navigate.
|
|
30
|
+
- **Process Management**: Kill (`Shift+K`) or Rename (`Shift+R`) background tasks on the fly.
|
|
31
|
+
|
|
32
|
+
### 📦 Package Registry (`Shift+P`)
|
|
33
|
+

|
|
34
|
+
- **Native Logic**: Automatically uses your project's preferred package manager (**npm, pnpm, yarn, bun, pip, cargo, composer, dotnet**).
|
|
35
|
+
- **Internal Switcher**: Quick-swap between detected projects directly inside the registry.
|
|
36
|
+
|
|
37
|
+
### 🏗️ Project Architect (`Shift+N`)
|
|
38
|
+

|
|
39
|
+
- **Modern Templates**: Scaffold high-performance projects with built-in support for **Bun, Next.js, Vite, Rust, and Django**.
|
|
25
40
|
|
|
26
41
|
### 🤖 AI Horizon (`Shift+O` or `0`)
|
|
27
42
|
- **Agentic Intelligence**: Real-world integration with **OpenRouter, Gemini, Claude, and Ollama**.
|
|
@@ -32,15 +47,9 @@ npm install -g project-compass
|
|
|
32
47
|
- **Manual Port Mapping**: Directly assign specific ports to projects. Config is saved persistently to prevent conflicts.
|
|
33
48
|
- **Metadata Awareness**: AI Horizon uses your manual port settings to suggest smarter deployment scripts.
|
|
34
49
|
|
|
35
|
-
###
|
|
36
|
-
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
### 📦 Package Registry (`Shift+P`)
|
|
40
|
-
- **Context-Aware Management**: Automatically detects **npm, pnpm, yarn, bun, pip, cargo, composer, and dotnet**.
|
|
41
|
-
|
|
42
|
-
### 🏗️ Project Architect (`Shift+N`)
|
|
43
|
-
- **Rapid Scaffolding**: Create new projects from scratch using industry-standard templates.
|
|
50
|
+
### 🎨 Omni-Studio & Art Board
|
|
51
|
+

|
|
52
|
+

|
|
44
53
|
|
|
45
54
|
## ⌨️ Command Reference
|
|
46
55
|
|
|
@@ -55,12 +64,16 @@ npm install -g project-compass
|
|
|
55
64
|
| `Shift + O` | **AI Horizon** Dashboard |
|
|
56
65
|
| `Shift + T` | **Orbit**: Task Manager |
|
|
57
66
|
| `Shift + P` | **Registry**: Package Manager |
|
|
67
|
+
| `Shift + A` | **Studio**: Environment Health |
|
|
68
|
+
| `Shift + B` | Toggle **Art Board** visibility |
|
|
69
|
+
| `Shift + H` | Toggle **Help Cards** |
|
|
70
|
+
| `Shift + S` | Toggle **Structure Guide** |
|
|
58
71
|
| `Shift + Q` | **Quit** (with terminal clear) |
|
|
59
72
|
|
|
60
73
|
## ⚙️ Configuration
|
|
61
74
|
|
|
62
75
|
Edit `~/.project-compass/config.json` to customize:
|
|
63
|
-
- `maxVisibleProjects`: How many rows per page.
|
|
76
|
+
- `maxVisibleProjects`: How many rows per page (default: 3).
|
|
64
77
|
- `aiToken / aiModel`: Your intelligence credentials.
|
|
65
78
|
|
|
66
79
|
---
|
package/package.json
CHANGED
package/src/cli.js
CHANGED
|
@@ -294,6 +294,17 @@ function Compass({rootPath, initialView = 'navigator'}) {
|
|
|
294
294
|
}, [tasks, activeTaskId, addLogToTask]);
|
|
295
295
|
|
|
296
296
|
useInput((input, key) => {
|
|
297
|
+
|
|
298
|
+
if (key.shift && (input === 'R' || input === 'r')) {
|
|
299
|
+
if (viewMode === 'detail' && selectedProject) {
|
|
300
|
+
setPortConfigMode(true);
|
|
301
|
+
const currentPort = config.projectMeta?.[selectedProject.path]?.port || '3000';
|
|
302
|
+
setCustomInput(String(currentPort));
|
|
303
|
+
setCustomCursor(String(currentPort).length);
|
|
304
|
+
return;
|
|
305
|
+
}
|
|
306
|
+
}
|
|
307
|
+
|
|
297
308
|
if (quitConfirm) {
|
|
298
309
|
if (input?.toLowerCase() === 'y') { killAllTasks(); process.stdout.write('\x1b[2J\x1b[0;0H'); exit(); return; }
|
|
299
310
|
if (input?.toLowerCase() === 'n' || key.escape) { setQuitConfirm(false); return; }
|