Já li dezenas de matérias diferentes sobre "CLI poker game" lançados em fóruns de desenvolvedor nos últimos doze meses. Todas erram a mesma coisa, da mesma forma. Hear me out.

Não é coincidência. É um padrão estrutural. Jornalismo tech cobre poker software como cobre qualquer side project de fim de semana — pelo dev, pela stack, pelo gimmick de rodar via `npx` sem instalação ou de caber em duzentas linhas de Bash. Nunca pela coisa em si. A ferramenta é de poker. Poker tem math. Math tem teste. Nenhuma matéria que li, lendo cuidadosamente, testou de fato a math. E quando você lê uma cobertura inteira sem encontrar um único cálculo verificável, fica óbvio que a pauta nunca foi poker. A pauta era o projeto. Poker é só o tema de capa.

O Que Todos Erram

O erro compartilhado é simples e ele se repete em toda matéria. O autor descreve o que a ferramenta faz — roda no terminal, não precisa instalar, usa unicode para naipes, tem um adversário CPU que blefa de vez em quando — sem nunca testar se o que ela faz é correto em termos de poker.

Em três das coberturas que arquivei, o parágrafo sobre o "CPU adversary" tinha exatamente uma frase de explicação. "O bot decide com base em probabilidades." Quais probabilidades? Calculadas como? Monte Carlo de quantas simulações? Hand-coded equity tables? Lookup contra range pré-definido? Nenhuma matéria pergunta.

Nota: o repositório típico desses projetos tem entre 800 e 2.400 linhas de código. Equity engine sério tem 15.000+ linhas só na parte de evaluator. PokerStove tem cerca de 60.000.

Outro erro: matérias confundem "jogabilidade" com "jogabilidade de poker". Texas Hold'em tem regras que parecem simples — duas cartas na mão, cinco no board, melhor mão ganha — e implementar essas regras é trivial. Implementar betting rounds com check-raise legal, split pots quando alguém vai all-in com stack menor e cria side pot, calcular equity em tempo real como a transmissão da WSOP mostra na barra — isso é difícil. Nenhuma matéria que li distingue entre essas camadas. Todas tratam "implementou Hold'em" como atestado de completude.

Terceiro erro: a questão do RNG some completamente. O baralho é embaralhado como? `Math.random()` do Node.js, que é determinístico e seedável de forma trivial? `crypto.randomBytes`? Algum esquema verificável tipo o que GGPoker publica como provably fair shuffle? Quando o artigo é sobre poker, RNG é a primeira pergunta. Quando o artigo é sobre "projeto legal em CLI", RNG nem aparece no texto.

O quarto erro é metaeditorial. Toda matéria termina com a mesma estrutura: descrição do projeto, link do GitHub, parágrafo sobre como "é interessante ver devs aplicando criatividade". É review de dev portfolio, não review de software de poker. A audiência implícita é outro dev que vai dar star no repositório — não é jogador que quer treinar push/fold equity em stack de 12bb.

E o quinto, talvez o mais comum: nenhuma matéria pergunta para que serve. CLI poker game existe em uma zona estranha. Não substitui PokerStars BR ou GGPoker para quem joga de verdade. Não substitui GTO+ ou PioSOLVER para quem estuda. Então qual é a proposta de valor real? Sem essa pergunta respondida, a matéria virou release.

O Que Quase Sempre Falta

A pergunta básica que falta em toda cobertura é a auditável. Este software calcula equity correta?

Math teardown. Considere a situação canônica: AsKs vs QhQd, all-in pré-flop, cinco cartas para vir. Equity correta calculada por PokerStove ou Equilab: AsKs tem 46.05% de equity. QQ tem 53.66%. Tie: 0.29%.

Um CLI poker game qualquer pode reportar "AK 50% vs QQ 50%" porque o autor codou um Monte Carlo com mil simulações e o intervalo de confiança a 95% nessa amostragem é largo. Calculado: σ = √(0.46 × 0.54 / 1000) = 0.0158, ou seja, 1.58% de desvio padrão. Intervalo a 95% (1.96σ): ±3.1%. Para reportar equity com precisão de meio ponto percentual, precisa de pelo menos 38.000 simulações. Para décimo de ponto: 950.000. Nenhuma matéria reporta o sample size do Monte Carlo. Nenhuma.

