Skip to content

Agent Architecture

JetBrains Copilot

GitHub Copilot in JetBrains IDEs is an IDE-plugin host row. It belongs beside, but not inside, VS Code Copilot and Copilot CLI because JetBrains owns the plugin runtime, editor UI, tool windows, authentication, and IDE-specific availability.

Source reviewed #24Checked 2026-07-06
Run type
Extension
Adapter
json-stdio
Source
Closed / product homepage
Stars
Frontier

Archive Context

This page is one host entry inside the full architecture archive and keeps multi-surface products visible instead of collapsing them into a single run type.

42 host archive
Host page
jetbrains-copilot
Run cohort
Extension: 4
Archive route
/agents

Host Surface Perspectives

The host is the primary architecture boundary. Each runnable surface below separates what the host owns from what agent-connector can safely install for JetBrains Copilot.

1 surface entry

Extension

extension
Host entry
An IDE extension host runs inside VS Code, JetBrains, or another editor and receives workspace/editor context through that host's extension APIs.
Host owns
The editor owns activation, command palette placement, sidebar/chat UI, extension storage, trust prompts, and workspace permission boundaries.
Connector role
agent-connector targets documented extension-readable config, MCP, commands, skills, rules, and memory files without claiming control of the IDE. Current wired connector surfaces: MCP server, Hooks, Commands, Skills, Memory.
Implementation consequence
Extension surfaces must distinguish file-backed connector artifacts from UI affordances that only the editor or marketplace extension can expose. No visible host-native gap is currently tracked for this surface.

Verified Architecture

Source-checked on 2026-07-06. These notes are intentionally separate from the generated surface matrix below.

Sequence #24

Source pass

Current source review findings are kept as the first architecture section so readers can separate external evidence from the generated local coverage model.

  • GitHub Copilot's official product page positions Copilot across editor and enterprise workflows, with agents, Copilot CLI, and VS Code explicitly called out.
  • The JetBrains row is therefore an IDE integration surface for Copilot, not the Copilot CLI and not the VS Code Copilot extension row.
  • Copilot guidance emphasizes developer oversight and review, so agent-connector should avoid treating suggestions as autonomous hook/action execution.

Runtime boundary

The adapter target is the JetBrains plugin environment. JetBrains owns IDE lifecycle, editor APIs, project model, tool windows, plugin settings, and authentication UI, while GitHub owns Copilot service behavior.

  • This row is distinct from VS Code Copilot because the extension host and storage model differ.
  • It is also distinct from Copilot CLI because the CLI session harness runs outside the IDE.
  • The GitHub docs list Copilot in JetBrains as its own agent concept surface.

MCP registration

MCP support for JetBrains Copilot should not be assumed from VS Code Copilot or Copilot CLI. The page should only claim MCP when GitHub or JetBrains documentation exposes a JetBrains-specific configuration path.

  • IDE-specific plugin settings may differ from VS Code settings JSON or Copilot CLI config.
  • MCP in Copilot cloud or CLI does not automatically imply JetBrains plugin support.

Hook bridge

The current connector matrix treats JetBrains Copilot conservatively. GitHub's broader Copilot platform documents hooks, but a JetBrains plugin hook bridge requires JetBrains-specific implementation evidence.

  • GitHub Copilot SDK hooks are not the same as JetBrains plugin hooks.
  • Editor actions and tool windows are host UI, not lifecycle hook files.

Content surfaces

JetBrains Copilot content surfaces include IDE chat, code suggestions, project context, GitHub authentication, and potentially custom instructions or agent features as GitHub exposes them to the plugin.

  • JetBrains project model and indexing differ from VS Code workspace context.
  • Any repository instruction support should be verified through GitHub's IDE-specific docs.

Marketplace and host-only affordances

The host-only affordance is JetBrains Marketplace distribution and deep integration with IntelliJ-platform IDEs. The archive should show it as an extension/IDE host rather than a terminal or GitHub cloud agent.

  • Marketplace installation, IDE compatibility, and plugin versioning are central support facts.
  • Copilot service features may arrive at different times across JetBrains, VS Code, CLI, and GitHub web.

Host-specific shape

