Type the Change

Codex explores. You learn by making the change.

Ask about your project. A background Codex agent finds relevant code and explains the behavior. Open a suggestion to reach the exact lines, edit them yourself, run a check, and decide whether to keep the result.

Install · 한국어

Start

1. Open a project folder in VS Code.
2. Choose Type the Change in the activity bar, or press Cmd/Ctrl+Alt+T.
3. Describe a question or change and choose Send. You do not need to select files first.
4. Choose Explore the change, edit the selected source, and use Save & check.

The extension uses an installed Codex engine and its existing account. Choose Connect Codex if sign-in is needed. Codex app-server owns models, project exploration, tools, conversation history, and streaming. Explanations and progress stay inside Type the Change. The Codex desktop app or official IDE extension does not need to open.

Questions receive explanations first. Learn through this change requests a small practical step from the discussion. Matching the suggested text or passing a check never automatically accepts a change.

Settings

• Settings & tools → Language: follow VS Code, Korean, or English.
• Model selection is optional; the Codex catalog's default is used.
• Choose Codex executable supplies a path when automatic detection fails. The macOS desktop app's bundled runtime and Codex on PATH are detected automatically.
• Optional reference files, imported suggestions, and an offline editing/checking exercise are under Settings & tools.

Preview · VS Code 1.100+ · Local projects · Installed Codex required. Background Codex runs read-only. Learning suggestions support existing UTF-8 source files up to 64 KiB each. People make the edits and choose which checks to run.

Guide · Privacy · Verification · MIT

Contribute through issues. External PRs are not accepted; the repository owner performs the final review. Contributing

한국어

Codex가 살펴보고, 내가 고치면서 배웁니다.

프로젝트에 질문하면 백그라운드의 Codex가 관련 코드를 찾고 설명합니다. 변경 제안을 열면 실제 코드의 해당 줄로 이동합니다. 직접 수정하고 검사한 뒤, 결과를 보고 변경을 유지할지 판단합니다.

설치 · English

시작하기

1. VS Code에서 작업할 프로젝트 폴더를 여세요.
2. 왼쪽 Type the Change 아이콘이나 ⌘⌥T / Ctrl+Alt+T를 누르세요.
3. 질문이나 원하는 변경을 적고 보내기를 누르세요. 파일을 미리 고를 필요가 없습니다.
4. 변경 지점 보기를 눌러 해당 코드를 직접 고치고, 저장하고 검사로 확인하세요.

설치된 Codex 엔진과 로그인 상태를 사용합니다. 로그인이 필요하면 이 화면에서 Codex 연결을 누르세요. 모델 선택, 프로젝트 탐색, 대화와 응답은 Codex app-server가 처리하며, 진행 상황과 설명은 이 확장 안에 표시됩니다. Codex 앱이나 공식 VS Code 확장으로 이동할 필요가 없습니다.

질문은 먼저 설명으로 답합니다. 설명한 내용을 직접 연습하고 싶으면 이 변경으로 배워 보기를 누르세요. 제안의 코드가 일치하거나 검사가 통과했다는 이유만으로 변경을 자동 채택하지 않습니다.

설정

• 설정 및 도구 → 언어: VS Code 언어 따르기, 한국어, 영어.
• 모델을 고르지 않으면 Codex의 기본 모델을 사용합니다.
• Codex 실행 파일을 찾지 못하면 Codex 실행 파일 설정에서 위치를 지정하세요. macOS의 ChatGPT/Codex 앱에 포함된 실행기와 PATH의 Codex를 자동 탐색합니다.
• 참고 파일 첨부, 외부 수정안 가져오기, 로그인 없는 수정·검사 연습은 설정 및 도구에 있습니다.

미리보기 · VS Code 1.100+ · 로컬 프로젝트 · 설치된 Codex 필요. 백그라운드 Codex는 읽기 전용으로 실행됩니다. 학습 제안은 기존 UTF-8 소스 파일당 64 KiB까지 지원하며, 소스 변경은 사람이 수행합니다. 검사 작업 선택과 실행도 사람이 결정합니다.

사용법 · 개인정보 · 검증 · MIT

기여는 이슈로 받습니다. 외부 PR은 받지 않으며 최종 검토는 저장소 소유자가 합니다. 기여 정책

Guide

Open a project and choose Type the Change in the activity bar. Ask about the code or describe a task without selecting files first. Codex explores the project in the background and explains relevant locations.

Connect and ask

An existing Codex account is reused. If needed, choose Connect Codex, finish the managed browser sign-in, and return here. Codex owns account refresh and inference. The conversation remains inside Type the Change; opening another app or the official IDE extension is optional.

