feat: add a command-line interface with a dashboard (#17)

Author: kimtth

.gitignore

@@ -207,3 +207,4 @@ README_MEMO.md
 .ruff_cache/
 /.agents
 skills-lock.json
+/chart-cli/output

README.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-**Repository overview** &nbsp;|&nbsp; [Agent Framework](docs/agent_framework.md) &nbsp;|&nbsp; [Semantic Kernel](docs/semantic_kernel.md) &nbsp;|&nbsp; [AutoGen reference](docs/autogen.md) &nbsp;|&nbsp; [Agent Framework patterns](docs/agent_framework_patterns.md) &nbsp;|&nbsp; [Framework comparison](docs/autogen_agent_sk.md)
+**Repository overview** &nbsp;|&nbsp; [Agent Framework](docs/agent_framework.md) &nbsp;|&nbsp; [Semantic Kernel](docs/semantic_kernel.md) &nbsp;|&nbsp; [AutoGen reference](docs/autogen.md) &nbsp;|&nbsp; [Agent Framework patterns](docs/agent_framework_patterns.md) &nbsp;|&nbsp; [Terminal dashboard](docs/chart_cli.md) &nbsp;|&nbsp; [Framework comparison](docs/autogen_agent_sk.md)
 
 </div>
 
@@ -22,6 +22,7 @@ This project shows how to use Microsoft Agent Framework for stock-market researc
 | [Semantic Kernel workflow](docs/semantic_kernel.md) | Same steps, plugin-based. | Compare with the main workflow. |
 | [AutoGen reference](docs/autogen.md) | Earlier group-chat version. | Compare implementation styles. |
 | [Agent Framework patterns](docs/agent_framework_patterns.md) | Examples for the investment domain. | Explore features one at a time. |
+| [Real-time terminal dashboard](docs/chart_cli.md) | Live watchlist and charts driven by an Agent Framework workflow, with `/ask`, `/model`, and `/help` commands. | Watch signals update in a terminal. |
 | [Framework comparison](docs/autogen_agent_sk.md) | Short comparison of the three frameworks. | - |
 
 The [Agent Framework patterns](docs/agent_framework_patterns.md) are the only pattern showcase in this repository. The 30 examples show Microsoft Agent Framework features for investment research. Semantic Kernel and AutoGen do not have separate pattern libraries here.
@@ -57,6 +58,27 @@ Use this command only when comparing the plugin-based agent variant. It reuses t
 uv run python -m semantic_kernel.main
 ```
 
+## Real-time terminal dashboard
+
+[chart-cli](docs/chart_cli.md) renders a live watchlist, price chart, and Agent Framework workflow output in the terminal. Press `/` for the command prompt: `/ask` answers questions about the symbols on screen, `/model` switches the chat backend, `/help` lists everything. The screenshot below is a real capture of the running dashboard; `AGENT:RULES` means the workflow fell back to its transparent rule-based path because no Foundry credentials were available.
+
+<img src="docs/chart-cli-dashboard.png" alt="chart-cli terminal dashboard with a watchlist, price chart, details, workflow signals, agent call, and market and risk notes" width="900">
+
+Run this from PowerShell:
+
+```powershell
+cd chart-cli
+pnpm install
+.\scripts\test-cli.ps1
+```
+
+The script verifies the Node UI and Python Agent Framework protocol, then opens
+the interactive dashboard in the same terminal. It starts the workflow process
+used by the dashboard; do not start a separate Python backend. Use
+`.\scripts\test-cli.ps1 -CheckOnly` for verification without opening the UI.
+
+See the [terminal dashboard guide](docs/chart_cli.md) for the panels, keys, commands, ticker editing, and provider setup.
+
 ## Sample research output
 
 The following Agent Framework sample uses `MSFT` from 2020-01-01 through 2026-07-01 with a simulated $10,000 starting balance. It is historical research only; a later run can generate a different strategy and result.
@@ -102,6 +124,7 @@ See the full [backtest workbook](output/agent_framework/backtest_results.xlsx),
 | [semantic_kernel](semantic_kernel) | The Semantic Kernel version of the research workflow. |
 | [autogen](autogen) | The AutoGen reference version, with its own Poetry environment. |
 | [agent_framework_patterns](agent_framework_patterns) | Thirty small Agent Framework examples for investment research. |
+| [chart-cli](chart-cli) | Real-time terminal dashboard with a companion Agent Framework workflow. |
 | [tests](tests) | Offline tests for Agent Framework patterns and the REPL contracts. |
 | [output](output) | Saved charts, metrics, and example pattern responses. |
 | [docs](docs) | Guides for each implementation and framework comparison. |

chart-cli/.gitignore

@@ -0,0 +1,3 @@
+node_modules/
+.cache/
+*.log

chart-cli/config.json

@@ -0,0 +1,19 @@
+{
+  "tickers": ["MSFT", "AAPL", "NVDA", "GOOGL", "AMZN", "META", "AVGO", "TSLA", "QQQ", "SPY"],
+  "cryptoIds": {
+    "BTC": "bitcoin",
+    "ETH": "ethereum",
+    "SOL": "solana"
+  },
+  "updateIntervalMs": 120000,
+  "chart": {
+    "defaultPeriodIndex": 1
+  },
+  "agent": {
+    "enabled": true,
+    "command": "uv",
+    "args": ["run", "--project", "..", "python", "-m", "signal_agent.run_agent", "--serve"],
+    "analyzeIntervalMs": 600000,
+    "timeoutMs": 180000
+  }
+}

chart-cli/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "chart-cli",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Real-time terminal market dashboard driven by a Microsoft Agent Framework workflow",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "chart-cli": "./src/index.js"
+  },
+  "packageManager": "pnpm@10.32.0",
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "start": "node src/index.js",
+    "dev": "node src/index.js",
+    "agent": "uv run --project .. python -m signal_agent.run_agent --demo",
+    "test": "powershell -NoProfile -ExecutionPolicy Bypass -File scripts/test-cli.ps1 -CheckOnly"
+  },
+  "keywords": [
+    "stocks",
+    "crypto",
+    "terminal",
+    "dashboard",
+    "tui",
+    "agent-framework"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.7.9",
+    "blessed": "^0.1.81",
+    "blessed-contrib": "^4.11.0",
+    "chalk": "^5.4.1"
+  }
+}