redblue

0.2.33 verified Sat Apr 25 auth: no javascript

redblue is a security CLI tool written in Rust, providing 90+ commands for network scanning, DNS, recon, web fuzzing, TLS, authentication testing, exploit, binary analysis, password cracking, evasion, secrets detection, vulnerability intelligence, and proxy/C2 capabilities. The npm package redblue-cli v0.2.33 wraps the rb binary for JavaScript/TypeScript ecosystems, supporting npx and npm exec. Requires Node.js >=20. It is actively maintained with frequent releases. Key differentiator: zero-dependency binary with 40+ protocols implemented from scratch.

Common errors

error Cannot find module 'redblue-cli' ↓

cause The package is not installed or is missing from package.json.

fix

Run 'npm install redblue-cli' to install the npm package.

error Error: spawn rb ENOENT ↓

cause The rb binary is not found in PATH or not bundled with the npm package.

fix

Ensure the binary is installed via curl or download, and add it to PATH.

error TypeError: rb is not a function ↓

cause Using require() with ESM-only package version >=0.2.0.

fix

Use import { rb } from 'redblue-cli' or dynamic import.

error Error: Command failed with exit code 1: rb dns record lookup example.com --type MX ↓

cause The DNS lookup failed, possibly due to network issues or invalid domain.

fix

Check network connectivity and domain name; use --verbose for more details.

Warnings

gotcha The rb binary requires libc as a runtime dependency; ensure it's available on your system. ↓

fix Install libc (e.g., glibc on Linux) or use a static build if available.

breaking Version 0.2.0 changed from CJS to ESM; require() no longer works. ↓

fix Use dynamic import() or switch to ESM (type: module in package.json).

deprecated The '--format' flag for output was replaced with '--output' in newer releases. ↓

fix Use '--output' instead of '--format'.

gotcha Some commands may require root privileges for raw sockets; they will fail silently if not permitted. ↓

fix Run the binary with sudo or appropriate capabilities (CAP_NET_RAW).

gotcha The npm package does not include the binary for all platforms; only linux-x86_64 is bundled. Other platforms must use the separate binary download. ↓

fix Install the binary manually for non-Linux systems or use a CI matrix.

Install

npm install redblue-cli

yarn add redblue-cli

pnpm add redblue-cli

Imports

default

wrong

const redblue = require('redblue-cli')

correct

import redblue from 'redblue-cli'

ESM-only since v0.2.0; CommonJS require is not supported.

wrong

const rb = require('redblue-cli').rb

correct

import { rb } from 'redblue-cli'

Use named import for the rb function which executes the CLI.

RedblueConfig
```
import type { RedblueConfig } from 'redblue-cli'
```
TypeScript type available for configuration object.

Quickstart

Shows how to use the redblue-cli SDK to run various security commands: DNS lookup, TLS cipher scan, and subdomain bruteforce.

import { rb } from 'redblue-cli';

async function main() {
  // Run a DNS lookup with custom options
  const result = await rb('dns', 'record', 'lookup', 'example.com', '--type', 'MX');
  console.log('DNS records:', result);

  // Run a TLS cipher enumeration
  const tlsResult = await rb('tls', 'cipher', 'scan', 'example.com', '--port', '443');
  console.log('TLS ciphers:', tlsResult);

  // Run a subdomain discovery
  const subdomains = await rb('recon', 'subdomain', 'bruteforce', 'example.com', '--wordlist', '/path/to/wordlist.txt');
  console.log('Subdomains found:', subdomains);
}

main().catch(console.error);