Text and activity appear incrementally. Stop or Escape interrupts the background task and preserves received text. Errors appear beside the request. New chat resets conversation and learning state while preserving your source edits.

Learn through a change

1. Request a change, or choose Learn through this change after an explanation.
2. Explore the change opens the real source and selects its exact location.
3. Read the suggestion and rationale, then edit the code yourself. Alternative implementations are allowed.
4. Choose Save & check, selecting an existing VS Code task.
5. Compare the result and diff, record your evidence, and keep, reject or defer the change.

The first check picker explains setting task.saveBeforeRun to never in the applicable scope. Only reviewed files are then saved by the explicit check action. Cancel and Compare only leave the preference unchanged. Neither text agreement nor a passing check proves correctness or understanding.

Learning proposals support existing UTF-8 files up to 64 KiB each. If the source changes before the suggestion is opened, request a fresh proposal. Codex exploration is not restricted to the active editor file.

Settings and recovery

Settings & tools contains language selection (automatic, Korean or English), optional references, an offline exercise, and imported suggestions. The Codex catalog's default model is used unless you choose another.

If Codex cannot be found, choose its executable or set the absolute typeTheChange.codexPath. Update Codex if its protocol cannot connect. On macOS the desktop app's bundled runtime is detected automatically. View task in Codex is an optional deep link; it is not the main learning flow.

To revoke the separate OAuth connection from an older extension version, run Type the Change: Disconnect Legacy ChatGPT Connection. This does not sign out Codex.

MCP

The existing optional MCP workflow remains available. MCP setup shows a configuration using the bundled local server and the current workspace. It handles local proposals/status, not inference. Use Open MCP suggestion to start learning from an arriving plan. See Privacy.

사용법

프로젝트를 열고 왼쪽 Type the Change 아이콘을 누릅니다. 파일을 선택하지 않고 질문이나 작업을 적어도 됩니다. 예를 들어 “해외 도메인을 추가하려면 어디를 바꿔야 할까?”라고 요청하면 Codex가 프로젝트를 살펴보고 관련 위치와 이유를 설명합니다.

연결과 대화

이미 Codex에 로그인했다면 기존 계정을 사용합니다. 연결이 필요하면 Codex 연결을 누르고 브라우저에서 로그인한 뒤 돌아오세요. 로그인과 토큰 갱신은 Codex가 처리합니다. 우리 화면에서 대화를 이어가며, 별도의 Codex 확장 설치나 앱으로의 이동은 필요하지 않습니다.

답변과 진행 상태는 도착하는 대로 나타납니다. 중단 또는 Esc를 누르면 백그라운드 작업을 끊고 받은 내용은 남깁니다. 오류는 요청 옆에 표시됩니다. 새 대화는 현재 학습·대화 상태를 비웁니다. 직접 수정한 코드는 유지됩니다.

코드를 바꾸며 배우기

1. 수정을 요청하거나, 설명 아래 이 변경으로 배워 보기를 누릅니다.
2. Codex가 준비한 변경 지점 보기를 누르면 실제 소스의 해당 부분이 선택됩니다.
3. 제안과 이유를 읽고 직접 코드를 고칩니다. 제안과 다른 구현을 해도 됩니다.
4. 저장하고 검사를 누르고 사용할 VS Code 검사 작업을 고릅니다.
5. 결과와 변경 내역을 비교하고, 근거를 적어 유지·거절·보류를 결정합니다.

검사 선택 시 task.saveBeforeRun을 never로 설정하는 범위를 안내합니다. 이후 검토 중인 파일만 저장합니다. 취소하거나 검사 없이 비교를 선택하면 이 설정은 변경하지 않습니다. 검사 통과나 글자 일치는 정답이나 이해의 증명이 아닙니다.

학습 제안은 파일당 64 KiB 이하의 기존 UTF-8 파일에 대한 작고 정확한 변경을 지원합니다. 변경을 여는 사이 소스가 달라지면 현재 코드로 다시 요청해야 합니다. Codex의 탐색 범위가 현재 파일 하나로 제한되지는 않습니다.

설정과 복구

설정 및 도구에서 언어(자동·한국어·영어), 참고 파일, 연습, 수정안 가져오기를 찾을 수 있습니다. 모델을 직접 선택하지 않으면 Codex의 기본 모델로 시작합니다.

Codex를 못 찾으면 Codex 실행 파일 설정에서 실행 파일을 선택하거나 VS Code의 typeTheChange.codexPath에 전체 경로를 지정하세요. 연결 형식 오류가 나면 설치된 Codex를 업데이트하세요. macOS ChatGPT 앱에 포함된 Codex도 자동 탐색합니다.

