CORTEX v1.0.0 - INSTALAÇÃO E INÍCIO RÁPIDO

O Cortex v1.0.0 é distribuído como uma única aplicação portátil para Windows: cortex.exe. Os runtimes de instrumentação x64 e x86 residem na pasta runtime e são selecionados automaticamente para cada alvo. Nada mais precisa ser instalado (sem Qt, sem runtime do Visual C++).

INSTALAÇÃO

1. Baixe o arquivo:

   cortex-v1.0.0-windows-portable.zip
   

2. Extraia todo o arquivo para uma pasta normal e gravável, por exemplo:

   C:\Cortex\
   

3. Não mova o cortex.exe sozinho. Mantenha a pasta runtime ao lado do executável.

4. Execute:

   .\cortex.exe
   

PRIMEIRA SESSÃO

1. Clique em "Select process" no cabeçalho (ou File > Select process...).
2. Selecione o alvo e clique em Attach (ou dê um duplo clique na linha).
3. Use o painel "Value scan" do workspace Memory para escanear um valor (First scan, depois Next scan).
4. Dê um duplo clique em um resultado útil para preparar uma entrada em Addresses.
5. Use o menu de contexto de um endereço para ir ao Memory viewer, ao Disassembler, RE, Pointer Maps, Structures ou ações do depurador.
6. Os botões Memory, Debug, RE, Trace, Automation e Runtime no cabeçalho reorganizam os workspaces para cada tarefa.
7. Alterne o toggle do cabeçalho de "Read-only" para "Writes allowed" apenas quando pretender uma operação que altere o alvo ou o estado persistente.

MODOS DE LINHA DE COMANDO

Ajuda:

   .\cortex.exe --help

Versão:

   .\cortex.exe --version

Servidor MCP persistente via stdio (sem alvo; anexe a partir do cliente de IA):

   .\cortex.exe mcp

Anexar o MCP a um PID ou a um processo na inicialização:

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

Também expor as ferramentas primitivas de baixo nível:

   .\cortex.exe mcp --tools all

Outros comandos integrados:

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

O QUE HÁ NO ARQUIVO

cortex.exe A aplicação Cortex (interface desktop e modos CLI/MCP).

runtime\x64\cortex_core.dll Runtime de instrumentação para alvos de 64 bits.

runtime\x86\cortex_core.dll Runtime de instrumentação para alvos de 32 bits.

runtime\x86\cortex_runtime_helper.exe Helper privado usado automaticamente para alvos de 32 bits.

Você nunca escolhe entre x64 e x86: o Cortex lê a arquitetura do alvo
e usa o runtime correspondente, inclusive para
"cortex.exe inject <pid>".

README.md, CHANGELOG.md, LICENSE, docs Documentação, histórico, licença e guias técnicos.

SOLUÇÃO DE PROBLEMAS

• Se o cortex.exe não iniciar, verifique se todo o arquivo foi extraído e se a pasta runtime está presente.
• Se um alvo não puder ser aberto, verifique sua arquitetura e os direitos do processo no Windows. Use privilégios elevados apenas quando o alvo exigir.
• Se uma operação de escrita, breakpoint ou controle for recusada, alterne o cabeçalho para "Writes allowed" primeiro.
• As configurações e o layout da janela são salvos em %LOCALAPPDATA%\Cortex. Para mantê-los ao lado do cortex.exe em vez disso (pen drive, sandbox), crie um arquivo vazio chamado cortex.portable ao lado do executável.
• No modo MCP, o stdout é reservado para JSON-RPC durante toda a sessão; os diagnósticos vão para stderr.
• Consulte docs/getting-started.md, docs/ui-guide.md e docs/ui-walkthrough.md para o fluxo de trabalho completo.

AUTORIZAÇÃO

Use o Cortex apenas em softwares e sistemas que você possui ou está autorizado a inspecionar. Bypass de anti-cheat, acesso não autorizado e interferência em serviços online estão fora do escopo deste projeto.