@abyrd9/harbor-cli 2.2.0 → 2.3.1

package/dist/index.js

@@ -327,13 +327,15 @@ PREREQUISITES: harbor.json or harbor config in package.json.
 EXAMPLES:
   harbor launch            # Start and attach to tmux session
   harbor launch -d         # Start in background (headless mode)
-  harbor launch --headless # Same as -d`)
+  harbor launch --headless # Same as -d
+  harbor launch --name my-session # Use custom session name`)
     .option('-d, --detach', 'Run in background without attaching (headless mode). Use "anchor" to attach later.')
     .option('--headless', 'Alias for --detach')
+    .option('--name <name>', 'Override tmux session name from config')
     .action(async (options) => {
     try {
         await checkDependencies();
-        await runServices({ detach: options.detach || options.headless });
+        await runServices({ detach: options.detach || options.headless, name: options.name });
     }
     catch (err) {
         console.log('❌ Error:', err instanceof Error ? err.message : 'Unknown error');
@@ -353,13 +355,15 @@ WHAT IT DOES:
 
 PREREQUISITES: Services must be running (started with 'harbor launch').
 
-EXAMPLE:
-  harbor launch -d   # Start in background
-  harbor anchor      # Attach to see the services`)
-    .action(async () => {
+EXAMPLES:
+  harbor launch -d               # Start in background
+  harbor anchor                  # Attach to default session
+  harbor anchor --name my-app    # Attach to a specific named session`)
+    .option('--name <name>', 'Specify which tmux session to attach to (defaults to config sessionName or "harbor")')
+    .action(async (options) => {
     try {
         const config = await readHarborConfig();
-        const sessionName = config.sessionName || 'harbor';
+        const sessionName = options.name || config.sessionName || 'harbor';
         // Check if session exists
         const checkSession = spawn('tmux', ['has-session', '-t', sessionName], {
             stdio: 'pipe',
@@ -400,12 +404,14 @@ WHAT IT DOES:
 
 SAFE TO RUN: If no session is running, it simply reports that and exits cleanly.
 
-EXAMPLE:
-  harbor scuttle   # Stop all services`)
-    .action(async () => {
+EXAMPLES:
+  harbor scuttle                # Stop default session
+  harbor scuttle --name my-app  # Stop a specific named session`)
+    .option('--name <name>', 'Specify which tmux session to stop (defaults to config sessionName or "harbor")')
+    .action(async (options) => {
     try {
         const config = await readHarborConfig();
-        const sessionName = config.sessionName || 'harbor';
+        const sessionName = options.name || config.sessionName || 'harbor';
         // Check if session exists
         const checkSession = spawn('tmux', ['has-session', '-t', sessionName], {
             stdio: 'pipe',
@@ -458,12 +464,14 @@ OUTPUT EXAMPLE:
 
 SAFE TO RUN: Works whether services are running or not.
 
-EXAMPLE:
-  harbor bearings   # Check what's running`)
-    .action(async () => {
+EXAMPLES:
+  harbor bearings                # Check default session
+  harbor bearings --name my-app  # Check a specific named session`)
+    .option('--name <name>', 'Specify which tmux session to check (defaults to config sessionName or "harbor")')
+    .action(async (options) => {
     try {
         const config = await readHarborConfig();
-        const sessionName = config.sessionName || 'harbor';
+        const sessionName = options.name || config.sessionName || 'harbor';
         // Check if session exists
         const checkSession = spawn('tmux', ['has-session', '-t', sessionName], {
             stdio: 'pipe',
@@ -815,6 +823,7 @@ async function runServices(options = {}) {
     const env = {
         ...process.env,
         HARBOR_DETACH: options.detach ? '1' : '0',
+        HARBOR_SESSION_NAME: options.name || '',
     };
     const command = spawn('bash', [scriptPath], {
         stdio: 'inherit', // This will pipe stdin/stdout/stderr to the parent process

package/harbor.package-json.schema.json

@@ -96,3 +96,4 @@
 
 
 
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abyrd9/harbor-cli",
-  "version": "2.2.0",
+  "version": "2.3.1",
   "description": "A CLI tool for orchestrating local development services in a tmux session. Perfect for microservices and polyglot projects with automatic service discovery and before/after script support.",
   "type": "module",
   "bin": {

package/scripts/dev.sh

@@ -11,8 +11,8 @@ get_harbor_config() {
     fi
 }
 
-# Get session name from config or use default
-session_name=$(get_harbor_config | jq -r '.sessionName // "harbor"')
+# Get session name from env, config, or use default
+session_name="${HARBOR_SESSION_NAME:-$(get_harbor_config | jq -r '.sessionName // "harbor"')}"
 
 # Check if the session already exists and kill it
 if tmux has-session -t "$session_name" 2>/dev/null; then