# brandononchain/opentrade architecture

> Architecture diagram of the GitHub repository brandononchain/opentrade, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/brandononchain/opentrade
- Repository: https://github.com/brandononchain/opentrade

## Overview

OpenTrade is a TradingView-focused AI agent: users submit natural-language requests through a terminal or browser UI, the agent can invoke TradingView tools, and the response may include chart analysis or Pine Script work. Its broader documented capabilities include quantitative research and professional analysis skills. The graph separates interfaces, agent runtime, TradingView access, Pine Script tooling, and research. Some product branches are documented or exported but not fully sampled; those limits are reflected by omitting uncertain connections.

Main entry points: [`src/pine/analyzer.js`](https://github.com/brandononchain/opentrade/blob/main/src/pine/analyzer.js) (Pine analyzer), [`src/agent/claude.js`](https://github.com/brandononchain/opentrade/blob/main/src/agent/claude.js) (Agent loop), [`src/pine/writer.js`](https://github.com/brandononchain/opentrade/blob/main/src/pine/writer.js) (Pine writer), [`src/agent/providers/index.js`](https://github.com/brandononchain/opentrade/blob/main/src/agent/providers/index.js) (Provider factory)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User interfaces"]
  node_cli["Terminal CLI<br/>[index.js]"]
  node_web["Browser UI server<br/>[server.js]"]
end

subgraph group_agent["Agent runtime"]
  node_agent_loop["Agent loop<br/>[claude.js]"]
  node_context["Context manager<br/>[context-manager.js]"]
  node_model_catalog["Model catalog<br/>[models.js]"]
  node_provider_factory["Provider factory<br/>[index.js]"]
  node_provider_adapters["Provider adapters"]
end

subgraph group_tradingview["TradingView access"]
  node_mcp["Tool client<br/>[client.js]"]
  node_tv_tools["Chart and Pine tools<br/>[tools.js]"]
  node_cdp["Chrome DevTools connection<br/>[connection.js]"]
end

subgraph group_pine["Pine Script"]
  node_pine_writer["Pine writer<br/>[writer.js]"]
  node_pine_analyzer["Pine analyzer<br/>[analyzer.js]"]
  node_pine_linter["Pine linter<br/>[linter.js]"]
  node_oakscript["OakScript engine<br/>[oakscript.js]"]
  node_strategy_builder["Strategy builder"]
  node_pine_templates["Pine templates<br/>[templates.js]"]
end

subgraph group_research["Research and analysis"]
  node_quant["Quant research<br/>[quant-research.js]"]
  node_quant_report["TradingView quant reports<br/>[quant-report.js]"]
  node_chart_plugins["Chart plugins<br/>[plugins.js]"]
  node_skills["Analysis skills"]
end

node_user(("User"))
node_chrome["Chrome TradingView"]

node_user -->|"submits request"| node_cli
node_user -->|"submits request"| node_web
node_cli -->|"starts chat"| node_agent_loop
node_web -->|"forwards messages"| node_agent_loop
node_agent_loop -->|"manages history"| node_context
node_agent_loop -->|"calls tools"| node_mcp
node_mcp -->|"dispatches tools"| node_tv_tools
node_tv_tools -->|"evaluates chart"| node_cdp
node_cdp -.->|"controls browser"| node_chrome
node_provider_factory -->|"resolves model"| node_model_catalog
node_provider_factory -->|"creates provider"| node_provider_adapters
node_pine_writer -->|"requests generation"| node_provider_factory
node_pine_writer -->|"uses templates"| node_pine_templates
node_pine_writer -->|"validates script"| node_pine_analyzer
node_pine_analyzer -->|"runs lint checks"| node_pine_linter
node_pine_analyzer -->|"uses backtester"| node_oakscript
node_pine_analyzer -->|"compiles remotely"| node_mcp
node_quant_report -->|"computes report"| node_quant
node_quant_report -->|"uses indicators"| node_oakscript

click node_cli "https://github.com/brandononchain/opentrade/blob/main/src/cli/index.js"
click node_web "https://github.com/brandononchain/opentrade/blob/main/src/web/server.js"
click node_agent_loop "https://github.com/brandononchain/opentrade/blob/main/src/agent/claude.js"
click node_context "https://github.com/brandononchain/opentrade/blob/main/src/agent/context-manager.js"
click node_model_catalog "https://github.com/brandononchain/opentrade/blob/main/src/agent/models.js"
click node_provider_factory "https://github.com/brandononchain/opentrade/blob/main/src/agent/providers/index.js"
click node_provider_adapters "https://github.com/brandononchain/opentrade/tree/main/src/agent/providers"
click node_mcp "https://github.com/brandononchain/opentrade/blob/main/src/mcp/client.js"
click node_tv_tools "https://github.com/brandononchain/opentrade/blob/main/src/tv/tools.js"
click node_cdp "https://github.com/brandononchain/opentrade/blob/main/src/tv/connection.js"
click node_pine_writer "https://github.com/brandononchain/opentrade/blob/main/src/pine/writer.js"
click node_pine_analyzer "https://github.com/brandononchain/opentrade/blob/main/src/pine/analyzer.js"
click node_pine_linter "https://github.com/brandononchain/opentrade/blob/main/src/pine/linter.js"
click node_oakscript "https://github.com/brandononchain/opentrade/blob/main/src/pine/oakscript.js"
click node_strategy_builder "https://github.com/brandononchain/opentrade/blob/main/src/pine/strategy-builder.js"
click node_pine_templates "https://github.com/brandononchain/opentrade/blob/main/src/pine/templates.js"
click node_quant "https://github.com/brandononchain/opentrade/blob/main/src/pine/quant-research.js"
click node_quant_report "https://github.com/brandononchain/opentrade/blob/main/src/tv/quant-report.js"
click node_chart_plugins "https://github.com/brandononchain/opentrade/blob/main/src/charts/plugins.js"
click node_skills "https://github.com/brandononchain/opentrade/tree/main/src/skills"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_web,node_user,node_chrome toneBlue
class node_agent_loop,node_context,node_model_catalog,node_provider_factory,node_provider_adapters toneAmber
class node_mcp,node_tv_tools,node_cdp toneMint
class node_pine_writer,node_pine_analyzer,node_pine_linter,node_oakscript,node_strategy_builder,node_pine_templates toneRose
class node_quant,node_quant_report,node_chart_plugins,node_skills toneIndigo
```

## Components

### User interfaces

- [Terminal CLI](https://github.com/brandononchain/opentrade/blob/main/src/cli/index.js): `src/cli/index.js`
- [Browser UI server](https://github.com/brandononchain/opentrade/blob/main/src/web/server.js): `src/web/server.js`

### Agent runtime

- [Agent loop](https://github.com/brandononchain/opentrade/blob/main/src/agent/claude.js): `src/agent/claude.js`
- [Context manager](https://github.com/brandononchain/opentrade/blob/main/src/agent/context-manager.js): `src/agent/context-manager.js`
- [Model catalog](https://github.com/brandononchain/opentrade/blob/main/src/agent/models.js): `src/agent/models.js`
- [Provider factory](https://github.com/brandononchain/opentrade/blob/main/src/agent/providers/index.js): `src/agent/providers/index.js`
- [Provider adapters](https://github.com/brandononchain/opentrade/tree/main/src/agent/providers): `src/agent/providers`

### TradingView access

- [Tool client](https://github.com/brandononchain/opentrade/blob/main/src/mcp/client.js): `src/mcp/client.js`
- [Chart and Pine tools](https://github.com/brandononchain/opentrade/blob/main/src/tv/tools.js): `src/tv/tools.js`
- [Chrome DevTools connection](https://github.com/brandononchain/opentrade/blob/main/src/tv/connection.js): `src/tv/connection.js`

### Pine Script

- [Pine writer](https://github.com/brandononchain/opentrade/blob/main/src/pine/writer.js): `src/pine/writer.js`
- [Pine analyzer](https://github.com/brandononchain/opentrade/blob/main/src/pine/analyzer.js): `src/pine/analyzer.js`
- [Pine linter](https://github.com/brandononchain/opentrade/blob/main/src/pine/linter.js): `src/pine/linter.js`
- [OakScript engine](https://github.com/brandononchain/opentrade/blob/main/src/pine/oakscript.js): `src/pine/oakscript.js`
- [Strategy builder](https://github.com/brandononchain/opentrade/blob/main/src/pine/strategy-builder.js): `src/pine/strategy-builder.js`
- [Pine templates](https://github.com/brandononchain/opentrade/blob/main/src/pine/templates.js): `src/pine/templates.js`

### Research and analysis

- [Quant research](https://github.com/brandononchain/opentrade/blob/main/src/pine/quant-research.js): `src/pine/quant-research.js`
- [TradingView quant reports](https://github.com/brandononchain/opentrade/blob/main/src/tv/quant-report.js): `src/tv/quant-report.js`
- [Chart plugins](https://github.com/brandononchain/opentrade/blob/main/src/charts/plugins.js): `src/charts/plugins.js`
- [Analysis skills](https://github.com/brandononchain/opentrade/tree/main/src/skills): `src/skills`

### Other components

- **User**
- **Chrome TradingView**

## Connections

- User → Terminal CLI: submits request (evidence: `README.md`)
- User → Browser UI server: submits request (evidence: `README.md`)
- Terminal CLI → Agent loop: starts chat (evidence: `src/cli/index.js`)
- Browser UI server → Agent loop: forwards messages (evidence: `src/web/server.js`)
- Agent loop → Context manager: manages history (evidence: `src/agent/claude.js`)
- Agent loop → Tool client: calls tools (evidence: `src/agent/claude.js`)
- Tool client → Chart and Pine tools: dispatches tools (evidence: `src/mcp/client.js`)
- Chart and Pine tools → Chrome DevTools connection: evaluates chart (evidence: `src/tv/tools.js`)
- Chrome DevTools connection → Chrome TradingView: controls browser
- Provider factory → Model catalog: resolves model (evidence: `src/agent/providers/index.js`)
- Provider factory → Provider adapters: creates provider (evidence: `src/agent/providers/index.js`)
- Pine writer → Provider factory: requests generation (evidence: `src/pine/writer.js`)
- Pine writer → Pine templates: uses templates (evidence: `src/pine/writer.js`)
- Pine writer → Pine analyzer: validates script (evidence: `src/pine/writer.js`)
- Pine analyzer → Pine linter: runs lint checks (evidence: `src/pine/analyzer.js`)
- Pine analyzer → OakScript engine: uses backtester (evidence: `src/pine/analyzer.js`)
- Pine analyzer → Tool client: compiles remotely (evidence: `src/pine/analyzer.js`)
- TradingView quant reports → Quant research: computes report (evidence: `src/tv/quant-report.js`)
- TradingView quant reports → OakScript engine: uses indicators (evidence: `src/tv/quant-report.js`)