Nota: o evaluator clássico em C (Cactus Kev, depois Senzee) avalia 5 cartas em cerca de 30 nanossegundos. Em JavaScript, mesmo otimizado, o tempo sobe para 800ns–1.500ns por hand. Rodar 38.000 simulações para uma única equity decision toma 30ms a 60ms. Em CLI síncrono, isso é uma pausa perceptível. Toda matéria que li elogia a "instant response" sem perguntar se a resposta é matematicamente correta.

O que mais falta nessa cobertura:

Range play, não hand play. Poker real é jogado em ranges. AsKs vs QQ é academic. Na vida real, é "meu range de 3bet de SB" vs "o range de 4bet de BTN". CLI poker games tratam apenas hand-vs-hand. Reviews não notam essa limitação porque o reviewer típico não joga poker em range.

Posição e stack depth. Decisão de poker depende criticamente de posição e SPR. Em 200bb deep cash, 99 em UTG é open-fold em alguns ranges modernos. Em 12bb push-or-fold de torneio, 99 é jam em qualquer posição. O CLI game tipicamente roda em uma configuração fixa — 100bb cash, sem variação — e o review trata isso como completo.

Bet sizing. Poker pós-flop é definido por sizing. 1/3 pot, 2/3 pot, overbet, all-in — cada um carrega informação. CLI games oferecem sizing fixo ou três opções pré-definidas. Reviews descrevem como "limpo, minimalista, sem distração". Para um jogador real, é incompleto a ponto de inutilidade.

ICM, side pots, antes. Torneio tem antes (forced bets adicionais), side pots quando short stack vai all-in com adversários ainda no main, e ICM no late stage e no bubble. CLI poker games quase nunca implementam ICM. Reviews nunca perguntam. Ninguém testa o caso de borda em que três jogadores vão all-in com stacks de 1.000, 2.500 e 6.000 chips — o cálculo de side pots ali é onde 60% dessas implementações quebra silenciosamente.

O Que Eu Diria No Lugar

A pergunta que toda matéria sobre CLI poker game deveria abrir é uma só. Este software é curiosidade de dev ou é ferramenta com utilidade para um jogador? Os dois podem coexistir. Quase nunca coexistem. E identificar qual dos dois você está olhando muda tudo sobre o que vale a pena escrever.

Se é curiosidade de dev, o artigo deveria cobrir as escolhas técnicas — como o autor implementou o evaluator de 7-card hands (lookup table com 133.784.560 entradas? bit manipulation à la Cactus Kev? algum hash perfeito tipo o que o pokerai/OMPEval usa?), como tratou shuffle determinístico para reproduzibilidade vs não-determinístico para fairness, como serializou o estado do game para suportar replay e debug. Isso é interessante. Isso seria um artigo técnico decente sobre software, sem fingir que é sobre poker.

Se é ferramenta para jogador, a pauta é totalmente outra. A primeira pergunta da mesa: dá para treinar push/fold em 12bb com isso? Resposta direta: precisa do equity engine validado contra uma matriz Nash conhecida. O Nash push range para SB em 12bb é cerca de 27% de mãos (22+, A2s+, K6s+, Q8s+, J8s+, T8s+, 97s+, 86s+, 76s, A2o+, K9o+, Q9o+, J9o+, T9o), e o calling range de BB fica em torno de 27% também. Se o CLI game não bate essas ranges quando o solver dele converge, não serve para treinar push/fold.

Segunda pergunta da mesa: dá para treinar ICM em final table? Resposta: só se o software implementa ICM model (Malmuth-Harville ou ICMizer) explícito e mostra EV em $ por decisão, não em chips. Sem isso, treinar decisões de bubble no CLI poker game é literalmente treinar errado — o jogador aprende a fazer call profitable em chip EV que é losing em $EV.

Terceira pergunta: dá para registrar mãos e revisar? Hand history em formato compatível com PokerTracker ou Hand2Note muda o software de gimmick para ferramenta. Sem export de HH, o jogador joga uma mão, ganha ou perde, e perde o aprendizado.

