Institutional-grade, real-time US small-cap momentum screener, high-of-day tape, and news intelligence terminal.
Active momentum day trading requires spotting low-float runners the split second volume arrives. Existing platforms make this harder than it should be:
- Interactive Brokers (TWS & IBKR Desktop): Notoriously bloated, complex, and cumbersome to configure for fast intraday momentum screening.
- TradingView: While offering powerful charts, its news feeds often lag anywhere from several to 15 minutes behind the tapeβrendering headlines completely stale and useless for active intraday decision makingβand it completely lacks native inbound audio bells and immediate alert dispatching when tickers enter criteria.
NewsAlerts bridges this gap with a focused, zero-bloat institutional trading terminal designed for pure execution speed:
- β‘ Zero-Latency Inbound Alerts & Dual Topbar Toggles: Instant audio chimes (with interactive volume control & dedicated in-app audio bell) alongside independent Telegram push notifications with a dedicated 1-click topbar toggle (Telegram paper plane + bell) to silence mobile phone alerts when operating directly at your desk.
- π Running Momentum Tape: Warrior-Trading style High of Day (HOD) and Squeeze Breakout prints with 4-day local disk persistence for weekend and off-hours trade review.
- π― Interactive Strategy Builder & Tape Quick-Filter: Construct customized momentum rules (
+ Add Strategy) with trigger selectors, float ranges, and surge velocities in Settings, with instant one-click toggles right from the tape header (Strategies 11/13). - π TradingView Cloud Watchlist Sync & 1-Click Quick-Add: Real-time cloud watchlist selector bar docked directly above news headlines, paired with 1-click quick-add (
+) buttons next to tickers in the Screener, Tape, and News header. Features 3-second green/red flickering feedback and instant cloud sync directly into your TradingView Desktop app. - π° Zero-Lag Catalyst Confirmation (Beat the 15-Min Delay): Unlike retail charting platforms where news lags by 5 to 15 minutes, NewsAlerts pulls fresh headlines the second they cross the wire (Benzinga, GlobeNewswire, PR Newswire), enabling immediate verification of whether a runner is moving on real PR or sym-play noise.
- π BamSEC Real-Time SEC Filings & Dilution Radar: Directly integrated EDGAR intelligence surfacing critical SEC filings the moment they drop. Spot shelf registrations (
F-3,S-3), toxic dilution offerings (424B), and insider stakes (Form 4) before entering a runner. Features dual drawer and sub-tab modes with 1-click external BamSEC hub launching. - π Custom US Equity Search & Watchlist Chips: Inspect real-time quotes, float, borrow locates, and Benzinga headlines for any US equity ticker on demand, pinned as interactive quick-access chips.
- πΎ Configuration Backup & Strategy Sync: Full disaster recovery export/import (
.json) for screeners, sound configs, and strategies, with independent strategy preset sharing and safe factory reset. - π One-Click TradingView Chart Launching: Dedicated chart icon button docked directly in the news headline banner header (
#news-chart). Clicking it instantly opens the live interactive TradingView chart for the active ticker in your default browserβeliminating manual symbol typing during high-velocity breakouts. - π©³ Real-Time Borrow Locates: Live
HTB(Hard to Borrow),ETB(Easy to Borrow), andNO BORROWbadges right on the tape and screener to identify short squeeze potential instantly. - πͺΆ Dual Distribution & Sub-300ms Instant Startup: Native Edge WebView2 execution with both a standalone portable binary (
dist/NewsAlerts.exe) and a pre-extracted application installer targeting%LOCALAPPDATA%\Programs\NewsAlertsdelivering sub-300ms instant terminal launch with zero Electron/Node.js overhead.
Live institutional terminal capture (v2.12.0): Real-time screener with 1-click watchlist quick-add, high-of-day momentum tape, TradingView cloud watchlist selector, dual in-app audio & Telegram alert toggles, interactive topbar π« Banned / Closing-Only filter, catalyst news wire, and BamSEC SEC filings intelligence.
NewsAlerts includes a Universal Cross-Platform Makefile providing identical developer and build commands across Windows, macOS, and Linux:
make env # Auto-detect OS & prepare virtualenv (.venv) with dependencies
# Platform-specific env targets: # make env-win | make env-linux | make env-mac
make run # Launch desktop application
make build # Compile standalone executable / distribution package
make test # Run full automated unit test suite
make verify # Run Deterministic Package Verification Gate
make check # Audit for credential leaks
make clean # Remove build artifacts and caches
make worktree-list # List active git worktrees
make worktree-new BRANCH=feat/<name> # Create new isolated git worktree
make issue-list # List open issues (Issue-First Protocol)
make issue-view ISSUE=<number> # Inspect specific issue details
make help # Display usage guide and detected platformWindows does not include GNU make by default. Install it in seconds:
winget install ezwinports.make
# Or via Chocolatey: choco install make -yZero-install alternative: You can also run
.\make.bat <target>or.\build.ps1 -Task <target>in Windows PowerShell / CMD without installing any extra software.
All technical procedures are documented in detail within the docs/ directory. Below is an executive summary of each procedure with direct links:
π 1. Installation & Launch Procedure β docs/INSTALLATION.md
Universal make workflow, standalone binaries, and OS-specific setup:
- Universal Developer CLI (
make): Primary cross-platform interface for building, testing, verifying, and running NewsAlerts. - Windows x64: Zero-install portable standalone executable (
dist\NewsAlerts.exe) with bundled custom icon, or source launch viamake run/.\build.ps1 -Task run. - macOS (Apple Silicon arm64): Native Cocoa/WebKit window via
make run/./run.shor automated system-wide installer./install.sh. - Linux x86_64: WebKit2GTK runtime setup, automated
./install.sh, and desktop application launcher (assets/NewsAlerts.desktop). β Read the complete Installation Guide
βοΈ 2. Configuration & Credentials Procedure β docs/CONFIGURATION.md
Configuration guidelines for live market data feeds, borrow locates, and alert notifications:
- In-App Settings UI: Configure feeds, audio volume, and Telegram directly within the UI via the topbar gear icon.
- TradingView Real-Time Data: Enter session cookies (
sessionid,sessionid_sign) for sub-second unthrottled screener updates. - Alpaca Short Borrow Locates: Connect Alpaca API keys (
key_id,secret_key) for liveHTB,ETB, andNO BORROWbadges. - Telegram Bot Notifications: Dispatch instant push alerts for newly discovered breakout symbols.
- Isolated
keys.tomlStorage: Optional manual credential management strictly preserved in userAPP_DIR(never in git). β Read the complete Configuration Guide
π 3. Directory Layouts & Persistence Procedure β docs/DIRECTORIES.md
Cross-platform directory specifications, rolling tape persistence, and worktree layouts:
- User Application Roots (
APP_DIR): Windows (%APPDATA%\NewsAlerts\), macOS (~/Library/Application Support/NewsAlerts/), Linux (~/.config/NewsAlerts/). - 4-Day Rolling Tape Persistence:
tape_history.jsonretains up to 5,000 historical momentum prints for off-hours and weekend analysis. - Task-Isolated Git Worktrees (
.worktrees/): Dedicated ignored directory hosting parallel feature branches without touchingmain. β Read the complete Directory Layout Specification
π¦ 4. Release Governance & Versioning Procedure β docs/RELEASES.md
Release engineering policy, SemVer 2.0.0 compliance, and multi-OS artifact bundles:
- Semantic Versioning 2.0.0: Strict
MAJOR.MINOR.PATCHprogression governed byapp/version.py. - Multi-OS Release Bundles: Automated generation of
NewsAlerts-Windows-x64.zip,NewsAlerts-macOS-arm64.tar.gz, andNewsAlerts-Linux-x64.tar.gz. - Release Changelog Catalog: Archived release documentation cataloged under
docs/releases/. β Read the complete Release Governance Guide
π€ 5. Development & Git Worktree Workflow β CONTRIBUTING.md
Guidelines for human developers and open source contributions:
- Isolated Worktree Model: Never dirty
main. Spawn dedicated feature worktrees viamake worktree-new BRANCH=feat/<name>. - Conventional Commits: Enforced commit structure:
type(scope): description. - Pull Request & Code Ownership: Mandatory PR template with automated bot validation and explicit code ownership via
.github/CODEOWNERS. β Read the complete Contributing Guide
π€ 6. AI Agent Operating Protocol β AGENTS.md
Authoritative rules of engagement for automated AI coding agents (Antigravity, Claude, Copilot):
- Absolute Security: Strict zero-leak rule for keys, secrets, tokens, or credentials.
- Git Worktree Mandatory Rule: Root checkout on
mainis immutable; all modifications must occur in.worktrees/. - Local Verification Gate: Mandatory Python syntax compilation, unit tests, and build check before submitting PRs. β Read the complete AI Agent Operating Guidelines
π 7. Interactive GitHub Wiki & Documentation β GitHub Wiki
Official deep-dive manuals, strategy guides, and system architecture:
- Terminal Manual & Navigation: Screener filtering, running tape persistence, and one-click TradingView chart popout.
- Multi-Strategy Rules Engine: Strategy parameters for Low Float Momo, Squeeze 52wk Breakout, and 5%/10% surges.
- Short Locates & Broker Integration: Real-time Alpaca API locate mappings and short squeeze analytics. β Explore the complete NewsAlerts GitHub Wiki
NewsAlerts enforces a deterministic Package Verification Gate to ensure that broken, unverified, or incomplete binaries are never merged or distributed:
[ Build Artifacts ] ββ> [ scripts/verify-packages.py ]
β
ββββββββββββββββββββ΄βββββββββββββββββββ
βΌ βΌ
[ PASS (Code 0) ] [ FAIL (Code 1) ]
β β
β’ PR Check Green β’ PR Aborted & Blocked
β’ Publish GitHub Release β’ DO NOT Publish Release
β’ Distribute Multi-OS Bundles β’ Delete Remote Git Tag
β’ Revert 'main' to Last Good Commit
β’ Auto-Open Critical GitHub Issue
- Every Pull Request triggers multi-OS builds across Windows, macOS, and Linux.
- The package verifier audits archive structure, PE headers, executable sizes (>5MB), required launch scripts, and scans for secret file leakage.
- If any check fails, the PR check turns red and merging is blocked.
If package verification fails during a release run on main:
- Release Blocked: The package is not published to GitHub Releases or package registries.
- Git Tag Deleted: The remote tag (e.g.
v2.4.1) is deleted viagit push --delete origin <tag>. - Automated Branch Rollback: The
mainbranch is automatically reverted to the last known good commit (git revert HEAD). - Critical Incident Issue: An automated GitHub issue is opened with full logs, commit SHA, and assigned to
@mlgitdev.
This project is proprietary and maintained by @mlgitdev. All rights reserved.
