@siamriaz/octomux 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Octomux Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,272 @@
+# 🐙 octomux (`omx`)
+
+[![npm version](https://img.shields.io/badge/npm-v1.0.0-cb3837.svg?style=flat-square)](https://www.npmjs.com/package/@siamriaz/octomux)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.5-blue.svg?style=flat-square)](https://www.typescriptlang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![Cross-Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-brightgreen.svg?style=flat-square)]()
+[![Vitest](https://img.shields.io/badge/Tests-Vitest%2018%2F18%20Passing-729B1B.svg?style=flat-square)](https://vitest.dev/)
+
+> **Enterprise-grade, cross-platform GitHub multi-account multiplexer, SSH identity manager, and smart repository clone CLI.**
+
+Seamlessly manage multiple GitHub accounts (Work, Personal, Client, Open Source) with zero SSH collisions and zero commit identity mistakes.
+
+---
+
+## ✨ Features
+
+- 🔑 **Multi-Account & SSH Engine**: Add, edit, list, and switch between unlimited GitHub accounts with automated Ed25519/RSA SSH key generation.
+- 🔍 **Automatic SSH Key Discovery**: Automatically discovers existing keys in `~/.ssh/` and imports them with one click.
+- 🛡️ **Zero-Data-Loss SSH Sync**: Safely syncs `~/.ssh/config` using isolated block delimiters (`# === OCTOMUX MANAGED HOSTS ===`) with automated backups (`.bak`).
+- 🔄 **Local & Global Identity Switcher**: Instantly toggle `user.name`, `user.email`, and `core.sshCommand` globally or per repository.
+- 🔗 **Remote Origin Helper**: `omx remote` or `omx origin` binds existing local repositories to dedicated SSH aliases with automated author and SSH key configuration.
+- 📦 **Smart Clone**: `omx clone owner/repo` automatically clones using the account's dedicated SSH Host alias and binds repository-local Git identities upon completion.
+- 💻 **Cross-Platform Compatibility**: Native support for **Windows** (PowerShell, CMD, Git Bash, OpenSSH), **macOS**, and **Linux** with POSIX path normalization and `chmod 0600` key permission handling.
+- 🎨 **Dual-Mode Experience**: Modern interactive TUI wizard with `@clack/prompts` and non-interactive flags (`--json`, `--yes`, `--global`) for CI/CD scripting.
+
+---
+
+## 🚀 Installation
+
+```bash
+# Global installation via npm
+npm install -g @siamriaz/octomux
+
+# Or run directly via npx without installing
+npx @siamriaz/octomux
+```
+
+*Both `octomux` and `omx` binary aliases are available upon installation.*
+
+---
+
+## ⚡ Quick Start
+
+### 1. Interactive Menu
+Simply run `omx` without arguments to open the interactive command center:
+
+```bash
+omx
+```
+
+```
+┌  🐙 octomux (omx) — GitHub Identity & SSH Manager
+│
+◇  What would you like to do?
+│  ● 📋 List configured accounts
+│  ○ ➕ Add a new GitHub account
+│  ○ 🔑 Auto-import existing SSH keys
+│  ○ 🔀 Switch Git identity (global / local)
+│  ○ 🔗 Add or set remote origin for this repo
+│  ○ 📦 Smart clone a repository
+│  ○ 🔍 Check active Git & SSH status
+│  ○ ⚡ Test SSH connections
+│  ○ 🗑️  Uninstall & clean up octomux
+│  ○ 🚪 Exit
+```
+
+---
+
+## 📖 Command Reference
+
+### Account Management (`omx account` / `omx acc`)
+
+#### Add an Account (with Auto-Detected Keys)
+```bash
+# Interactive setup wizard (automatically scans ~/.ssh and shows detected keys)
+omx account add
+
+# Headless / scriptable setup
+omx account add \
+  --alias work \
+  --username johndoe-corp \
+  --email john@company.com \
+  --git-name "John Doe" \
+  --keygen \
+  --global
+```
+
+#### Auto-Import Existing SSH Keys
+```bash
+# Interactive key auto-discovery & import wizard:
+omx account import
+# or shorthand:
+omx import
+
+# Import a specific existing private key directly:
+omx import ~/.ssh/id_rsa_work --alias work --username johndoe --email john@work.com
+```
+
+#### List Accounts
+```bash
+omx account list
+# or shorthand:
+omx ls
+```
+
+#### Edit an Account
+```bash
+omx account edit work --email newemail@company.com
+```
+
+#### Remove an Account
+```bash
+omx account remove work
+# Delete associated SSH keys as well:
+omx account remove work --delete-keys --yes
+```
+
+#### Test SSH Connection
+```bash
+# Test specific profile
+omx account test work
+
+# Test all profiles
+omx account test --all
+```
+
+---
+
+### Identity Switcher (`omx switch` / `omx use`)
+
+```bash
+# Interactive switcher (prompts for account and local/global scope)
+omx switch
+
+# Switch global Git configuration
+omx switch work --global
+
+# Switch local repository Git configuration & dedicated SSH key
+omx switch work --local
+```
+
+---
+
+### Status Check (`omx status` / `omx current`)
+
+Inspect active global and local Git identities and match them against configured `octomux` profiles:
+
+```bash
+omx status
+```
+
+---
+
+### Remote Origin Configuration (`omx remote` / `omx origin`)
+
+Attach or update a Git remote origin for an existing local repository and automatically bind the local author and SSH key:
+
+```bash
+# Interactive wizard (prompts for repo URL/slug and account profile)
+omx remote
+
+# Set origin to a GitHub repository using a specific account profile:
+omx remote owner/repo -a work
+
+# Or with shorthand alias:
+omx origin owner/repo -a personal
+```
+
+#### What `omx remote` does:
+1. Translates the repo slug/URL into `git@github.com-<alias>:owner/repo.git`.
+2. Adds or updates `origin` remote (`git remote add` or `git remote set-url`).
+3. Automatically sets local repository `user.name`, `user.email`, and `core.sshCommand`.
+
+---
+
+### Smart Clone (`omx clone`)
+
+Clone any repository and automatically bind the local repository author name, email, and SSH key identity:
+
+```bash
+# Clone with interactive account picker
+omx clone facebook/react
+
+# Clone with explicit account identity
+omx clone facebook/react -a work
+
+# Clone into custom target directory
+omx clone https://github.com/facebook/react.git my-react -a personal
+```
+
+#### What happens behind the scenes:
+1. Translates the clone URL to `git@github.com-work:facebook/react.git`.
+2. Runs `git clone`.
+3. Navigates into the newly cloned repository directory and configures:
+   - `git config --local user.name "<gitUserName>"`
+   - `git config --local user.email "<email>"`
+   - `git config --local core.sshCommand "ssh -i <keyPath> -o IdentitiesOnly=yes"`
+4. Guarantees every future `git commit` and `git push` in that repo will use the correct identity.
+
+---
+
+## 🛠️ Architecture & Data Safety
+
+### SSH Configuration Isolation (`~/.ssh/config`)
+`octomux` isolates its host definitions inside marked delimiters. Your existing custom SSH entries are never modified or deleted:
+
+```sshconfig
+# Existing user configurations are preserved
+Host my-vps
+    HostName 192.168.1.100
+    User root
+
+# === OCTOMUX MANAGED HOSTS: START ===
+# This block is automatically managed by octomux (omx).
+Host github.com-work
+    HostName github.com
+    User git
+    IdentityFile "C:/Users/User/.ssh/id_ed25519_octomux_work"
+    IdentitiesOnly yes
+
+Host github.com-personal
+    HostName github.com
+    User git
+    IdentityFile "C:/Users/User/.ssh/id_ed25519_octomux_personal"
+    IdentitiesOnly yes
+# === OCTOMUX MANAGED HOSTS: END ===
+```
+
+---
+
+## 🧪 Testing
+
+```bash
+# Run unit & integration tests
+npm test
+
+# Run type check
+npm run typecheck
+
+# Build bundle with tsup
+npm run build
+```
+
+---
+
+## 🧹 Safe Uninstallation & Cleanup
+
+To safely remove `octomux` configurations and clean up your system:
+
+### 1. Using the Built-in Command:
+```bash
+# Clean ~/.ssh/config and ~/.octomux data (prompts for options)
+omx uninstall
+
+# Or completely purge everything including generated SSH keys without prompts:
+omx uninstall --delete-keys --yes
+```
+
+### 2. Remove the NPM Binary:
+```bash
+# If installed globally via npm:
+npm uninstall -g @siamriaz/octomux
+
+# If linked locally during development:
+npm unlink -g octomux
+```
+
+---
+
+## 📄 License
+
+MIT © [Octomux Contributors](LICENSE)

package/dist/bin/octomux.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/bin/octomux.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+import {
+  logger,
+  run
+} from "../chunk-3NCQOE6V.js";
+
+// bin/octomux.ts
+process.on("unhandledRejection", (reason) => {
+  const message = reason instanceof Error ? reason.message : String(reason);
+  logger.error(`An unexpected error occurred: ${message}`);
+  process.exit(1);
+});
+process.on("uncaughtException", (error) => {
+  logger.error(`Fatal error: ${error.message}`);
+  process.exit(1);
+});
+run().catch((err) => {
+  const message = err instanceof Error ? err.message : String(err);
+  logger.error(message);
+  process.exit(1);
+});
+//# sourceMappingURL=octomux.js.map

package/dist/bin/octomux.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../bin/octomux.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { run } from '../src/index.js';\nimport { logger } from '../src/ui/logger.js';\n\nprocess.on('unhandledRejection', (reason) => {\n  const message = reason instanceof Error ? reason.message : String(reason);\n  logger.error(`An unexpected error occurred: ${message}`);\n  process.exit(1);\n});\n\nprocess.on('uncaughtException', (error) => {\n  logger.error(`Fatal error: ${error.message}`);\n  process.exit(1);\n});\n\nrun().catch((err: unknown) => {\n  const message = err instanceof Error ? err.message : String(err);\n  logger.error(message);\n  process.exit(1);\n});\n"],"mappings":";;;;;;;AAKA,QAAQ,GAAG,sBAAsB,CAAC,WAAW;AAC3C,QAAM,UAAU,kBAAkB,QAAQ,OAAO,UAAU,OAAO,MAAM;AACxE,SAAO,MAAM,iCAAiC,OAAO,EAAE;AACvD,UAAQ,KAAK,CAAC;AAChB,CAAC;AAED,QAAQ,GAAG,qBAAqB,CAAC,UAAU;AACzC,SAAO,MAAM,gBAAgB,MAAM,OAAO,EAAE;AAC5C,UAAQ,KAAK,CAAC;AAChB,CAAC;AAED,IAAI,EAAE,MAAM,CAAC,QAAiB;AAC5B,QAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC/D,SAAO,MAAM,OAAO;AACpB,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":[]}