GitHub announced on November 16, 2026 that Visual Studio Code 1.146 deprecates the Local harness, the older software that coordinates the model, context and tools for GitHub Copilot agent sessions in the editor. The Local harness will be removed in February 2027. To move, start a new chat or Agents session, open Session Target, select Copilot, and then review your customizations before the removal.
This guide covers who is affected, how to check which harness you use, and the migration steps and admin settings that GitHub and the VS Code documentation describe. Nothing here was run on a live installation; see "What we checked" for the details.
What the Local harness retirement is
A harness is the layer that runs an agent session: it coordinates the model, the context and the tools. VS Code's documentation lists several: Copilot, Local, Claude, Codex, and Cloud. Cloud is described as an execution target rather than a separate harness. The Local harness runs in VS Code's built-in harness and extension host; the documentation says sessions stop when the editor window closes and that it is available only in the Chat view, not in the Agents window.
According to the announcement:
- VS Code 1.146 deprecates the Local harness.
- It will be removed in February 2027, with a three-month transition period during which it stays available where organization policy permits.
- The Copilot harness has been the default for new sessions since VS Code 1.143.
- The replacement is the Microsoft Copilot harness, built into VS Code on the Copilot SDK, sharing its coding-agent runtime with Copilot CLI and the GitHub Copilot app.
The harness is separate from the model and from where code runs. The VS Code migration page states that choosing a Claude model does not switch harnesses, and choosing Copilot does not move files to the cloud.
What the Copilot harness adds, per the VS Code migration page: local sandboxing for builds, tests and commands within configured file system and network boundaries; Copilot Fusion, which selects models and coordinates drafting and review; delegating tasks in the Agents window and continuing the same session in the editor; assisted permissions; and, as preview or experimental features, Copilot connectors, canvases and cloud sessions.
Who it affects and availability
| Group | Effect, per the official pages |
|---|---|
| Individual VS Code users on Local | Move to the Copilot harness before February 2027; review customizations for compatibility. |
| Teams with prompt files, hooks, MCP servers or custom agents | Switching harnesses does not automatically convert every customization. |
| VS Code administrators | Review any vscode.temporaryDefaultToLocalHarness exception; it is removed with the Local harness. |
| Organizations needing enforced sandbox and permission rules | These can be enforced only on the Copilot harness. |
Existing Copilot plans work, including Copilot Free, according to the announcement. It adds that feature availability depends on your plan, settings and organization policy. The announcement and the pages we opened did not list a separate price for the Copilot harness, and we did not find any region restriction. The announcement does not say which countries are covered, so check your organization policy rather than assuming.
Requirements
- VS Code version: Local is deprecated in 1.146. The Copilot harness has been the default for new sessions since 1.143, and the enterprise-managed settings below apply on 1.143 or later.
- Account: sign in with your approved Copilot account. VS Code's page says to update to the approved VS Code release first.
- No separate install: the VS Code FAQ says no separate Copilot CLI or SDK install is needed.
- Admin settings: the managed settings must be set as enterprise-managed settings, not user or workspace settings.
- Desktop app running: for local sessions the Agent Host must keep running, so do not quit VS Code or shut down the machine.
How to check whether you're affected
- Open the Chat view or the Agents window and look at the active harness. VS Code's harness page says to check the chat title prefix (editor), the chat input watermark (Agents window) or the session list tooltip.
- Open Session Target in a new chat. If you still pick Local, you are on the deprecated harness. The control only lists targets whose requirements are met in the current window.
- Look for Local-specific customizations. The migration pages name these: prompt files (
*.prompt.md), hooks, tool sets (.toolsets.jsonc), chat participants, workspace MCP servers in.vscode/mcp.json, and agents or instructions kept in the profile's user data. - Administrators: check whether
vscode.temporaryDefaultToLocalHarnessorvscode.temporaryAllowLocalHarnessis set, and run Developer: Policy Diagnostics from the Command Palette to see effective values.
How to migrate to the Copilot harness, step by step
Individual users
- Back up or commit your customization files and settings. VS Code warns that original and migrated copies do not sync.
- Pick a small task that works on Local and write down its expected result, tools and approvals, so you can compare later.
- Open the Chat view or the Agents window.
- Select New Chat (
+) in the Chat view, or New in the Agents window, and select your project. - Open Session Target and select Copilot. You must choose the harness before your first prompt; changing the model or agent does not change it.
- Select an available model and agent. The built-in Copilot agents are Ask, Agent and Plan.
- To reduce routine approval prompts, open the permissions picker in the chat input and select Assisted permissions. Calls the risk assessment does not approve still need confirmation.
To continue an existing Local conversation, open it and select Session Target > Copilot in its chat input. History and context carry over, but this is not a two-way switch. VS Code's page also says you can use Open in Agents in the editor and Open in Editor in the Agents window.
Migrate your customizations
- With Session Target set to Copilot, select Review Migrations when prompted, or run Chat: Open Customizations from the Command Palette and select Migrations.
- Review the detected groups. Migrate performs the supported file moves and conversions. Migrate with Agent (experimental) starts an agent-led chat for semantic changes and uses Copilot credits.
- Start a new Copilot session and confirm your items appear in the Agent Customizations editor.
- Repeat your test task, check tool activity and approvals, make sure the old and new copies are not both active, then commit workspace changes and remove old files.
What each customization does, according to the migration page:
| Customization | Source | Result |
|---|---|---|
| MCP servers (workspace) | .vscode/mcp.json | .mcp.json at the workspace root |
| MCP servers (profile) | Profile mcp.json | $COPILOT_HOME/mcp-config.json, or ~/.copilot/mcp-config.json if COPILOT_HOME is unset |
| Prompt files | *.prompt.md | Skills, with disable-model-invocation: true added; agent, model and tools selections are not preserved |
| User agents and instructions | Profile user data | ~/.copilot/agents, ~/.copilot/instructions; not part of Settings Sync |
| Hooks | Various | Manual only |
Points that often catch people:
- MCP: migration adds
tools: ["*"], which you should narrow. Password inputs, command inputs,cwd,envFileand VS Codeoauthobjects do not convert. Replace secret prompts with environment-variable references such as${SERVICE_API_KEY}and never paste literal credentials. - Hooks: configuration and scripts must both be rewritten. Event names change, for example
PreToolUsebecomespreToolUseandStopbecomesagentStop; standalone files needversion: 1, and commandpreToolUseerrors deny the tool. Test the script directly with sample stdin and in a disposable session. - Tool sets and chat participants: deprecated in Copilot; replace with custom-agent
toolslists, plugins, MCP servers or direct requests. - Subagents: Local's
runSubagentbecomes the Copilot harness'stasktool. - Memory: Copilot Memory is separate from Local memory files and is not converted.
Administrators
- Pilot first, including Remote SSH, WSL and Dev Containers where you use them. VS Code says remote and container sandbox prerequisites differ.
- To require the Copilot harness on VS Code 1.143 or later, use enterprise-managed settings (not user or workspace settings):
temporaryAllowLocalHarness: false(this prohibits Local, Claude and Codex) andtemporaryDefaultToLocalHarness: false. - To encourage without requiring, set the
ChatEditorPreferCopilotHarnessdevice policy totrue. - Optionally set
modelto"auto"and afusionTierof"standard","high"or"max". VS Code says these are starting defaults, not restrictions. - Configure permissions and sandboxing separately. Requiring the harness does not enable them, although nonempty managed
permissions.denyrules orsandbox.enabled: truealso route to the Copilot harness from 1.143. - After deployment, start a new editor chat and Agents session, confirm the harness and model, and run Developer: Policy Diagnostics. In a Copilot session, run
/sandbox policyto see the sandbox state, file access and network restrictions.
Limitations, testing and rollback
- Temporary fallback only: per VS Code's page, you can select Local under Session Target in the editor for a new session, but not in the Agents window. Administrators can set
vscode.temporaryDefaultToLocalHarnesstotrue, but this does not overridevscode.temporaryAllowLocalHarness: falseand does not restore Claude or Codex. It is a blocker-only measure, and the announcement says it ends with the removal. - Security gap on Local: the harness page says Local does not enforce runtime-only sandbox and permission rules, and SDK Policy Hooks do not load in it. An administrator must accept that gap before allowing the fallback.
- Not every tool exists on Copilot: not all built-in or extension tools are available, and extension tools need an editor window where the extension runs.
- Session continuity: local Agent Host sessions need desktop VS Code to keep running; closing a window is different from quitting the app.
- Experimental pieces: cloud sessions, mixed-harness chats, computer use and the customization migration feature are labeled experimental or preview.
- Rollback: VS Code's migration page has no dedicated rollback procedure. The closest guidance is to keep customization backups until migrated results are verified and to remove any temporary Local exception before February 2027.
Suggested test list, from VS Code's verification checklist: run a representative task and check the edits, command results and tests; confirm customizations load and required tools are available; run Developer: Policy Diagnostics; test one approved and one policy-blocked operation on a disposable path; repeat on remote hosts and containers.
Privacy and admin notes
- Where code runs: the announcement says selecting the Copilot harness does not move your files to the cloud. Cloud sessions are a separate, experimental Session Target.
- Approvals vs. sandboxing: VS Code's approvals page lists three permission levels on the Copilot harness: Manual permissions (the default), Assisted permissions ("Uses an LLM judge to assess each tool call") and Allow all. Sandboxing is independent of the level, and an enabled sandbox still restricts terminal file system and network access under Allow all.
- Sandbox status: preview on macOS, Linux and WSL2, experimental on Windows, per the approvals page. Restart VS Code after changing the network filter settings it lists.
- Enterprise controls: organizations can set a managed default permission level; policy-blocked levels stay visible but disabled. Claude and Codex harnesses are disabled when Copilot enterprise-managed settings apply.
- Telemetry: OpenTelemetry is available for both harnesses, but VS Code says to verify the exporter, capture settings and attributes after switching.
- Training data: we did not find a statement about model training on these pages, so we make no claim either way.
- Support: VS Code's page points to your AI enablement or IT team for policy, the VS Code Issue Reporter for bugs, and GitHub Support for Business and Enterprise customers. Remove credentials and sensitive policy details before sharing logs.
For related context, see our posts on GitHub Copilot model deprecation in December 2026 and Copilot connectors.
What we checked
- Opened the GitHub Changelog announcement dated November 16, 2026 on 2026-11-17: Local deprecated in VS Code 1.146, removal in February 2027, Copilot harness default since 1.143.
- Opened VS Code's "Move from the Local to the Copilot Harness" page on 2026-11-17: the February 2027 removal and the enterprise-managed settings match the announcement.
- Cross-checked the Session Target labels (Copilot, Local, Claude, Codex, Cloud) between the agent harnesses page and the migration page.
- Cross-checked
vscode.temporaryDefaultToLocalHarnessandvscode.temporaryAllowLocalHarnessacross the announcement, the migration page and the customization migration page. - Opened the customization migration and approvals pages on 2026-11-17 for the file paths, hook event mapping and permission level names quoted above.
- The announcement gives no exact day in February 2027, and the pages we opened do not either; we did not guess one.
- Not tested in a live VS Code installation or organization; steps follow the official pages as of 2026-11-17, and the migration feature is labeled experimental.
Last tested: 2026-11-17
Sources
- GitHub Changelog, "VS Code retires the Local harness in February 2027": https://github.blog/changelog/2026-11-16-vs-code-retires-the-local-harness-in-february-2027
- Move from the Local to the Copilot harness: https://code.visualstudio.com/docs/agents/run/move-to-copilot
- Agent harnesses in VS Code: https://code.visualstudio.com/docs/agents/run/agent-harnesses
- Copilot harness customization migration: https://code.visualstudio.com/docs/agent-customization/migrate-customizations
- Permission levels and approvals: https://code.visualstudio.com/docs/agents/run/approvals
Comments
Questions and tips are welcome. Comments are checked by the EpiFive team before they appear; please do not share passwords, phone numbers or other private details.