Mention at Codex

Mention at Codex

Overview • Motivation • Features • Packages • Commands • Usage • License

🎺 Overview

Mention at Codex links a VS Code terminal running Codex to the active editor, then inserts the current file or selected line range as a Codex @ mention with one shortcut.

❓ Motivation

Codex can use file mentions, but typing paths and line ranges by hand interrupts the editing loop. I wanted the editor to send the exact file context into the right Codex terminal, keep focus where the prompt is being written, and avoid copying paths manually.

⭐ Features

Insert @path/to/file from the active VS Code editor
Include single-line and multi-line selections as #L10 or #L10-20
Auto-link one live Codex terminal and show link state in the status bar
Install a Codex session hook only after asking
Switch the linked terminal by typing ide inside the Codex session
Keep handshake files local with private file permissions where supported

📦 Packages

Package	Repo	Download
VS Code extension	`mention-at-codex`

🧰 Commands

Mention at Codex: Insert At-Mentioned
Mention at Codex: Setup Codex Integration
Mention at Codex: Uninstall Codex Integration
Mention at Codex: Show Logs

📖 Usage

Insert Mentions

Press cmd+alt+k on macOS or ctrl+alt+k on Linux and Windows while the editor is focused.

No selection:          @path/to/file
Single-line selection: @path/to/file#L10
Multi-line selection:  @path/to/file#L10-20

The mention is typed into Codex without pressing Enter. Focus moves to the linked Codex terminal.

Link Codex

Open a new VS Code terminal after the extension activates, then start Codex in that terminal. The extension injects a session id into new terminals, the Codex hook writes a local handshake file, and the extension matches that handshake back to the right VS Code terminal.

Only one Codex terminal is linked at a time. To switch while another Codex session is still alive, type ide inside the Codex terminal you want to bind.

Uninstall Integration

Run Mention at Codex: Uninstall Codex Integration, then uninstall the VS Code extension.

📜 License

MIT

lucasvtiradentes