AI-powered scripting CLI — automate anything from your terminal.

npm install -g @robinpath/cli

Requires Node.js 18+.

RobinPath includes a built-in MCP server that works with Claude Code, Cursor, Windsurf, Codex CLI, and any MCP-compatible AI client.

robinpath mcp init

That's it. Auto-detects your AI clients and configures them. Or target a specific client:

robinpath mcp init claude     # Claude Code (global)
robinpath mcp init project    # Current project only (.mcp.json)
robinpath mcp init cursor     # Cursor
robinpath mcp init windsurf   # Windsurf

Check connection status:

robinpath mcp status

If you prefer manual configuration:

Claude Code — add to .mcp.json in your project:

{
  "mcpServers": {
    "robinpath": {
      "command": "robinpath",
      "args": ["mcp"]
    }
  }
}

Cursor — Settings > MCP Servers > Add: command robinpath, args mcp, transport stdio

Windsurf — add the same JSON to your MCP config

Once connected, your AI client gets 16 tools:

The MCP server automatically tells your AI client:

• Which native modules are available (file, http, crypto, os, etc.)
• Which registry modules are installed
• Which env vars are configured
• What's missing when you ask for something that needs a module you don't have

Example: if you ask "send a Slack message and email the results", the AI will tell you that @robinpath/slack and @robinpath/email need to be installed first, and offer to install them.

robinpath mcp                          # default
robinpath mcp --read-only              # disable write operations
robinpath mcp --timeout 30000          # 30s execution timeout
robinpath mcp --log-file audit.log     # audit log
robinpath mcp --tools execute,resolve  # whitelist specific tools

• Input validation — module names, env keys, file paths all validated
• Command injection protection — safe argument passing (no shell interpolation)
• Rate limiting — 30/min for execution tools, 60/min for reads
• Audit logging — optional JSON log of all tool calls
• Read-only mode — disable all write operations
• Tool whitelisting — expose only the tools you need
• File restrictions — only .rp/.robin files can be executed
• Script size limits — 100KB max per execution
• Path traversal protection — blocks .. escapes

robinpath

First run guides you through:

1. Login — authenticate with your RobinPath account
2. API key — paste your OpenRouter key (get one at openrouter.ai/keys)
3. Ready — start chatting with the AI

# Interactive AI assistant
robinpath

# Headless AI prompt (for scripts/piping)
robinpath -p "create a script that fetches weather data"

# Run a script
robinpath hello.rp

# Inline code
robinpath -e 'log "Hello World"'

robinpath <file.rp>          # Run a script
robinpath -p "prompt"        # AI headless mode
robinpath -e "code"          # Execute inline code
robinpath fmt <file>         # Format code
robinpath check <file>       # Syntax check
robinpath test [dir]         # Run tests
robinpath add <pkg>          # Install a module
robinpath remove <pkg>       # Remove a module
robinpath search <query>     # Search module registry
robinpath login              # Authenticate
robinpath update             # Self-update to latest
robinpath uninstall          # Clean removal
robinpath mcp                # Start MCP server

Create a ROBINPATH.md file in your project to customize the AI's behavior — like Claude Code's CLAUDE.md. The AI reads it automatically on startup.

robinpath
> /init

robinpath ai config set-key ...       # Set API key
robinpath ai config set-model <id>    # Set model
robinpath ai config show              # View config
robinpath ai config remove            # Remove config

• Website: dev.robinpath.com
• npm: @robinpath/cli
• GitHub: wiredwp/robinpath-cli