nemonix-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 redk3rn3l
+
+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,186 @@
+# nemonix-cli
+
+Password-protected CLI for installing premium Claude Code configurations and tools.
+
+## Features
+
+- **🔐 Password Protected** — Share with friends without exposing config
+- **⚡ Bundled Config** — No external dependencies or GitHub tokens needed
+- **🔄 Smart Merging** — Preserves existing settings, merges hooks additively
+- **🌍 Cross-Platform** — Handles macOS (afplay) and Linux (mpv) automatically
+- **🎯 Setup, Update, Status** — Simple commands to manage your config
+
+## Installation
+
+```bash
+npx nemonix-cli claude-code setup
+```
+
+When prompted, enter the password provided by the config owner.
+
+## Usage
+
+### Setup (First Time)
+```bash
+npx nemonix-cli claude-code setup
+```
+- Prompts for password
+- Copies config files to `~/.claude/`
+- Merges `settings.json` without overwriting user settings
+- Installs script dependencies
+
+### Update (Get Latest)
+```bash
+npx nemonix-cli claude-code update
+```
+- Same as setup but overwrites existing config files
+- Useful when config owner publishes updates
+
+### Status (Check Installation)
+```bash
+npx nemonix-cli claude-code status
+```
+Shows what's installed:
+- Agent count
+- Skills
+- Commands
+- Scripts
+- Hooks
+- Songs
+- Settings file
+
+## What Gets Installed
+
+The CLI bundles and installs the complete Nemonix Claude Code configuration:
+
+```
+~/.claude/
+├── agents/           # Specialized AI subagents (haiku, snipper, implementer, etc.)
+├── skills/           # Multi-step workflow skills (30+ tools)
+├── commands/         # Slash commands for Claude Code
+├── scripts/          # Utility scripts (statusline, auto-rename, validators)
+├── hooks/            # Event handlers (pre/post file write, session end)
+├── song/             # Notification sounds
+└── settings.json     # Configuration (merged intelligently)
+```
+
+## How It Works
+
+1. **Password Protection** — The password is bcrypt-hashed and embedded in the CLI binary
+2. **Bundled Config** — Config files are copied into the npm package at build time
+3. **Smart Merging** — Settings.json merge is additive:
+   - Environment variables: merged (incoming wins on conflicts)
+   - Permissions: additive (new rules added, existing preserved)
+   - Hooks: additive (duplicates skipped)
+   - Model/statusline: uses incoming only if not already set
+4. **Path Rewriting** — Original macOS paths (`/Users/melvynx/.claude`) are rewritten to match your `$HOME/.claude`
+5. **Platform Adaptation** — Sound hooks are automatically adapted for your OS
+
+## Configuration Update Workflow
+
+**For config owners:**
+
+```bash
+cd ~/nemonix-cli
+npm run sync          # Pull latest from NemonixClaudeConf
+npm run build         # Build the CLI
+npm publish           # Publish to npm
+```
+
+Friends then run:
+```bash
+npx nemonix-cli@latest claude-code update
+```
+
+## Changing the Password
+
+To set a new password for distribution:
+
+```bash
+cd ~/nemonix-cli
+npm run set-password   # Prompts for new password
+npm run build          # Rebuild with new hash
+npm publish            # Publish update
+```
+
+## For Developers
+
+### Project Structure
+
+```
+nemonix-cli/
+├── src/
+│   ├── cli.ts                    # Commander.js entry point
+│   ├── commands/claude-code.ts   # setup/update/status commands
+│   ├── lib/
+│   │   ├── auth.ts               # Password verification (bcryptjs)
+│   │   ├── installer.ts          # File copying logic
+│   │   └── settings-merger.ts    # Settings.json merge logic
+│   └── config/claude-code-config/ # Bundled config (synced from source)
+├── scripts/
+│   ├── sync.sh                   # Syncs config from NemonixClaudeConf
+│   └── set-password.mjs          # Password change utility
+└── dist/cli.js                   # Built output
+```
+
+### Build Commands
+
+```bash
+npm install          # Install dependencies
+npm run sync         # Sync config from ~/NemonixClaudeConf
+npm run build        # Build with bun (produces dist/cli.js)
+npm publish          # Publish to npm
+```
+
+### Dependencies
+
+- **commander** — CLI framework
+- **fs-extra** — File system utilities
+- **bcryptjs** — Password hashing
+- **@clack/prompts** — Interactive prompts
+- **picocolors** — Terminal colors
+
+## Testing Locally
+
+```bash
+# Test help
+node dist/cli.js --help
+
+# Test commands
+node dist/cli.js claude-code setup
+node dist/cli.js claude-code status
+```
+
+## Platform Support
+
+- ✅ macOS (uses `afplay` for sounds)
+- ✅ Linux (uses `mpv` for sounds, fallback to silent)
+- ✅ Windows WSL2 (tested on WSL2)
+
+## Troubleshooting
+
+### Invalid password error
+- Check the password spelling (case-sensitive)
+- Contact the config owner for the correct password
+
+### Dependencies fail to install
+```bash
+cd ~/.claude/scripts
+bun install
+```
+
+### Sound hooks not working on Linux
+- Install `mpv`: `sudo apt-get install mpv` (Debian/Ubuntu)
+- Or silence them in `~/.claude/settings.json`
+
+## License
+
+MIT
+
+## Author
+
+Created by [Your Name] for the Nemonix Claude Code configuration.
+
+---
+
+For updates and issues: [GitHub repo URL]