JetBrains Copilot is an IDE-extension host: MCP, json-stdio hooks, commands, skills, and memory are tracked, while subagent, statusline, and action surfaces are not confirmed.

  • Form factor: Extension.
  • Native surfaces: MCP server, Hooks, Commands, Skills, Memory.
  • Wired surfaces: MCP server, Hooks, Commands, Skills, Memory.
  • Visible gaps: none.

Hooks

Hooks enter through a host-launched command that exchanges event JSON over stdio.

MCP

The adapter writes this host's native MCP registration dialect, including its root key, scope, transport fields, and environment syntax.

Memory

Managed memory text is written into the rules or memory file this host actually reads, with ownership markers for reversible uninstall.

Marketplace and affordances

Current install is a direct native-file write path; any package artifact is manual unless a driver is added.

  • Runtime handlers: none.
  • User-visible affordances: Users see managed commands + skills + memory surfaces after install; runtime-only surfaces stay behind the host boundary..

Known Limits

  • Do not inherit VS Code or Copilot CLI storage paths.
  • Do not claim hooks or MCP without JetBrains-specific evidence.
  • Distinguish JetBrains plugin runtime from GitHub Copilot service features.

Architecture Diagram

Host-specific flow for the Extension surface.

json-stdio
Host-owned architecture flowHost surfaceExtensionRuntimejson-stdioNative artifactsMCP + hooks + content + memoryConnector boundarystdio eventsUser surfacecmds + skills + memoryagent-connector writes only documented host artifacts; the host owns the agent loop.
  1. 1
    Entry point: Extension

    IDE extension host reads extension global storage and workspace-scoped files while the editor owns activation and UI.

  2. 2
    Connector package

    defineConnector package declares server, hooks, content, memory, and actions.

  3. 3
    Adapter module: jetbrains-copilot

    json-stdio renderer at src/adapters/jetbrains-copilot/index.ts.

  4. 4
    Native host artifacts

    Adapter writes MCP config + hook config + content files + memory/rules through this host's native file, package, or marketplace surface.

  5. 5
    Runtime boundary

    host launches JSON-stdio hook command

  6. 6
    User-visible surface

    Users see managed commands + skills + memory surfaces after install; runtime-only surfaces stay behind the host boundary.

  7. 7
    Coverage ceiling

    5/5 native surfaces wired. No visible host-native gap in the current coverage matrix.

Component Diagram

Static parts of the JetBrains Copilot integration and which side owns each one.

Components and ownershipJetBrains Copilot hosthostagent-connector packageconnectorjetbrains-copilot adapterjson-stdioNative artifactsartifactsRuntime bridgeruntimeUser-visible surfaceuser
  • JetBrains Copilot host

    Extension surface owns the model loop, UI shell, config discovery, and native lifecycle for this integration.

  • agent-connector package

    Normalizes connector declarations into MCP, hook, memory, content, and action payloads before delegating to a host adapter.

  • jetbrains-copilot adapter

    Implements the json-stdio translation layer in src/adapters/jetbrains-copilot/index.ts.

  • Native artifacts

    Adapter writes MCP config + hook config + content files + memory/rules through this host's native file, package, or marketplace surface.

  • Runtime bridge

    host launches JSON-stdio hook command

  • User-visible surface

    Users see managed commands + skills + memory surfaces after install; runtime-only surfaces stay behind the host boundary.

Runtime Sequence Flow

Message order from install to runtime for the Extension surface.

User / projectagent-connectorjetbrains-copilot adapterJetBrains CopilotAgent runtimeCoverage matrix1. Choose host adapter2. Resolve connector declaration3. Render host-native shape4. Host loads artifacts5. Run through host boundary6. Expose remaining ceiling
  1. 1 · User / project
    Choose host adapter

    Install or update starts against JetBrains Copilot; the selected surface is Extension.

  2. 2 · agent-connector
    Resolve connector declaration

    The package reads connector metadata and routes it to the jetbrains-copilot adapter instead of exposing a generic host contract.

  3. 3 · jetbrains-copilot adapter
    Render host-native shape

    Adapter writes MCP config + hook config + content files + memory/rules through this host's native file, package, or marketplace surface.

  4. 4 · JetBrains Copilot
    Host loads artifacts

    host launches JSON-stdio hook command

  5. 5 · Agent runtime
    Run through host boundary

    Users see managed commands + skills + memory surfaces after install; runtime-only surfaces stay behind the host boundary.

  6. 6 · Coverage matrix
    Expose remaining ceiling

    5/5 native surfaces wired. No visible host-native gap in the current coverage matrix.

