CLI

Kaabalah inclui uma interface de linha de comando para cálculos rápidos sem escrever código.

Instalação

# Instalar globalmente
npm install -g kaabalah

# Ou executar diretamente com npx
npx kaabalah help

Comandos

Comando	Descrição
gematria <text>	Calcular gematria para uma palavra ou frase
gematria:reverse <number>	Encontrar combinações de letras que correspondam a um valor de gematria
numerology <date>	Perfil numerológico completo para uma data de nascimento
numerology:lifepath <date>	Número do caminho de vida (método kaabalístico)
numerology:cycles <date> [name]	Ciclos pessoais (ano, mês, períodos)
numerology:challenges <date>	Desafios a partir da data de nascimento
numerology:fibonacci <date>	Ciclo de Fibonacci para a idade atual
astrology <date> [time]	Calcular mapa natal usando Swiss Ephemeris
tarot [count]	Tirar cartas de tarô (padrão: 3)
tarot:card <number>	Consultar uma carta específica (1-78)
ifa <date>	Calcular Odu a partir de uma data
tree	Mostrar a estrutura da Árvore da Vida com todos os nós, dados e arestas
tree:node <id>	Consultar um nó e todas as suas correspondências
tree:types	Listar todos os tipos de nó e suas contagens

Exemplos

kaabalah gematria "Hello World"
kaabalah numerology 1990-01-15
kaabalah numerology:cycles 1990-01-15 John
kaabalah tarot 5 --inverted
kaabalah tarot:card 7
kaabalah gematria:reverse 22
kaabalah ifa 1990-01-15
kaabalah astrology 1990-01-15 14:30 --lat=40.7128 --lon=-74.006
kaabalah astrology 1990-01-15 14:30 --location="New York, USA"

# Correspondências da Árvore da Vida
kaabalah tree:node path:1 --json
kaabalah tree:node "tarotArkAnnu:The Magician" --depth=2 --json
kaabalah tree:node sphere:Kether --type=tarotArkAnnu --json

Flags Globais

Flag	Descrição
--json	Saída JSON (habilitado automaticamente quando stdout não é um TTY)
--no-json	Forçar saída legível por humanos mesmo quando redirecionado
--compact	JSON minificado (sem indentação)
--fields=a.b,c.d	Filtrar a saída JSON para os caminhos em ponto especificados
--input-json='{"key":"val"}'	Passar todos os parâmetros como um objeto JSON

Referência Detalhada de Comandos

gematria

Calcular valores de letras hebraicas para texto latino.

kaabalah gematria "Hello World"
kaabalah gematria "Hello World" --json --compact

gematria:reverse

Encontrar combinações de letras que correspondam a um valor alvo de gematria.

kaabalah gematria:reverse 22
kaabalah gematria:reverse 22 --max-results=50 --min-length=2 --max-length=4 --json

Flag	Tipo	Padrão	Descrição
--max-results	número	20	Máximo de resultados a retornar (máx 10000)
--min-length	número	2	Mínimo de letras por combinação
--max-length	número	6	Máximo de letras por combinação
--include-digraphs	booleano	false	Incluir dígrafos como PH, SH

numerology

Perfil numerológico completo a partir de uma data de nascimento.

kaabalah numerology 1990-01-15
kaabalah numerology 1990-01-15 --json --fields=kaabalistic.lifePath.reducedValue,challenges.mainChallenge

numerology:lifepath

Número do caminho de vida usando o método kaabalístico.

kaabalah numerology:lifepath 1990-01-15

numerology:cycles

Ciclos pessoais (ano, mês, períodos). Opcionalmente passe um primeiro nome para cálculo do número da alma.

kaabalah numerology:cycles 1990-01-15
kaabalah numerology:cycles 1990-01-15 John

numerology:challenges

Calcular desafios a partir de uma data de nascimento.

kaabalah numerology:challenges 1990-01-15

numerology:fibonacci

Ciclo de Fibonacci baseado na idade atual.

kaabalah numerology:fibonacci 1990-01-15

astrology

Calcular um mapa natal usando Swiss Ephemeris (WASM).

