Every invocation is normalized to:

claude remote-control --permission-mode bypassPermissions

On first run, the wrapper asks for consent once and persists the decision to ~/.claude-remote-yolo-state.json.

Prerequisite: The claude CLI must be available on your system.

# npm
npm install -g claude-remote-yolo

# pnpm
pnpm add -g claude-remote-yolo

npx claude-remote-yolo "summarize this repository"

# Basic usage
claude-remote-yolo "summarize this repository"

# With --yolo flag (accepted for compatibility, ignored)
claude-remote-yolo --yolo "summarize this repository"

# Help
claude-remote-yolo --help

After installing globally, you can register a cry alias for quick access.

Add an alias to your shell config:

# Bash
echo 'alias cry="claude-remote-yolo"' >> ~/.bashrc && source ~/.bashrc

# Zsh
echo 'alias cry="claude-remote-yolo"' >> ~/.zshrc && source ~/.zshrc

Add a function to your PowerShell profile:

# Create profile if it doesn't exist
if (!(Test-Path -Path $PROFILE)) { New-Item -ItemType File -Path $PROFILE -Force }

# Register the alias
Add-Content -Path $PROFILE -Value 'function cry { claude-remote-yolo @args }'

Open a new terminal and you're good to go: cry "summarize this repository"

# Install dependencies
pnpm install

# Run all checks (lint + test + build)
pnpm check

# Run locally
node dist/bin.js "summarize this repository"

• ESLint — zero warnings allowed
• Vitest — 100% coverage (lines, functions, statements, branches)
• File line limit — 450 lines max per file
• Pre-commit hook — runs pnpm check via simple-git-hooks

• Wraps the public Claude CLI command — no patching of Claude's installed source files
• --yolo flag is accepted for compatibility and silently ignored
• Consent state is persisted per-user, not per-project

MIT