Skip to content
fatwang2Public

Repository files navigation

Pulse

Glanceable market data, wherever you work.

Website · Mac App Store · Feedback

Pulse keeps stock, index and crypto prices where you already are: the macOS menu bar, your AI coding tools, your terminal and your desktop bar. Pulse for Mac is the full app, closed source. This repository holds the free, MIT-licensed editions for other tools, and the documentation for the MCP server built into Pulse for Mac.

Editions

Edition Runs in What it does Status Get started
Pulse for Mac macOS menu bar Named watchlists, intraday and candlestick charts, positions and P&L, MCP server Closed source, paid, 30-day free trial Website · App Store
Pulse MCP Pulse for Mac Quotes, symbol search, watchlists and positions for AI agents Built into Pulse for Mac (docs only) Guide
Pulse for Claude Code Claude Code, Claude Desktop's Code tab Prices above the prompt, /pulse panel to manage tickers Open source, MIT Guide
Pulse for opencode opencode Sidebar watchlist with today's line and a detail view, quote band Open source, MIT, on npm Guide
Pulse for Herdr Herdr Watchlist docked beside your agents, with a detail view Open source, MIT Guide
Pulse for Metrix.Bar Metrix.Bar menu bar Ticker in the menu bar, watchlist with search and a detail view Open source, MIT Guide
Pulse for Omarchy Omarchy 4 bar (Linux) Prices in the bar, named watchlists, search, charts Open source, MIT Guide
Pulse for Raycast Raycast Search any symbol by ticker or name, with its price and today's chart Open source, MIT, in Raycast Store review Guide

The open-source editions need no account or API key. Stocks and indices come from Yahoo Finance and crypto pairs from Binance's public Spot data; each guide describes its edition's data sources, storage and privacy. Positions, P&L and the MCP server are only in Pulse for Mac.

Pulse for Mac

Market data in your macOS menu bar, with named watchlists, charts, and position tracking. Visit pulseticker.app for features, downloads, and current purchase terms, or get Pulse from the Mac App Store.

Pulse for Mac is a paid app with a 30-day full-feature trial, followed by a one-time purchase. See pricing and downloads.

Pulse for Mac includes Pulse MCP, a local MCP server that gives Claude Code, Claude Desktop, Cursor, Codex, VS Code and other MCP clients quotes, symbol search, watchlists and positions over 127.0.0.1. See the Pulse MCP guide for its 15 tools and client configs.

Pulse for Mac: a watchlist with live quotes and sparklines, opened from the menu bar

Symbol detail with a daily chart, buy and sell markers, and the position Holdings with day and total P&L summed by currency Trade log with realized P&L for each sell Local MCP server settings for AI agents

The current Mac application and website are developed in a private repository. Their current source is not included here. The historical Mac edition through 0.15.8 retains its original MIT license in Git history and version tags; free installers remain available. See historical Mac source and downloads.

Pulse for Claude Code

A Claude Code plugin that shows stock and crypto quotes with signed percentage changes above the prompt, with a /pulse panel for adding and removing tickers, refreshing prices, and pausing updates. Requires Claude Code 2.1.287 or later, with Mods enabled.

Pulse for Claude Code showing stock and crypto prices above the prompt

The prices and the /pulse panel also work in Claude Desktop's Code tab:

Claude Desktop with Pulse CC prices above the prompt and the panel beside the chat

Install from GitHub:

claude plugin marketplace add fatwang2/Pulse
claude plugin install pulse-cc@pulse

Restart Claude Code or run /reload-plugins, then add a stock with /pulse add AAPL or a crypto pair with /pulse add BTC/USDT, and open /pulse to manage your watchlist. See the Claude Code guide for commands, provider limits, privacy, and local development.

Pulse for opencode

An opencode plugin: a stock and crypto watchlist in the session sidebar, with today's line on every row and a detail view with the day's open, high, low and previous close, plus a one-line quote band along the bottom of the window.

Pulse in the opencode sidebar

In opencode v2, run opencode plugin add opencode-pulse-ticker. In opencode v1 (1.15+), add it to ~/.config/opencode/tui.json and restart opencode:

{ "plugin": ["opencode-pulse-ticker"] }

See the opencode guide for commands and privacy.

Pulse for Herdr

A Herdr mod: a stock and crypto watchlist docked beside your agents, with today's line on every row and a detail view with the day's chart, open, high, low and previous close. Comes as a mod and as a "Herdr + Pulse" layout.

Pulse for Herdr beside a terminal in Herdr

Ask the agent running in Herdr:

Read ~/.config/herdr-app/AGENTS.md, then add this layout: https://github.com/fatwang2/Pulse/tree/main/herdr/pulse-layout

See the Herdr guide for the mod on its own, usage and privacy.

Pulse for Metrix.Bar

A Metrix.Bar dashboard: your first ticker in the menu bar, and a panel with your watchlist, today's line on every row and a detail view with the day's chart, open, high, low and previous close. Press + to search by ticker or company name in English, Chinese, Japanese or Korean; right-click a row to reorder or remove it.

Pulse for Metrix.Bar panel

With Metrix.Bar running, run this in Terminal (or open the link in a browser), then confirm in Metrix.Bar:

open "metrixbar://install/pulse?registry_url=https%3A%2F%2Fraw.githubusercontent.com%2Ffatwang2%2FPulse%2Fmain%2Fmetrix%2Findex.json"

Installed this way, Metrix.Bar offers new versions as they are published here. See the Metrix.Bar guide for usage, settings and privacy.

Pulse for Omarchy

An independent Pulse edition for Omarchy, with market data in the bar, named watchlists, symbol search, quote details, charts, and theme-aware presentation. Requires Omarchy 4 and its Quickshell shell.

Pulse for Omarchy panel

The existing managed installation continues to use the standalone repository while its installation and update path is migrated:

omarchy plugin add https://github.com/fatwang2/omarchy-pulse.git --enable

The implementation is maintained in omarchy/. See the Omarchy guide for features and local development, and repository transition notes for migration details.

Pulse for Raycast

A Raycast extension with one command, Search Symbol: look up any stock, ETF, index or crypto pair by ticker or by its name in English, Chinese, Japanese or Korean, and see its price, change and today's chart. Search runs on your Mac over Pulse's symbol list.

The extension is in review for the Raycast Store (raycast/extensions#33098). Until it is listed, run it from this repository with Raycast and Node.js installed (development notes):

cd raycast
npm install
npm run dev

See the Raycast guide for markets, search and privacy.

Contributing and feedback

Start with CONTRIBUTING.md. Each open-source edition has its own folder, implementation and tests; development does not require building the Mac app. make test runs every edition's checks. Use GitHub Issues and identify the edition. Mac support is also available at hello@pulseticker.app. Report security issues privately to sys@pulseticker.app.

License

The open-source editions (plugins/claude-code, opencode, herdr, metrix, omarchy and raycast) are released under the MIT license, with any component notices in their folders. That license does not apply to the current commercial Mac binaries or provide rights to third-party market data. Historical Mac source retains its original license.

Releases

Packages

Contributors

Languages