macOS Free and open source
Hold fn.
See everything.
A glanceable dashboard for your Mac. Anything you can script becomes a panel, and it disappears when you let go.
NAME READY STATUS RESTARTS AGE api-7d9f4-x2kq 1/1 Running 0 2d api-7d9f4-p8vn 1/1 Running 0 2d export-1794-lq 0/1 CrashLoopBackOff 12 41m web-5c88b-r7t2 1/1 Running 0 6h worker-6b2-h5c 1/1 Running 1 1d
Hold Space or the fn key to glance. Let go to close.Press and hold fn to glance. Let go to close.
How it works
A dashboard that's only there when you look.
No window to find, no tab to switch to, no widget eating screen space. Tjuvkik lives in the menu bar and shows up for exactly as long as you hold the key.
- 1
Hold fn
The board opens over whatever you're doing, on the screen you're working on, over every Space and full-screen app.
- 2
Glance
Panels refresh in the background on their own interval, so what you see is already fresh. A stale one catches up the moment you look.
- 3
Let go
It's gone. The glance never takes focus, so your terminal keeps the cursor and you keep typing.
No fn key, or using it for something else? Pick right ⌥, right⌘ or a shortcut like ⌃⌥Space. Hold it, tap to toggle, or double tap. Pin the glance to click rows and move around with the keyboard.
Panels
Anything you can script is a panel.
A panel is a folder with a panel.jsonc and a command. The command prints JSON, Tjuvkik draws it. Rows can carry actions, so the glance isn't only for looking.
{
"$schema": "https://tjuvkik.banjoanton.com/schema/panel.schema.json",
"type": "script",
"title": "Pull requests",
"command": "./prs.sh",
"every": "5m",
"requires": ["gh", "jq"],
"size": "m"
}#!/bin/sh
gh search prs --review-requested=@me --state=open \
--json number,title,repository,url |
jq '{
hero: { value: "\(length)", label: "reviews requested" },
rows: map({
icon: "👀", title, url,
subtitle: "\(.repository.nameWithOwner) #\(.number)",
actions: [
{ title: "Approve", key: "a",
command: "gh pr review \(.url) --approve" },
{ title: "Check Out", command: "gh pr checkout \(.url)" },
{ title: "Copy Link", copy: .url }
]
})
}'Any language
Shell, Python, Node, Go, a curl. If it prints JSON to stdout, it's a panel. If it doesn't, a cli panel shows its output as is.
Interval or stream
Run every 30 seconds, or keep the command running and update the tile on every line, like tail -f.
Act on what you see
Click a row to open its link or run its command. ⌘K lists its actions, ⌘ and a key runs one. Approve, check out, jump, copy.
One panel, many tiles
Panels take options, so the same CI panel watches five repos. Each tile sets its own; the script reads them from the environment.
The smallest panel there is: your Downloads folder, newest first.
ls -t ~/Downloads | head -20 | jq -R '{ title: . }' | jq -s '{ rows: . }'Panel types
Twelve ways to draw your output.
Rows by default. Name a type at the top of your JSON and the same script gets a chart, a table, a timeline or a feed, each drawn for the size of its tile.
Pull requests
scriptevery 5m2reviews requestedfeat: export filtersacme/web #12841hfix: retry webhook deliveryacme/api #8123hchore: move to pnpm 12acme/web #12791drowsA list with icons, tones, groups and a note for what needs you.git status
clievery 10sOn branch feat/export-filters Your branch is ahead of 'origin' by 2 commits. Changes not staged for commit: modified: src/export/filters.ts modified: src/export/filters.test.ts Untracked files: src/export/presets.ts
cliAny command's output as is. No JSON needed.GitHub this week
statsevery 1hMerged12▲ 4vs lastReviews given19▲ 7vs lastTime to review3.2h▲ 1.1hmedianOpen PRs7±02 draftsstatsA few numbers, each against its last period.API latency
chartevery 1m182ms▼ 24ms in 1hp95, api prodchartOne number and where it's heading.API quotas
metersevery 5mGitHub4,212 / 5,000OpenAI$31 / $50Sentry12k / 50kResets in 3 daysmetersHow full, how far, how close to a limit.Top processes
tableevery 5sProcess CPU Memory PID node (vite) 84% 1.2 GB 48211 Brave Browser 31% 3.4 GB 1022 opencode 12% 640 MB 33871 Docker 9% 4.1 GB 811 Slack 3% 520 MB 2209 tableThe same fields for every row, in columns.Deploys this week
timelineevery 15mProd window in1d 4hThu 14:00 · api 2.10, web 3.15web 3.14api 2.9freezeprodMonTueWedThuFriNowCode freeze until Thu 10:00NextProd window Thu 14:00timelineWhat's now, what's next, and how long until.Mentions
feedevery 1m28mSara Lind #webCan you look at the export PR before the demo?1hGitHub acme/web #1284Johan requested your review on feat: export filtersSunKim Ek DMNice work on the calendar fix 🙌feedWho said what, and when. Unread marked.Uptime, 24h
gridevery 5mweb100%api99.2%auth100%searchdowncdn100%queue100%mail100%billing100%docs100%gridMany things at once, a colored cell each.Environment
keyvalueevery 30sKubernetesContextprod-eu-westNamespacewebRepoBranchfeat/export-filtersNodev24.15.0Uncommitted3 fileskeyvalueExact facts, grouped. Know where you are before you run it.Release 5.3
checklistevery 5m1/5steps · release Thu 14:00Freeze mainSmoke test on stagingexport and calendar leftSaraSign-offWaiting for Kim, out until WedDeploy to prodAntonPost release noteschecklistSteps, and what's done, next and stuck.On call
markdownon changeOn call this week
Anton until Fri 17:00, then Sara.
search is degraded since 11:20.
Restart a stuck export
- Find the job:
kubectl get jobs - Delete it, the cron job starts a new one
markdownNotes, runbooks and answers. Or a file the panel reads.- Find the job:
Working with AI agents
Tjuvkik doesn't know about agents. Your script does.
Running Claude Code, Codex and opencode in five terminals? Point a stream panel at whatever tracks them and see, in one glance, which agent has been waiting on you for twenty minutes. No plugin per tool, no waiting for support.
- Which one needs youBlocked, failed, working and done, with what it's waiting for right under it.
- A notification when it mattersSent when an agent starts waiting, withdrawn when it stops. Quiet hours included.
- The count in the menu bar✋ 2, without opening anything.
- Jump straight to itA row's command focuses the session. Click it, or press ↵.
{
"$schema": "https://tjuvkik.banjoanton.com/schema/panel.schema.json",
"type": "script",
"mode": "stream",
"title": "Agents",
// Anything that prints one JSON line per change
"command": "agent-watcher --watch | jq -c -f rows.jq",
"size": "l",
"notify": { "on": ["warning", "error"] }
}Agent-friendly
Ask your agent for a panel. It can check its own work.
Every file has a JSON Schema, and the command line closes the loop: make a panel, run it, render its tile to a PNG, validate the folder. A coding agent can write a panel, look at the picture and fix it, without you opening anything.
$ tjuvkik new deploys --type timeline
created ~/.config/tjuvkik/panels/deploys/panel.jsonc
created ~/.config/tjuvkik/panels/deploys/deploys.sh
$ tjuvkik run deploys
deploys: timeline, ran in 0.84s
shows timeline, 4 events
$ tjuvkik preview deploys --size m
deploys-m.png: m, 535×185 pt at 2x, deploys
$ tjuvkik validate
✓ config.jsonc and 7 panels are valid, 6 on the boardMake a Tjuvkik panel that shows this week's deploys from `gh run list` as a timeline. Start with `tjuvkik new deploys --type timeline`, check the output with `tjuvkik run deploys`, look at `tjuvkik preview deploys` and fix it until it reads well, then run `tjuvkik validate`. The docs are at https://tjuvkik.banjoanton.com/llms-full.txt.
/llms.txtwhat Tjuvkik is, for a model/llms-full.txtevery doc, as one Markdown file/schema/*.schema.jsonconfig, panel and theme schemas, for$schema
Config as code
One folder. Plain files. Yours.
There's no account and no cloud. Everything lives in ~/.config/tjuvkik as JSON with comments, with schemas for completion in your editor. The settings window edits the same files.
{
"$schema": "https://tjuvkik.banjoanton.com/schema/config.schema.json",
"theme": { "dark": "dark-glass", "light": "light-glass" },
"trigger": { "key": "fn", "mode": "hold" },
"menuBar": ["agents", "prs"],
"panels": [
{ "panel": "agents", "size": "l" },
{ "panel": "prs", "size": "m" },
{ "panel": "ci", "id": "ci-web", "options": { "repo": "acme/web" } },
{ "panel": "ci", "id": "ci-api", "options": { "repo": "acme/api" } },
{ "panel": "pods", "size": "m" }
]
}~/.config/tjuvkik/
├── config.jsonc what goes where, theme, trigger
├── panels/
│ ├── agents/
│ │ ├── panel.jsonc
│ │ └── agents.jq
│ ├── ci/
│ │ ├── panel.jsonc
│ │ └── ci.sh
│ └── prs/
│ ├── panel.jsonc
│ └── prs.sh
└── themes/
└── mine.jsonc { "extends": "dracula" }Keep it in your dotfiles
Link the folder with stow or ln -s. Tjuvkik follows the links.
Reloads on save
Change a file and the board updates within a second. A broken edit keeps the last good board and says what's wrong.
Checked in CI
tjuvkik validate prints every error with its file and key, and exits 1.
Share a panel by copying a folder
Fill in description, author and requires, and send it.
Native and light
- Native Swift
- No dependencies
- No Dock icon
- Never takes focus
- Pauses when locked or on Low Power
- Light and dark glass, Dracula, your own themes
- Launch at login
Take a peek.
Free and open source, for macOS 15 or later. Homebrew is on the way.