CORTEX v1.0.0 - INSTALLATION ET DÉMARRAGE RAPIDE

Cortex v1.0.0 est livré sous la forme d'une seule application Windows portable : cortex.exe. Les runtimes d'instrumentation x64 et x86 se trouvent dans le dossier runtime et sont sélectionnés automatiquement pour chaque cible. Rien d'autre ne doit être installé (ni Qt, ni runtime Visual C++).

INSTALLATION

1. Téléchargez l'archive :

   cortex-v1.0.0-windows-portable.zip
   

2. Extrayez l'intégralité de l'archive dans un dossier normal et inscriptible, par exemple :

   C:\Cortex\
   

3. Ne déplacez pas cortex.exe seul. Gardez le dossier runtime à côté de l'exécutable.

4. Lancez :

   .\cortex.exe
   

PREMIÈRE SESSION

1. Cliquez sur « Select process » dans l'en-tête (ou File > Select process...).
2. Sélectionnez la cible et cliquez sur Attach (ou double-cliquez sur la ligne).
3. Utilisez le panneau « Value scan » de l'espace de travail Memory pour scanner une valeur (First scan, puis Next scan).
4. Double-cliquez sur un résultat utile pour préparer une entrée Addresses.
5. Utilisez le menu contextuel d'une adresse pour accéder au Memory viewer, au Disassembler, RE, Pointer Maps, Structures ou aux actions du débogueur.
6. Les boutons Memory, Debug, RE, Trace, Automation et Runtime de l'en-tête réorganisent les espaces de travail pour chaque tâche.
7. Basculez le commutateur de l'en-tête de « Read-only » à « Writes allowed » uniquement lorsque vous prévoyez une opération qui modifie la cible ou l'état persistant.

MODES EN LIGNE DE COMMANDE

Aide :

   .\cortex.exe --help

Version :

   .\cortex.exe --version

Serveur MCP persistant via stdio (sans cible ; attachez depuis le client IA) :

   .\cortex.exe mcp

Attacher MCP à un PID ou à un processus au démarrage :

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

Exposer également les outils primitifs de bas niveau :

   .\cortex.exe mcp --tools all

Autres commandes intégrées :

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

CONTENU DE L'ARCHIVE

cortex.exe L'application Cortex (interface de bureau et modes CLI/MCP).

runtime\x64\cortex_core.dll Runtime d'instrumentation pour les cibles 64 bits.

runtime\x86\cortex_core.dll Runtime d'instrumentation pour les cibles 32 bits.

runtime\x86\cortex_runtime_helper.exe Assistant privé utilisé automatiquement pour les cibles 32 bits.

Vous ne choisissez jamais entre x64 et x86 : Cortex lit l'architecture
de la cible et utilise le runtime correspondant, y compris pour
« cortex.exe inject <pid> ».

README.md, CHANGELOG.md, LICENSE, docs Documentation, historique, licence et guides techniques.

DÉPANNAGE

• Si cortex.exe ne démarre pas, vérifiez que l'intégralité de l'archive a été extraite et que le dossier runtime est présent.
• Si une cible ne peut pas être ouverte, vérifiez son architecture et les droits Windows du processus. N'utilisez des privilèges élevés que lorsque la cible les exige.
• Si une opération d'écriture, de point d'arrêt ou de contrôle est refusée, basculez d'abord l'en-tête sur « Writes allowed ».
• Les paramètres et la disposition de la fenêtre sont enregistrés dans %LOCALAPPDATA%\Cortex. Pour les conserver à côté de cortex.exe à la place (clé USB, sandbox), créez un fichier vide nommé cortex.portable à côté de l'exécutable.
• En mode MCP, stdout est réservé au JSON-RPC pendant toute la session ; les diagnostics vont vers stderr.
• Consultez docs/getting-started.md, docs/ui-guide.md et docs/ui-walkthrough.md pour le workflow complet.

AUTORISATION

N'utilisez Cortex que sur des logiciels et systèmes que vous possédez ou que vous êtes autorisé à inspecter. Le contournement d'anti-triche, l'accès non autorisé et l'interférence avec des services en ligne sortent du cadre de ce projet.