CORTEX v1.0.0 - INSTALLAZIONE E GUIDA RAPIDA

Cortex v1.0.0 viene distribuito come singola applicazione Windows portatile: cortex.exe. I runtime di strumentazione x64 e x86 si trovano nella cartella runtime e vengono selezionati automaticamente per ciascun target. Non è necessario installare nient'altro (né Qt, né Visual C++ runtime).

INSTALLAZIONE

1. Scarica l'archivio:

   cortex-v1.0.0-windows-portable.zip
   

2. Estrai l'intero archivio in una cartella normale e scrivibile, ad esempio:

   C:\Cortex\
   

3. Non spostare cortex.exe da solo. Mantieni la cartella runtime accanto all'eseguibile.

4. Esegui:

   .\cortex.exe
   

PRIMA SESSIONE

1. Clicca "Select process" nell'intestazione (o File > Select process...).
2. Seleziona il target e clicca Attach (o fai doppio clic sulla riga).
3. Usa il pannello "Value scan" dell'area di lavoro Memory per scansionare un valore (First scan, poi Next scan).
4. Fai doppio clic su un risultato utile per preparare una voce in Addresses.
5. Usa il menu contestuale di un indirizzo per passare al Memory viewer, al Disassembler, RE, Pointer Maps, Structures o alle azioni del debugger.
6. I pulsanti Memory, Debug, RE, Trace, Automation e Runtime nell'intestazione riorganizzano le aree di lavoro per ciascuna attività.
7. Passa l'interruttore dell'intestazione da "Read-only" a "Writes allowed" solo quando intendi eseguire un'operazione che modifica il target o lo stato persistente.

MODALITÀ DA RIGA DI COMANDO

Aiuto:

   .\cortex.exe --help

Versione:

   .\cortex.exe --version

Server MCP persistente su stdio (senza target; connettiti dal client AI):

   .\cortex.exe mcp

Collega MCP a un PID o a un processo all'avvio:

   .\cortex.exe mcp --pid 1234
   .\cortex.exe mcp --process game.exe

Espone anche gli strumenti primitivi di basso livello:

   .\cortex.exe mcp --tools all

Altri comandi integrati:

   .\cortex.exe probe --pid 1234
   .\cortex.exe diagnose --pid 1234
   .\cortex.exe analyze <directory>
   .\cortex.exe symbolize [options]
   .\cortex.exe inject <target> [dll]

COSA CONTIENE L'ARCHIVIO

cortex.exe L'applicazione Cortex (interfaccia desktop e modalità CLI/MCP).

runtime\x64\cortex_core.dll Runtime di strumentazione per target a 64 bit.

runtime\x86\cortex_core.dll Runtime di strumentazione per target a 32 bit.

runtime\x86\cortex_runtime_helper.exe Helper privato usato automaticamente per i target a 32 bit.

Non scegli mai tra x64 e x86: Cortex legge l'architettura del target
e usa il runtime corrispondente, anche per
"cortex.exe inject <pid>".

README.md, CHANGELOG.md, LICENSE, docs Documentazione, cronologia, licenza e guide tecniche.

RISOLUZIONE DEI PROBLEMI

• Se cortex.exe non si avvia, verifica che l'intero archivio sia stato estratto e che la cartella runtime sia presente.
• Se un target non può essere aperto, controlla la sua architettura e i diritti Windows del processo. Usa privilegi elevati solo quando il target li richiede.
• Se un'operazione di scrittura, breakpoint o controllo viene rifiutata, passa prima l'intestazione su "Writes allowed".
• Le impostazioni e il layout della finestra vengono salvati in %LOCALAPPDATA%\Cortex. Per tenerli accanto a cortex.exe (chiavetta USB, sandbox), crea un file vuoto chiamato cortex.portable accanto all'eseguibile.
• In modalità MCP, stdout è riservato a JSON-RPC per l'intera sessione; la diagnostica va su stderr.
• Vedi docs/getting-started.md, docs/ui-guide.md e docs/ui-walkthrough.md per il flusso di lavoro completo.

AUTORIZZAZIONE

Usa Cortex solo su software e sistemi di tua proprietà o che sei autorizzato a ispezionare. Il bypass di anti-cheat, l'accesso non autorizzato e l'interferenza con servizi online sono al di fuori dello scopo di questo progetto.