Skip to content

Agent Architecture

Trae

Trae is a ByteDance-backed coding-agent family with an open-source Trae Agent research/runtime project and a proprietary Trae AI IDE product. The connector row should keep CLI-style agent evidence and IDE product evidence separate.

Source reviewed #16Checked 2026-07-06
Run type
Desktop
Adapter
mcp-only
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
trae
Run cohort
Desktop: 9
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 Trae.

1 surface entry

Desktop

desktop
Host entry
A desktop app or standalone editor owns window state, sign-in, project indexing, embedded terminal behavior, and local product storage.
Host owns
The desktop host owns orchestration UI, model routing, approval UX, background jobs, and any cloud or app-store managed extension points.
Connector role
agent-connector can write documented workspace/global config and content files, but it does not replace the desktop runtime or UI shell. Current wired connector surfaces: MCP server, Skills, Memory.
Implementation consequence
Desktop surfaces need source-review separation because product pages often document capabilities while runtime state lives in app-managed storage. Visible host-native gaps for this surface: Subagents.

Verified Architecture

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

Sequence #16

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.

  • The public repository is explicitly the official GitHub for TRAE, but it is a thin tracker rather than a full source tree for the product runtime.
  • TRAE should therefore be documented as a product/IDE host with source-light evidence, not as a fully inspectable open-source implementation.
  • The adapter can describe MCP-only coverage and known product source links, while avoiding unverified claims about file-authored hooks or subagents.

Runtime boundary

The archive should treat Trae as a split evidence host: the open-source Trae Agent is a software-engineering agent project, while Trae AI is an IDE product. The adapter row must name which runtime it can install into.

  • The open repository frames Trae Agent as a general-purpose software-engineering agent.
  • The paper describes ensemble reasoning for repository-level issue resolution.
  • The website is product-facing and does not by itself reveal every local storage contract.

MCP registration

Trae should be represented as MCP-capable only where the local adapter or public source gives a concrete server registration shape. Product-level integration language should not be converted into an MCP file contract without evidence.

  • Open-source agent evidence can guide CLI architecture review.
  • IDE product evidence should remain source-light until exact extension or settings paths are verified.

Hook bridge

The current connector matrix classifies Trae as MCP-only. That means architecture notes should avoid claiming lifecycle hooks even if the agent research system has modular stages, pruning, generation, or selection agents.

  • Research-agent modules are not automatically installable hook events.
  • Future hook support should identify a concrete local API or file-based bridge.

Content surfaces

Trae's useful study surfaces are repository understanding, issue resolution, multi-stage agent reasoning, IDE product UX, and model/provider integration. These are content and orchestration concepts, not necessarily connector-owned command files.

  • The paper's generator, pruning, and selection roles are architecture evidence for multi-agent reasoning.
  • IDE rules, prompts, or workspace state need separate source review before page chips are upgraded.

Marketplace and host-only affordances

Trae's host-only affordance is the combination of an agentic IDE product and an open research agent lineage. The page should show that duality so students can compare productized IDE agents with research/runtime agents.

  • The open-source row is useful for algorithmic architecture study.
  • The proprietary IDE row should remain cautious about storage, hooks, and marketplace claims.

Host-specific shape

Trae is a desktop IDE host with MCP, skills, and memory wired; custom agents are host-native but UI/cloud-share driven, so they remain a visible file-surface gap.

  • Form factor: Desktop.
  • Native surfaces: MCP server, Skills, Subagents, Memory.
  • Wired surfaces: MCP server, Skills, Memory.
  • Visible gaps: Subagents.

Hooks

No user-installable lifecycle hook boundary is confirmed for this host.

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 skills + memory surfaces after install; runtime-only surfaces stay behind the host boundary..

Known Limits

  • Do not merge Trae Agent research architecture with Trae IDE implementation details without evidence.
  • MCP-only coverage should remain separate from lifecycle hooks.
  • The product website is source-light and should not be used for undocumented internals.

Architecture Diagram

Host-specific flow for the Desktop surface.

mcp-only
Host-owned architecture flowHost surfaceDesktopRuntimemcp-onlyNative artifactsMCP + content + memoryConnector boundaryMCP clientUser surfaceskills + memoryagent-connector writes only documented host artifacts; the host owns the agent loop.
  1. 1
    Entry point: Desktop

    Desktop or standalone editor app reads global/product storage plus workspace files before handing control to its embedded agent runtime.

  2. 2
    Connector package

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

  3. 3
    Adapter module: trae

    mcp-only renderer at src/adapters/trae/index.ts.

  4. 4
    Native host artifacts

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

  5. 5
    Runtime boundary

    host calls MCP tools through its client

  6. 6
    User-visible surface

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

  7. 7
    Coverage ceiling

    3/4 native surfaces wired. Subagents are host-native but not wired yet.

Component Diagram

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

Components and ownershipTrae hosthostagent-connector packageconnectortrae adaptermcp-onlyNative artifactsartifactsRuntime bridgeruntimeUser-visible surfaceuser
  • Trae host

    Desktop 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.

  • trae adapter

    Implements the mcp-only translation layer in src/adapters/trae/index.ts.

  • Native artifacts

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

  • Runtime bridge

    host calls MCP tools through its client

  • User-visible surface

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

Runtime Sequence Flow

Message order from install to runtime for the Desktop surface.

User / projectagent-connectortrae adapterTraeAgent 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 Trae; the selected surface is Desktop.

  2. 2 · agent-connector
    Resolve connector declaration

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

  3. 3 · trae adapter
    Render host-native shape

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

  4. 4 · Trae
    Host loads artifacts

    host calls MCP tools through its client

  5. 5 · Agent runtime
    Run through host boundary

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

  6. 6 · Coverage matrix
    Expose remaining ceiling

    3/4 native surfaces wired. Subagents are host-native but not wired yet.

Architecture Archive

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

Host-specific shape

Trae is a desktop IDE host with MCP, skills, and memory wired; custom agents are host-native but UI/cloud-share driven, so they remain a visible file-surface gap.

  • Form factor: Desktop.
  • Native surfaces: MCP server, Skills, Subagents, Memory.
  • Wired surfaces: MCP server, Skills, Memory.
  • Visible gaps: Subagents.

Hooks

No user-installable lifecycle hook boundary is confirmed for this host.

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 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

Not confirmed

No user-installable lifecycle hook boundary is confirmed for this host.

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

1/2 wired

Wired host affordances: Skills. Host-native gaps: Subagents. Not confirmed: Commands, 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
Trae-AI/TRAE repository
  • The public repository is explicitly the official GitHub for TRAE, but it is a thin tracker rather than a full source tree for the product runtime.
  • TRAE should therefore be documented as a product/IDE host with source-light evidence, not as a fully inspectable open-source implementation.
  • The adapter can describe MCP-only coverage and known product source links, while avoiding unverified claims about file-authored hooks or subagents.

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/trae/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

The host accepts MCP registration, but has no confirmed hook bridge for agent-connector to call.

MCP registration
Wired through this adapter
Hook bridge
No confirmed hook surface

Connector Surfaces

Static content

MCP server, 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
No confirmed host-native surface.
N/A
Commands
Static content
No confirmed host-native surface.
N/A
Skills
Static content
agent-connector installs this surface today.
Wired
Subagents
Static content
The host appears to offer this, but this adapter has not wired it yet.
Host native
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