Questions, constraints, current status
Blackdesk is still early. These are the practical answers around what it is, how it installs, and how local data and AI boundaries work today.
Product
What is Blackdesk?
Blackdesk is a local-first stock market TUI written in Go. It focuses on dense, keyboard-first research for quotes, charts, news, fundamentals, statements, insider activity, screeners, and AI connectors.
Is this website the app itself?
No. This site is a static product and install surface. The product itself is a local desktop and terminal experience.
Why local-first?
The desk keeps configuration, watchlists, provider boundaries, and agent targeting close to the operator instead of routing everything through a hosted SaaS workflow.
Data and AI
Which data provider is used today?
Yahoo Finance is the current primary market-data reference, wrapped behind provider interfaces so future adapters can be added without rewriting the TUI layer.
How do AI connectors work?
Blackdesk can target locally installed agent CLIs such as Codex, Claude, and OpenCode. Requests include normalized desk context like symbol, chart series, fundamentals, insider flow, and market news.
Does Blackdesk send screener data to AI?
No. Screener data is intentionally excluded from AI context payloads, including the main AI workspace and compact insight widgets.
Install and status
Is Blackdesk production-ready?
Not yet. The repository is still in early buildout, with current priorities around Yahoo robustness, graceful partial failure behavior, and stronger smoke and integration coverage.
How do I install it?
Use the install script, install a pinned version, or build from source with Go from the repository root.
Where should I report issues?
Use the GitHub repository for issues, release tracking, and source-level discussion.