Codex Tabs

Open independent Codex editor tabs without replacing the existing new-chat tab.

This is an unofficial companion extension. It is not affiliated with or endorsed by OpenAI. The official Codex extension (openai.chatgpt) is required.

Open a new tab

Click + in the Codex editor toolbar or sidebar header. You can also click + Codex in the VS Code status bar. No keyboard shortcut to memorize.

The built-in Codex Tabs: Get Started walkthrough includes an illustration of the interface and clickable setup buttons.

Optional shortcut: Ctrl+Alt+N (macOS: Cmd+Option+N). The command is Codex Tabs: New Codex Tab.

To use a different shortcut, open Keyboard Shortcuts and search for codexTabs.newTab. No existing Ctrl+K shortcuts are overridden by default.

Each invocation opens a persistent tab with a distinct document identity. Agent usage in each chat is billed or counted by Codex normally; this helper does not call a model.

Experimental tab status

This feature is off by default. It requires an internal hook in the installed Codex extension. Enable it only if you accept the compatibility limitations below.

1. Choose Enable Task Status in the first-install message, or click the check button in the Codex toolbar.
2. Review the disclosure and choose Enable Task Status.
3. Reload VS Code.

Tab icons show a blue animated progress indicator, a green completion check, a red failure indicator, or a yellow interruption indicator. Completion means the Codex turn ended successfully, not that the code is correct or the whole project is finished.

Supported internal bridge version: Codex 26.930.21537. Other versions are refused without modifying their source. Status logic has automated tests, but broader platform and live-session testing is still pending. Missing events or unmapped sessions may leave an idle icon; the extension does not guess a session's identity.

Codex updates may remove the hook. Run the enable command again only for a supported version. Source backups are saved in the helper's VS Code global storage. To remove the hook, run Codex Tabs: Remove Task Status before uninstalling. Removal deletes only this extension's exact hook and preserves other source changes.

Introduction

Enabling the status integration also enables codexTabs.hideIntro to mark the informational introduction as viewed. It does not change authentication, permission or approval settings. Turning this option off does not reset an introduction already marked as completed.

Completion sound

Click the speaker button in a Codex tab to turn completion sound on or off, or set codexTabs.completionSound. It is off by default and requires the experimental status integration. A sound plays once when a tracked response finishes successfully. Failures and interruptions do not play the completion sound. Your system's volume and mute settings apply.

Run Codex Tabs: Test Sound to hear it. Windows uses the system Asterisk sound; macOS uses Ping. Linux needs canberra-gtk-play to be installed. No prompt or response content is passed to the sound player.

Privacy and performance

No telemetry, network requests, model calls, API keys, or payment processing. The optional bridge observes local session IDs and lifecycle events; it does not intentionally log prompts or responses. Animation runs locally while a tracked turn is active.

Marketplace acquisition counts and ratings can be reviewed by the publisher. This extension does not collect daily active users or how many tabs you open.

Compatibility and support

Desktop VS Code only. Remote extension layouts, browser-based VS Code, and virtual or untrusted workspaces are not validated. Independent tabs use an internal Codex URI route and may require updates if Codex changes that route.

Use Codex Tabs: Show Diagnostics for version and connection information. Avoid posting tokens, prompt content, source code, or full Codex logs when reporting issues.

한국어 안내

Codex 탭의 도구 모음이나 사이드바 제목 옆의 + 버튼으로 새 탭을 엽니다. 화면 아래 + Codex 버튼도 사용할 수 있어 단축키를 외울 필요가 없습니다.

설치 후 안내에서 작업 상태 표시 켜기를 선택하고 VS Code를 다시 불러오면 상태 아이콘과 시작 안내 숨기기가 함께 설정됩니다. 단축키는 선택 사항이며 기본값은 Ctrl+Alt+N입니다.

작업 상태 표시는 기본으로 꺼져 있습니다. 실험 기능을 켜면 설치된 Codex 확장에 연결 코드가 추가되며, 원본이 백업됩니다. Codex 업데이트 후에는 연결이 끊길 수 있습니다. 삭제 전 복구 명령을 실행하세요.

이 보조 확장 자체는 모델을 호출하지 않으므로 추가 토큰을 사용하지 않습니다. 각 탭의 Codex 작업 사용량은 평소처럼 발생합니다.

Codex 탭의 스피커 버튼으로 응답 완료 알림음을 켜고 끌 수 있습니다. 기본은 꺼짐이며 작업 상태 표시 기능이 필요합니다. 정상적으로 끝난 응답에 한 번 울리고, PC 음량 및 무음 설정을 따릅니다.