JSON in.
Dashboard out.

Any API. Any metric. Menu bar, widgets, or both. Here's everything under the hood.

Three ways to connect

Raw text. Structured JSON. JSONPath queries. Pick what fits your API.

Simple Value

Easiest

Point at an endpoint. Display what comes back. Done.

Response:
Online

Best for status endpoints & quick integrations

Structured Response

Most Flexible

Return our JSON format. You control titles, icons, colors—everything.

Response:
{
"items": [{
"title": "Revenue",
"value": 12450
}]
}

Best for APIs you control

JSONPath Extraction

RFC 9535

Pull specific values from any JSON response. Works with APIs you don't control.

Path: $.data.users
{"data":{"users":1234}}
1,234

Best for third-party APIs

macOS Only

No API? No problem.

Push from scripts. Watch local files. Zero cloud, zero latency.

Local Push Server

HTTP & WebSocket

Built-in server on port 9876. One curl command pushes data to your menu bar.

$ Push from anywhere:
curl localhost:9876/push \
-d '{"title":"Build","value":"Pass"}'

Unix Socket

Local IPC

Skip the network stack entirely. Direct IPC for maximum speed.

Instant updates, no latency

File Watcher

Monitor local files

Point at any file. See changes instantly. Logs, configs, JSON—all fair game.

Raw content display
JSONPath extraction
Structured items array
New

Know what your AI costs

Claude Code, Cursor, Codex—track tokens, sessions, and spend without digging through dashboards.

  • Auto-detection

    Finds AI tools on your system automatically

  • Cost tracking

    Tokens × price = no surprises on your bill

  • Always current

    Updates every 60 seconds while you work

Claude Code

AI Agent · Active

Sessions Today

12

Tokens Used

48.2K

Est. Cost

$2.41

Avg/Session

4.0K

MCP

Let AI push to your menu bar

Claude Code can update cards directly via MCP. See task progress without switching windows.

  • One-line setup

    Add the MCP config. Enable Local Push. Done.

  • Full card control

    List, read, update, create—all via MCP tools

  • Glanceable progress

    Watch AI work from your menu bar

~/.claude/settings.json
{
"mcpServers": {
"tailstats": {
"type": "http",
"url": "http://localhost:9876/mcp"
}
}
}

Claude Status

Updated just now

Project

TailStats

Status

Complete

15 Card Types

One type for every metric

Numbers. Charts. Progress bars. Maps. Timers. QR codes. Pick what fits.

Basic Types

$

Revenue

$12,450

type: number

Message

Hello World

type: string

Storage

type: progress

Server

Online

type: status

Traffic

type: array

Rich Media

Image

URL or base64

Display avatars, thumbnails, charts, or any image from a URL or base64 data.

type: image

Map

Interactive markers

Native MapKit integration with custom markers, labels, and colors.

type: map

Message

Chat bubbles

Chat-style bubbles with sent/received modes. Great for notifications.

type: message

Advanced Types

Timer

02:34:15

timer

Gauge

75%

gauge

Link

Open Dashboard

link

List

Task 1
Task 2

list

QR

qrcode

Code

print("hi")

code

Log

[INFO] Started
[OK] Ready

log

Conditional Formatting

If this, show that

Change colors, icons, or text when values cross thresholds. Zero code required.

  • Any condition

    Numbers, strings, regex, HTTP status—all supported

  • Change anything

    Value, icon, emoji, color, even the card type

  • Stack them up

    Up to 10 rules per card. AND/OR logic. First match wins.

WHEN value > 80
THEN color: red icon: warning

Before

CPU
85%

After

CPU
Critical
Terminal
$ tailstats push build-status \
--value "Passing" \
--color green \
--menubar
✓ Card updated
CLI Tool

Script it. Cron it. Ship it.

Push data from anywhere—bash scripts, cron jobs, CI/CD pipelines.

  • tailstats push

    Values, JSON, or pipe file contents directly

  • tailstats notify

    Native macOS notifications with actions

  • One line to install

    curl -fsSL tailstats.com/install | sh

No Auth

Public APIs

Basic Auth

User/Password

Bearer Token

API Keys, JWT

OAuth 2.0

Auto refresh

Custom Headers

X-API-Key, X-Custom-Auth, and more

Auth? Handled.

OAuth2, Bearer tokens, API keys, Basic Auth. Whatever your API needs.

  • Keychain storage

    Credentials encrypted on your device

  • No SDK needed

    Standard HTTP auth—nothing proprietary

  • Auto token refresh

    OAuth tokens refresh before they expire

We never see your data

TailStats runs 100% locally. Credentials, metrics, everything—never touches our servers.

100% Local

Your device talks directly to your APIs

Keychain Encrypted

Secrets stay in the macOS/iOS keychain

Zero Telemetry

No analytics. No tracking. No data collection.

Want Cloud Sync?

Optional upgrade coming soon to sync cards across devices

View Roadmap

Mac. iPhone. Android.

Native apps that feel at home on every platform.

macOS

Menu bar at a glance

$12.4K +5%
Online
  • Up to 5 metrics in menu bar
  • Per-item colors & styling
  • SF Symbols support
  • Launch at login

iOS

Home & Lock screen widgets

$
Revenue
$12,450
  • Home screen widgets
  • Lock screen widgets
  • SF Symbols support
  • Background refresh

Android

Material You integration

💰 Revenue
$12,450
  • Home screen widgets
  • Dynamic theming
  • Emoji icons
  • Background refresh

Style it your way

Colors. Icons. Number formats. Make every card look exactly right.

Colors

Named colors or hex codes for cards and badges.

Smart Colors

Auto-colors based on content. Zero config needed.

"success"
"error"

Icons

SF Symbols on Apple, emoji everywhere.

$
%
#
@

Formatting

Currency, percentages, compact numbers.

currency $1,234
compact 1.2M
Drag & drop to reorder your cards

Fresh data. Always.

Configurable polling. Smart caching. Works offline too.

  • Your refresh rate

    30 seconds to 1 hour—you decide

  • Offline mode

    Shows last known values when disconnected

  • Manual refresh

    Pull down or tap to update instantly

  • Auto-retry

    Reconnects automatically when you're back online

30 sec
Real-time
1 min
Active
5 min
Standard
15 min
Relaxed
1 hour
Daily
Last updated Just now

Your metrics deserve better than a browser tab.

Free forever for local use. Cloud sync & advanced features from $5/month.

Download Free

macOS, iOS, Android • No account required • Upgrade anytime