# Com coordenadas explícitas (não é necessária chave de API)
kaabalah astrology 1990-01-15 14:30 --lat=40.7128 --lon=-74.006

# Com geocodificação (requer variável de ambiente GOOGLE_MAPS_API_KEY)
kaabalah astrology 1990-01-15 14:30 --location="New York, USA"

# Sistema de casas e fuso horário personalizados
kaabalah astrology 1990-01-15 14:30 --lat=40.7128 --lon=-74.006 --house-system=koch --timezone=America/New_York

# O horário padrão é 12:00 se omitido
kaabalah astrology 1990-01-15 --lat=40.7128 --lon=-74.006

Flag	Tipo	Padrão	Descrição
--lat	número	-	Latitude (-90 a 90)
--lon	número	-	Longitude (-180 a 180)
--location	string	-	Localização para geocodificação (requer GOOGLE_MAPS_API_KEY)
--house-system	string	placidus	Sistema de casas (ver abaixo)
--timezone	string	-	Fuso horário IANA (ex. America/New_York)

Sistemas de casas: placidus, koch, porphyrius, regiomontanus, campanus, equal, whole-sign, meridian, morinus, krusinski, alcabitius

tarot

Sortear cartas de tarô aleatórias.

kaabalah tarot 5 --inverted
kaabalah tarot --json

Flag	Tipo	Padrão	Descrição
--inverted	booleano	false	Incluir cartas invertidas
--shuffle-count	número	7	Número de vezes para embaralhar o baralho

tarot:card

Consultar uma carta específica por número.

kaabalah tarot:card 7
kaabalah tarot:card 22 --json

ifa

Calcular Odu a partir de uma data.

kaabalah ifa 1990-01-15

tree

Mostrar a estrutura completa do grafo da Árvore da Vida — todos os nós com seus dados e arestas.

kaabalah tree
kaabalah tree --json --compact

No modo JSON, a saída inclui nós (com dados e tipos relacionados) e arestas (todas as conexões entre nós).

tree:node

Consultar um nó específico e todas as suas correspondências. Este é o comando chave para percorrer o grafo da Árvore da Vida.

# Obter um caminho e todas as suas correspondências diretas
kaabalah tree:node path:1 --json

# Obter as correspondências de uma carta de tarô
kaabalah tree:node "tarotArkAnnu:The Magician" --json

# Caminhar 2 níveis de profundidade para ver a cadeia completa de correspondências
# (por exemplo carta de tarô → caminho → letra hebraica, esferas, elemento, zodíaco)
kaabalah tree:node "tarotArkAnnu:The Magician" --depth=2 --json

# Filtrar por tipo — obter apenas cartas de tarô relacionadas a uma esfera
kaabalah tree:node sphere:Kether --type=tarotArkAnnu --json

# Obter a letra hebraica para um caminho
kaabalah tree:node path:1 --type=hebrewLetter --json

Flag	Tipo	Padrão	Descrição
--type	string	-	Filtrar nós relacionados por tipo (ex. hebrewLetter, planet, tarotArkAnnu)
--depth	número	1	Profundidade de travessia para caminhar no grafo

tree:types

Listar todos os tipos de nó disponíveis na árvore e suas contagens. Útil para descobrir nomes de tipos válidos para tree:node --type filtragem.

kaabalah tree:types
kaabalah tree:types --json

Introspecção de Esquema

A CLI expõe seu esquema completo como JSON, útil para consumo programático.

# Esquema completo de todos os comandos
kaabalah help --json

# Esquema para um comando específico
kaabalah help astrology --json

Tratamento de Erros

Todos os erros em --json modo retornam uma resposta estruturada:

{"error": true, "code": "ERROR_CODE", "message": "Descrição legível por humanos"}

O código de saída é sempre 1 em erro.

Códigos de erro: INVALID_DATE, INVALID_ARGUMENT, MISSING_ARGUMENT, UNKNOWN_COMMAND, CARD_NOT_FOUND, INTERNAL_ERROR, GEOCODE_ERROR, WASM_INIT_ERROR, INVALID_JSON

---