Architecture Archive

The same five study axes are rendered for every host: runtime shape, hooks, MCP, memory, and host-only affordances.

Host-specific shape

JetBrains Copilot is an IDE-extension host: MCP, json-stdio hooks, commands, skills, and memory are tracked, while subagent, statusline, and action surfaces are not confirmed.

  • Form factor: Extension.
  • Native surfaces: MCP server, Hooks, Commands, Skills, Memory.
  • Wired surfaces: MCP server, Hooks, Commands, Skills, Memory.
  • Visible gaps: none.

Hooks

Hooks enter through a host-launched command that exchanges event JSON over stdio.

MCP

The adapter writes this host's native MCP registration dialect, including its root key, scope, transport fields, and environment syntax.

Memory

Managed memory text is written into the rules or memory file this host actually reads, with ownership markers for reversible uninstall.

Marketplace and affordances

Current install is a direct native-file write path; any package artifact is manual unless a driver is added.

  • Runtime handlers: none.
  • User-visible affordances: Users see managed commands + skills + memory surfaces after install; runtime-only surfaces stay behind the host boundary..

Special Feature Inventory

Host-specific capabilities separated from the generic surface matrix: lifecycle hooks, MCP registration, memory/rules, marketplace delivery, and UI or content affordances owned by the host.

Lifecycle hooks

Wired

Hooks enter through a host-launched command that exchanges event JSON over stdio.

MCP registration

Wired

The adapter writes this host's native MCP registration dialect, including its root key, scope, transport fields, and environment syntax.

Memory and rules

Wired

Managed memory text is written into the rules or memory file this host actually reads, with ownership markers for reversible uninstall.

Marketplace delivery

Direct files

Current install is a direct native-file write path; any package artifact is manual unless a driver is added.

Host-only affordances

2/2 wired

Wired host affordances: Commands, Skills. Host-native gaps: none. Not confirmed: Subagents, Statusline handler, Action affordances.

Source Review Notes

Latest source pass for host-specific architecture details. This is separate from generated adapter coverage and local drift guards.

Checked 2026-07-06Open review source
GitHub Copilot official product page
  • GitHub Copilot's official product page positions Copilot across editor and enterprise workflows, with agents, Copilot CLI, and VS Code explicitly called out.
  • The JetBrains row is therefore an IDE integration surface for Copilot, not the Copilot CLI and not the VS Code Copilot extension row.
  • Copilot guidance emphasizes developer oversight and review, so agent-connector should avoid treating suggestions as autonomous hook/action execution.

Evidence Map

Each host page ties public source evidence to the local adapter and drift guards that keep the rendered archive aligned with code.

Product source

Official product homepage or public tracker used when no open product repository is confirmed.

external
Open source

Local adapter implementation

Defines the install/uninstall behavior, native config rendering, capability flags, and any runtime parse/format bridge for this host.

local
src/adapters/jetbrains-copilot/index.ts

Platform metadata and host-native matrix

Records the form factor, public source target, ranking source, native host surfaces, and current agent-connector coverage cells.

local
site/src/platform-data.ts

Architecture drift guard

Asserts that every registered host has a page, diagram, host-specific brief, source link, form-factor band, and adapter-aligned surface data.

local
tests/docs/platform-drift.test.ts

Runtime Shape

Hooks are dispatched through a host-launched command. The adapter parses host JSON, calls the connector handler, and formats the reply back to the host contract.

MCP registration
Wired through this adapter
Hook bridge
Wired

Connector Surfaces

Static content

MCP server, Hooks, Commands, Skills, Memory

Runtime handlers

No runtime handler surfaces wired

Surface Matrix

Wired means agent-connector installs it now. Host native marks support we know about but have not wired yet.

SurfaceStatus
MCP server
Static content
agent-connector installs this surface today.
Wired
Hooks
Static content
agent-connector installs this surface today.
Wired
Commands
Static content
agent-connector installs this surface today.
Wired
Skills
Static content
agent-connector installs this surface today.
Wired
Subagents
Static content
No confirmed host-native surface.
N/A
Memory
Static content
agent-connector installs this surface today.
Wired
Statusline handler
Runtime handler
No confirmed host-native surface.
N/A
Action affordances
Runtime handler
No confirmed host-native surface.
N/A