NumeroClaw CLI

Readings from your terminal.

One binary, no dependencies. Create readings, download PDFs, manage everything locally. macOS, Linux, Windows.

Install Commands

numeroclaw — zsh

# Create a reading
numeroclaw create

# The CLI guides you step by step:
? Full name: Lionel Andres Messi
? Date of birth: 1987-06-24
? Gender (M/F): M

# Processing... done
PDF saved to ~/NumeroClaw/readings/messi-lionel.pdf

Everything you need, nothing you don't

A standalone binary that handles the entire workflow. No Node.js, no Python, no package manager.

Guided creation

Interactive prompts walk you through each reading. Enter a name, date of birth, and gender. The CLI does the rest.

Auto-download PDF

Once the reading is complete, the PDF is downloaded automatically to your local folder. No manual steps.

Batch processing

Feed a CSV file to generate dozens of readings in parallel. Perfect for practitioners with client lists.

Built-in diagnostics

numeroclaw doctor checks your config, API key, connectivity, and disk space. One command to troubleshoot.

Secure key storage

Your API key is stored in the system keychain (macOS Keychain, Linux Secret Service). Never written to a config file.

French and English

Set your interface language and reading locale independently. numeroclaw config set interfaceLocale fr-FR

Install

Download the binary for your platform, make it executable, and you're done. ~100 MB, zero dependencies.

macOS

Universal binary — Apple Silicon and Intel

Download

1Download the universal binary and move it into /usr/local/bin.

2Run numeroclaw --version. If Gatekeeper blocks it, remove quarantine once.

# Download and install
curl -sL numeroclaw.com/dl/mac -o numeroclaw
chmod +x numeroclaw
sudo mv numeroclaw /usr/local/bin/

# If macOS blocks the binary:
xattr -d com.apple.quarantine /usr/local/bin/numeroclaw

# Verify
numeroclaw --version

Linux

x86_64 static binary

Download

1Download the Linux binary and move it into /usr/local/bin.

2Make it executable, then verify with numeroclaw --version.

# Download and install
curl -sL numeroclaw.com/dl/linux -o numeroclaw
chmod +x numeroclaw
sudo mv numeroclaw /usr/local/bin/

# Verify
numeroclaw --version

Windows

x86_64 executable

Download

1Download numeroclaw.exe and place it in a folder such as C:\Tools\.

2Add that folder to your PATH, then run numeroclaw --version.

# Download numeroclaw.exe from the release page
# Place it in a folder (e.g. C:\\Tools\\)
# Add that folder to your PATH

# Verify
numeroclaw --version

Commands

Everything runs from a single binary. No server, no browser.

numeroclaw create

Create a reading interactively. The CLI prompts for name, date, and gender, then polls until the reading is ready and downloads the PDF.

numeroclaw batch run file.csv

Process a CSV file of readings. Each row becomes a reading, processed in parallel with progress tracking.

numeroclaw doctor

Run a full diagnostic: config file, API key, connectivity, output directory, locale detection. Fix issues in seconds.

numeroclaw history

List past readings with status, dates, and output paths. Re-download any reading's PDF at any time.

numeroclaw config show

View your current configuration: output directory, locale, default product, and all preferences.

numeroclaw --help

Full command reference with examples. Every sub-command has its own --help flag.

Get started in 30 seconds

Download the binary, set your API key, run numeroclaw create.

Open app Read the docs