JSON in.
Every screen out.

Push from any source. See it on Mac, iPhone, or Android. Here's everything under the hood.

Four ways in

Pull it. Script it. Push it. Post it. Your data, your workflow.

Pull Endpoints

Set & Forget

Point TailStats at any URL. It polls on a schedule and displays what comes back. Zero glue code required.

GET https://api.example.com/status every 30s
99.7%

Best for third-party APIs and status pages

Scripts

Cloud & Local

Write a JavaScript cloud script and get an endpoint for any device. Or run local bash, Python, or Ruby scripts on macOS. Either way, data flows to your cards automatically.

// your script
export default async () => {
const res = await fetch('...');
return { value: res.total };
}

Best for custom data sources

CLI

One-liner

tailstats push from a terminal, cron job, or CI step. Pipe in values, JSON, even sparklines.

$ cron: every 5 minutes
tailstats push cpu \
--value "$(uptime | awk '{print $NF}')" \
--sparkline "12,18,24,19,22"

Best for cron jobs, CI/CD, and automation scripts

Push & Webhooks

Real-time

POST to your card's endpoint whenever something happens. Stripe webhook fires? Deploy finishes? Your card updates instantly.

POST app.tailstats.com/cards/{id}
Content-Type: application/json
"title": "Payments",
"value": 2,847

Best for webhooks, event-driven systems, and real-time data

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 every screen.

$ 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
MCP

Give any AI agent a direct line

Connect locally for instant updates, or use Cloud MCP from remote agents and CI/CD pipelines. Same tools, same API.

  • Local in one line

    Point any MCP client at localhost:9876. Zero auth needed.

  • Cloud MCP

    Remote endpoint at app.tailstats.com/mcp. Bearer token auth, works from any device.

  • Full card control

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

Local
{
"mcpServers": {
"tailstats": {
"type": "http",
"url": "http://localhost:9876/mcp"
}
}
}
Cloud
{
"mcpServers": {
"tailstats": {
"type": "http",
"url": "https://app.tailstats.com/mcp",
"headers": {
"Authorization": "Bearer <token>"
}
}
}
}

Deploy 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
Actions

Tap a button.
Trigger anything.

Interactive buttons on your cards—fire HTTP requests or run local scripts, with confirmation dialogs, form inputs, and result feedback.

  • Card & item-level

    Button row on the card, or per-item actions on hover

  • HTTP & scripts

    POST to any endpoint from every platform. Shell scripts on macOS.

  • Forms & confirmation

    Text and dropdown inputs. Confirmation before destructive actions.

Production

us-east-1 · 3 instances

Healthy

Stop instances?

This will stop all 3 production instances. Are you sure?

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.

Pull from any device for free—or upgrade to push once and sync everywhere.

macOS

Menu bar. Desktop. Always current.

$12.4K +5%
Online
CPU 42%
Float
  • Up to 5 metrics in menu bar
  • Floating desktop cards
  • 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

Push data in.
See it everywhere.

Free for local push.
Cloud sync across all devices from $9/month.

Download Free

Mac • iPhone • Android • Web • No account required