Pensar Apex

Penetration testing basato sull'AI tramite agenti autonomi — direttamente nel tuo terminale. Esegui pentest blackbox e whitebox che esplorano, ragionano e fanno emergere vulnerabilità reali.

Vuoi eseguirlo dal cloud o integrarlo con la tua CI/CD? Consulta Pensar Console.

Casi d'uso

Sviluppatori

• Esegui /pentest prima di fare il merge di una PR — individua le vulnerabilità con la stessa naturalezza con cui esegui i test
• Ottieni risultati concreti con punteggi di gravità, evidenze e correzioni suggerite — senza bisogno di competenze in sicurezza
• Integra nella CI/CD tramite comandi CLI headless o Pensar Console

Ingegneri della sicurezza

• Distribuisci test swarm guidati da agenti su superfici d'attacco estese
• Usa la modalità /operator per indagini manuali, concatenazione di exploit e validazione
• Automatizza i flussi di test ripetitivi con una memoria persistente che si accumula tra i vari incarichi
• Scala su team e progetti tramite Pensar Console

Installazione

Metodo	Comando
Installazione rapida (macOS/Linux)	curl -fsSL https://pensarai.com/install.sh | bash
Homebrew	brew tap pensarai/tap && brew install apex
npm	npm install -g @pensar/apex
Windows (PowerShell)	irm https://www.pensarai.com/apex.ps1 | iex

Utilizzo

Apri la TUI di Apex:

pensar

Herdr

Apex segnala automaticamente il proprio stato quando viene avviato all'interno di Herdr. La barra laterale mostra working durante un turno, blocked quando sono necessarie approvazioni, revisione del piano o risposte, e idle quando Apex è pronto per l'input. Anche i comandi degli agenti CLI collegati al terminale segnalano la propria attività. Non è richiesto alcun plugin o configurazione aggiuntiva di Apex.

Herdr 0.9.2 o versioni successive può ripristinare la conversazione corrente dopo un riavvio del server. Mantieni pensar nel tuo PATH; Apex fornisce un comando di ripresa con l'ID della sessione, il modello attivo e l'impostazione di offuscamento. La sessione salvata ripristina la modalità operatore e le impostazioni di approvazione. Le sessioni ripristinate attendono il tuo prossimo prompt.

Puoi anche riaprire direttamente una sessione:

pensar --resume <session-id>
pensar --resume <session-id> --model <model-id>

La segnalazione dello stato e il rilascio funzionano anche con versioni precedenti di Herdr. Le segnalazioni vengono eseguite in background con un timeout breve, e i fallimenti di Herdr non interrompono Apex.

CLI headless

Esegui i pentest senza la TUI per scripting, CI o integrazione con evalgate:

# Basic pentest
pensar pentest --target https://example.com

# With extended thinking and task-driven mode
pensar pentest --target https://example.com --extended-thinking --task-driven

# Whitebox (with source code access)
pensar pentest --target https://example.com --cwd ./my-app

# Targeted pentest with specific objectives
pensar targeted-pentest --target https://example.com --objective "Test authentication bypass"

Flag	Comando	Descrizione
--target <url>	pentest, targeted-pentest	URL di destinazione (obbligatorio)
--cwd <path>	pentest	Percorso del codice sorgente per la modalità whitebox
--mode <mode>	pentest	exfil per pivoting ed estrazione di flag
--model <model>	pentest, targeted-pentest	Modello AI (predefinito: selezione automatica)
--extended-thinking	pentest	Abilita il pensiero esteso per i modelli supportati
--task-driven	pentest	Abilita l'architettura task-driven (sperimentale)
--prompt <text|@file>	pentest	Guida personalizzata per l'agente
--threat-model <text|@file>	pentest	Modello di minaccia per guidare i test
--objective <text>	targeted-pentest	Obiettivo di test (ripetibile)

Inferenza Hoonify

Connetti Hoonify in /providers o imposta HOONIFY_API_KEY, quindi seleziona un modello rilevato in /models. I comandi headless accettano --model-provider hoonify --model <catalog-model-id>. Consulta Configurazione di Hoonify per il rilevamento dei modelli, i budget di token e i controlli live.

Endpoint di inferenza personalizzati

Collega un endpoint compatibile con OpenAI e un bearer token tramite la configurazione customProviders o la variabile d'ambiente del worker APEX_CUSTOM_PROVIDERS. Selezionalo con --model-provider <id> --model <model>, oppure scegli i suoi modelli dichiarati nel selettore /models dell'operatore. Consulta configurazione dell'inferenza personalizzata per le impostazioni GLM, la configurazione dei job headless e un test di connessione live.

Logging

Apex instrada il logging diagnostico/operativo attraverso un logger strutturato centralizzato (src/core/logger). Scrive JSON su una riga su stderr quando l'output non è un TTY — mantenendolo separato dallo stdout del programma e facile da inviare a una pipeline di log (ad es. CloudWatch) — e un output leggibile e colorato in un terminale interattivo. L'output CLI/TUI rivolto all'utente rimane su stdout.

Imposta il livello (dal più → al meno verboso: debug < info < warn < error, predefinito info):

pensar pentest --target https://example.com --log-level debug   # or --verbose / --quiet
PENSAR_LOG_LEVEL=debug pensar ...                                # via environment
PENSAR_DEBUG=1 pensar ...                                        # back-compat alias for debug

Ordine di risoluzione: flag CLI → PENSAR_LOG_LEVEL → PENSAR_DEBUG → predefinito info. PENSAR_LOG_FORMAT=json|pretty forza il formato di output. Quando Apex viene eseguito come agente gestito, PENSAR_LOG_LEVEL è fornito dall'ambiente host.

Tracciamento W&B Weave