ThreadPort for VS Code

ThreadPort keeps a project-owned development session when work moves between AI coding agents. It supports project initialization, persistent sessions, native Markdown session documents, relevant files, decisions, run history, verification, Git review, and agent switching from the editor.

Open the ThreadPort Activity Bar view and select New Session. Session creation opens as an editable Markdown document in VS Code's native text editor. Edit the objective, select an optional agent, and save the document.

Expand a session and select Agent, Relevant files, Decisions, or Runs. ThreadPort opens the persistent session as a normal Markdown document and moves the cursor to the selected section.

Write work under Next instruction, then press Ctrl+Enter (Cmd+Enter on macOS) or select Run instruction. ThreadPort records the task and either starts the selected agent or sends the instruction to the agent terminal already running for the session. CodeLens actions can stop or switch agents, preview the context, run project verification, and open native Git diffs.

Use ThreadPort: Add File to Context from the Explorer or editor menu. Select source code and use ThreadPort: Add Selection to Context to record a precise line range and its contents. The session document displays current Git changes, verification state, relevant files, decisions, runs, and recent timeline events.

Project data stays locally in .threadport/threadport.sqlite. Context handoff files are temporary and removed after the agent terminal closes.

Expand a session to check off Tasks, or right-click it to rename, finish or delete it. The view title bar offers Search, Draft Handoff, Link Issue or Pull Request and Privacy Audit. Select the ThreadPort status bar item for a quick menu; it follows the folder of the active editor. Changes made with the threadport CLI appear automatically.

Chat and MCP

ThreadPort registers an MCP server for each initialized folder, so VS Code chat agents can read the session context and record notes, tasks and decisions. VS Code asks before starting it. In the Chat view, ask @threadport about the active session, or use @threadport /context and @threadport /handoff.

Settings and trust

threadport.context.mode (minimal, standard, deep, full) sets the context detail level. When it is not set, the project default from threadport config set-default-mode applies.

In Restricted Mode, sessions remain readable and editable, but ThreadPort does not start agents or run verification commands until you trust the workspace. Project agent manifests run only after threadport plugin trust <id>.

Run ThreadPort: Show Logs to open the ThreadPort output channel when reporting a problem. The interface is available in English and French.

Requirements

• VS Code 1.105 or newer.
• At least one supported agent installed in the workspace environment: Claude Code or Codex CLI.
• Git is recommended for snapshots and native change review.

ThreadPort detects agents in the same environment as the extension host, including WSL, SSH remotes and Dev Containers.

Support

Report bugs and request features in the ThreadPort issue tracker. See SUPPORT.md for the information that helps diagnose a problem.

Development

From the repository root:

npm install
npm run check:extension
npm run build:extension

Open apps/vscode-extension in VS Code and press F5, or use the root launch configuration. The Extension Development Host displays the ThreadPort icon in the Activity Bar.