nemonix-cli

Password-protected CLI for installing premium Nemonix configurations into Claude Code and OpenAI Codex CLI.

Features

• 🔐 Password Protected — Share with friends without exposing config
• ⚡ Bundled Config — No external dependencies or GitHub tokens needed at install time
• 🔄 Smart Merging — Preserves existing settings, replaces config-managed sections
• 🤖 Dual Target — Installs agents + skills to ~/.claude/ AND Codex config to ~/.codex/
• 🌍 Cross-Platform — macOS, Linux, Windows WSL2

Installation

npx nemonix-cli setup

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

Usage

Setup (First Time)

npx nemonix-cli setup

• Prompts for password
• Copies agents, skills, scripts to ~/.claude/
• Merges ~/.claude/settings.json without overwriting user keys
• Copies Codex AGENTS.md and config.toml to ~/.codex/ (won't overwrite an existing config.toml)
• Installs script dependencies via bun install
• Adds shell aliases (cc, ccc)

Update (Get Latest)

npx nemonix-cli update

Same as setup but overwrites existing managed files. Run this when the config owner publishes a new version.

Status (Check Installation)

npx nemonix-cli status

Shows what's installed: agent count, skill count, scripts, settings.json, Codex config.

Uninstall

npx nemonix-cli uninstall

Removes Nemonix-managed entries from ~/.claude/. Codex config left alone.

What Gets Installed

~/.claude/
├── agents/        # Specialized AI subagents (implementer, snipper, code-reviewer, …)
├── skills/        # Multi-step workflow skills (nemo, brainstorm, crab-review, …)
├── scripts/       # Statusline + utility scripts
└── settings.json  # Merged with your existing settings

~/.codex/
├── AGENTS.md      # Codex agent instructions
└── config.toml    # Codex defaults (only written if absent)

The config source is agents-config/ in the upstream repo, which keeps shared agents and skills at the root and splits the runtime config into claude-config/ and codex-config/ subfolders.

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 (in src/config/agents-config/)
3. Smart Merging — settings.json merge:
   • Schema, env, model, permissions, hooks, statusLine: incoming wins
   • Other top-level keys: incoming wins; user-only keys preserved
   • Stale keys (e.g. MAX_THINKING_TOKENS, alwaysThinkingEnabled) explicitly removed
4. Path Rewriting — Embedded paths like {CLAUDE_PATH}/, /Users/<x>/.claude, /home/<x>/.claude get rewritten to the actual $HOME/.claude on install
5. Codex Safety — ~/.codex/config.toml is only written if it doesn't already exist, so your local Codex trust list / model picks are never overwritten

Configuration Update Workflow

For config owners:

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

Or trigger the GitHub Actions workflow (Sync, Build & Publish) from the Actions tab — it does the sync, bump, build, publish, and version commit in one shot.

Friends then run:

npx nemonix-cli@latest update

Changing the Password

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/install.ts          # setup/update/status/uninstall
│   ├── lib/
│   │   ├── auth.ts                  # Password verification (bcryptjs)
│   │   ├── installer.ts             # Install agents/skills/scripts + Codex config
│   │   └── settings-merger.ts       # settings.json merge logic
│   └── config/agents-config/        # Bundled config (synced from NemonixClaudeConf)
├── 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 emmanuelhiss/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

node dist/cli.js --help
node dist/cli.js setup
node dist/cli.js status

Platform Support

• ✅ macOS
• ✅ Linux
• ✅ Windows WSL2

Troubleshooting

Invalid password error — Check spelling (case-sensitive). Contact the config owner.

bun install fails after setup

cd ~/.claude/scripts
bun install

Codex config not appearing The CLI never overwrites an existing ~/.codex/config.toml. Delete or rename it and re-run setup to pick up the bundled defaults.

License

MIT