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

npx nemonix-cli claude-code setup

When prompted, enter the password provided by the config owner.

Usage

Setup (First Time)

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)

npx nemonix-cli claude-code update

• Same as setup but overwrites existing config files
• Useful when config owner publishes updates

Status (Check Installation)

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:

cd ~/nemonix-cli
npm run sync          # Pull latest from NemonixClaudeConf
npm run build         # Build the CLI
npm publish           # Publish to npm

Friends then run:

npx nemonix-cli@latest claude-code update

Changing the Password

To set a new password for distribution:

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

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

# 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

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]