A matéria que essa mesa escreveria mostraria três checagens. O evaluator rodando AsKs vs QhQd e reportando 46.05% — passou no teste básico, ou não. Um push/fold trainer com 12bb stack rodando mil mãos e a frequência de jam do bot — bateu Nash, ou desviou para qual lado. Um snapshot de hand history exportado em formato Stars — abre no Hand2Note, ou não.

Esses três testes resolvem em quinze minutos a única pergunta que importa. E aí o leitor sabe o que está comprando atenção, em vez de ler mais quinhentas palavras sobre como o autor escolheu o framework para parsear flags de CLI.

46.05%. Esse é o número. AsKs vs QhQd, equity correta, ferramenta de cinco linhas para verificar. Se o CLI poker game que você está avaliando reporta esse número dentro de meio ponto percentual do intervalo de confiança do Monte Carlo dele, a ferramenta passa no teste mínimo de honestidade matemática. Se reporta 50/50, ou 47/53, ou qualquer coisa que ignore a presença dos suited e a possibilidade de straight e flush para o AK, a ferramenta é jogo, não é poker. A decisão de gastar tempo com ela cai sobre esse número. Math fechado.

Perguntas frequentes

Um CLI poker game serve para treinar poker sério?

Quase nunca. Treino sério exige equity engine validado, ranges representáveis, ICM model para torneio e hand history exportável para análise pós-sessão. CLI poker games tipicamente implementam hand-vs-hand sem range play, com Monte Carlo de sample size não auditado e sem export de HH. Para treinar push/fold em 12bb ou bubble play em FT, ferramentas como GTO+, PioSOLVER ou ICMizer continuam sendo a opção honesta. CLI nesse formato é entretenimento de cinco minutos.

Como verifico se o equity engine do projeto está correto?

Rode AsKs vs QhQd all-in pré-flop algumas vezes em modo automático e verifique se a equity reportada para AK fica em torno de 46.05%. Esse é o benchmark canônico. Se reporta 50/50, ou se varia mais que um ponto percentual entre runs idênticos com seeds diferentes, o Monte Carlo está com sample size baixo demais ou o evaluator de 7-card está errado. Equilab e PokerStove servem como reference free.

Esse tipo de software é regulado pela SECAP no Brasil?

A questão não se aplica diretamente. CLI poker game offline, sem aposta em BRL, sem operador, não é objeto de regulação da Lei 14.790/2023 nem fica sob alcance da SECAP — não há contraparte comercial nem fluxo financeiro envolvido. A regulação brasileira de bets cobre operadores como PokerStars BR, GGPoker, Suprema Poker e H2 Club. Ferramenta solo em terminal, sem dinheiro real circulando, está fora do escopo do regulador.

Por que matérias técnicas sobre esses projetos viralizam tanto?

Porque o gancho narrativo "dev fez X em uma noite" performa bem em comunidades de desenvolvedor. A audiência valoriza o ato de construir, não a utilidade do produto. Isso não é crítica, é descrição. Significa apenas que o leitor que procura review de poker não vai encontrar análise técnica de poker nesses textos. Vai encontrar review de side project. São audiências diferentes lendo a mesma coisa por motivos diferentes, e os incentivos da plataforma reforçam o gancho do dev sobre o gancho do jogador.

Existe algum CLI poker tool que sirva para treinar?

Alguns trainers de equity rodam em terminal e têm valor real. Projetos baseados em `pokereval` (a lib clássica em C) ou em `treys` (Python) costumam ter evaluator confiável porque herdam math testada. O critério continua o mesmo: equity engine validado contra benchmark conhecido, range representável, e idealmente integração com solver. Quando o CLI tool é wrapper de uma lib séria, vale. Quando é evaluator implementado do zero por um dev em fim de semana, raramente vale para treino sério.

Posso usar um CLI poker game para aprender Texas Hold'em do zero?

Pode, mas com ressalvas grandes. Aprender as regras mecânicas — ordem de betting, hierarquia de mãos, estrutura de cada street — funciona em qualquer ambiente que implemente as regras corretamente. O problema aparece logo depois. Sem feedback de equity em tempo real, sem replay de mão e sem range visualization, o jogador iniciante absorve heurísticas erradas — "AJo é mão forte" — sem nunca ver a math por trás. Para o primeiro contato com as regras, serve. Para a segunda semana em diante, não.