project-compass 3.6.3 → 3.6.5

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.
Files changed (2) hide show
  1. package/README.md +35 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -28,6 +28,7 @@ npm install -g project-compass
28
28
  - **Background Orchestration**: Keep tasks running while you navigate the rest of your workspace.
29
29
  - **Process Management**: Monitor status (Running, Finished, Failed, Killed) and forcefully terminate processes with `Shift+K`.
30
30
  - **Task Identity**: Rename tasks on the fly with `Shift+R` to keep your workspace organized.
31
+ - **Cross-Platform Safety**: Automatically handles process signaling for both Unix (SIGKILL) and Windows (taskkill) to ensure clean exits.
31
32
 
32
33
  ![Task Manager](https://raw.githubusercontent.com/CrimsonDevil333333/project-compass/master/assets/screenshots/taskmanager.jpg)
33
34
 
@@ -72,6 +73,40 @@ npm install -g project-compass
72
73
 
73
74
  ![Exit Confirmation](https://raw.githubusercontent.com/CrimsonDevil333333/project-compass/master/assets/screenshots/exit-confirm.jpg)
74
75
 
76
+ ## ⚙️ Configuration & Customization
77
+
78
+ Project Compass is designed to be personalized. All settings and custom commands are stored in a local JSON file.
79
+
80
+ - **Linux/macOS**: `~/.project-compass/config.json`
81
+ - **Windows**: `C:\Users\<YourUser>\.project-compass\config.json`
82
+
83
+ ### 🛠️ Adding Custom Commands
84
+ You can add your own project-specific commands directly within the app by pressing **Shift+C** in the Detail View. Use the format `Label|Command` (e.g., `Deploy|npm run deploy`).
85
+
86
+ ### 📁 Manual Config Structure
87
+ If you prefer manual editing, the `config.json` follows this structure:
88
+
89
+ ```json
90
+ {
91
+ "showArtBoard": true,
92
+ "showHelpCards": false,
93
+ "showStructureGuide": false,
94
+ "customCommands": {
95
+ "/path/to/your/project": [
96
+ {
97
+ "label": "Build Production",
98
+ "command": ["npm", "run", "build", "--prod"]
99
+ }
100
+ ]
101
+ }
102
+ }
103
+ ```
104
+
105
+ - `showArtBoard/HelpCards/Structure`: Persistence for your UI visibility preferences.
106
+ - `customCommands`: A map of absolute project paths to arrays of command objects.
107
+
108
+ ---
109
+
75
110
  ## 🚀 Vision
76
111
  Project Compass is designed to be the "Last Terminal Tool" you ever need to open. It bridges the gap between raw CLI commands and full IDEs, giving you a professional, reactive cockpit for all your development work.
77
112
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "project-compass",
3
- "version": "3.6.3",
3
+ "version": "3.6.5",
4
4
  "description": "Futuristic project navigator and runner for Node, Python, Rust, and Go",
5
5
  "main": "src/cli.js",
6
6
  "bin": {