Codex에서 작업 기록 보기는 선택적인 딥링크입니다. 학습을 시작하거나 이어가는 데 이 링크를 누를 필요는 없습니다.

이전 버전에서 별도로 연결한 ChatGPT 계정을 해제하려면 명령 팔레트의 Type the Change: 이전 ChatGPT 연결 해제를 사용하세요. 현재 Codex 계정에는 영향을 주지 않습니다.

MCP

기존 MCP 연결도 사용할 수 있습니다. MCP 연결 설정에서 현재 프로젝트 경로와 번들 서버를 사용하는 구성을 확인하세요. MCP는 로컬 수정안과 상태만 다루며 모델을 호출하지 않습니다. 제안이 도착하면 MCP 수정안 열기로 학습을 시작할 수 있습니다. 개인정보

Privacy and local data

Type the Change has no application backend, analytics, advertising, or telemetry of its own.

Codex connection (0.6.0)

The extension launches an installed Codex app-server over local stdin/stdout. Codex owns sign-in, token storage and renewal, model selection, project exploration, tool execution, and provider requests under the account and configuration selected in Codex. The extension does not read Codex credential files or receive its tokens. It reads account availability through the app-server protocol, without displaying or logging account identity. Requests and project context inspected by Codex are subject to Codex's account, service, and data settings. Codex may persist local conversation history in its own storage.

The background learning thread uses Codex's read-only filesystem policy and declines requests to expand permissions or apply source changes. Codex sends small learning proposals through a local dynamic tool. The extension validates exact source anchors against current editor buffers and keeps the proposal in memory until the user opens it. Codex's project and instruction handling is distinct from the optional MCP server's narrower path rules below; source files may contain private data.

The extension holds the current conversation and pending suggestion in memory. The input draft stays in VS Code webview state. The selected model, language, optional Codex executable path, and check-task preference are stored using VS Code configuration/state. Optional reference-file selection reads filenames and performs a bounded search; it does not transmit source merely because a file is selected.

Versions 0.2–0.5 used an independent ChatGPT OAuth connection in VS Code SecretStorage. Those credentials are no longer used for generation. The legacy disconnect command remains available to revoke that connection and clear its local tokens; it does not sign out the shared Codex account. No credentials are migrated or copied into Codex. The old local account lock contains process metadata only.

Local files and MCP

The extension reads files needed for a plan and compares editor buffers. It never applies a proposed source change. The explicit Save and Check action saves the current editor contents of files in the review; unrelated dirty files are not saved. Comparison without a check does not save anything. Demo files are created in a temporary directory.

The optional MCP server can read bounded source files under the one workspace path you configure. The connected client chooses which files to request, so connect only a client you trust with that workspace. Its own data handling and model provider also apply. The server rejects path traversal, symlinks, protected credential paths, oversized files, and non-UTF-8 input. These checks do not guarantee that ordinary source files contain no secrets; choose the workspace accordingly.

The server writes code-containing plans to .type-the-change/plan.json. The extension writes dated progress metadata to .type-the-change/status.json. In 0.3.0 it also writes .type-the-change/review.json: the current session’s last 100 decision records, with your prediction, evidence, decision, step/file, buffer hash, and time. A new session replaces that journal when its first decision is recorded. Notes are not automatically sent to a model and are not included in MCP status responses. They may contain whatever private information you type; the directory should stay out of source control. A decision remains human-reported evidence. From 0.4.0, the journal may also contain separate task evidence: the selected task name, source hash, status, exit code, duration, and up to five bounded diagnostic messages. These are not sent to a model. The last chosen task fingerprint is stored in VS Code workspace state. The first check picker explicitly describes setting task.saveBeforeRun to never before it applies that workspace preference (or the user preference if no folder is open). This also affects other VS Code tasks in that scope; cancel and compare-only choices leave the preference unchanged. The extension runs a selected existing VS Code task only after an explicit action; the bundled demo has its own local check. A task can itself read files, run dependencies or use the network according to its project configuration. The extension does not capture the full terminal output or interpret an exit code as proof of correctness. These files are local, have restrictive permissions where supported, and can be removed when no session is active. Add .type-the-change/ to the project's Git ignore rules. The MCP server has no source-editing, shell execution, or direct model-inference tools.

Your VS Code autosave, backups, synchronization, other extensions, and normal save behavior remain under your control. The extension does not upload plan history to a separate service.

Verification

Version 0.6.0 passed 206 automated tests, 558 headless layout cases, and native VS Code editing/checking tests. A separate live Codex turn in a temporary read-only project streamed explanations and produced one validated learning step without changing its source. This is not a large-project performance benchmark or a complete live-account UI test.