pixel-openspace

Your cron jobs, at their desks.

pixel-openspace shows your scheduled jobs, CI pipelines and AI agents as a pixel-art office. Running jobs sit down and type, idle ones go get coffee, and when one fails its PC starts to smoke and the lead walks over.

  • cron
  • launchd
  • systemd timers
  • GitHub Actions
  • AI agents
  • queues
  • deploys
$
Star it on GitHubBuy me a coffeeMIT

A shadcn/ui component for Next.js and React. Free and open source under the MIT license.

Sky
Try it:

What it watches

Anything that runs on a schedule or on demand, and can succeed or fail. Some of it comes in without a line of code; the rest takes one API route.

In your README too

Paste one line into any repository’s README: its GitHub Actions workflows at their desks, up to date, animated. The image refreshes every five minutes.

Add &theme=farm, &lang=fr, &cols=6 or &title=ACME to the address.

This repository’s own room, live.
This repository’s own room, live.

A dashboard, in isometric view

Experimental: the same room in volume, each agent a little 3D character (its outfit, sometimes headphones or a cap), one zone per source. Click one to zoom in on it. A second block wraps it in a dashboard: per-source cards, what needs you, the planning of the day and the team.

$
Open the dashboard demo
The same team, split between a Mac and a GitHub repository.

Read the room

Each job gets a desk and a status. You set the status from whatever you already track: an exit code, a queue, a last run date. The room does the rest, so one glance tells you what is running, what is stuck and what broke.

working
Sits at its desk and types. Code scrolls on its screen, its keyboard and fans light up.
ok
Up to date. Gets up now and then for a coffee, a round of arcade or a chat with a colleague.
late
Missed its run. Dozes at its desk until it catches up.
asleep
Missed its run while the laptop was asleep. Sleeps at its desk, screen off, and the lead leaves it alone: nothing is broken.
failed
Red screen, smoking PC. The lead walks over and stays until it recovers.
off
Not loaded. An empty chair and a post-it on a dark screen.
never
Hired, but has not run yet.
on-demand
Only works when asked. Lives its life in between.

Set it up in three steps

  1. 1

    Add the component

    The shadcn CLI copies the component’s files into your components folder, yours to read and change. The labels in the room use Pixelify Sans: load it with next/font into a --font-pixel variable.

    $
  2. 2

    Feed it your jobs

    Expose your jobs’ state, poll it every few seconds and pass it down. When a status changes, the room reacts: the job sits down to work, or stands up, stretches and says its last log line in a speech bubble. For your GitHub Actions CI, githubAgents() writes this route for you: it finds your repository and gives each workflow a desk.

    // app/api/jobs/route.ts
    export async function GET() {
      const jobs = await db.job.findMany()
      return Response.json(
        jobs.map((job) => ({
          id: job.id,
          name: job.name,
          emoji: job.emoji,
          status: job.running ? 'working' : job.lastExitCode ? 'failed' : 'ok',
          lastRun: job.lastRunAt,
          nextRun: job.nextRunAt,
          lastMessage: job.lastLogLine,
        })),
      )
    }
  3. 3

    Leave it on a screen

    It is made to stay open all day on a side screen, in fullscreen. The room runs at 30 frames per second and only redraws what moved. After twenty quiet seconds everything freezes until someone gets up, and at night everybody stays at their desk.

Also in the room

None of this is needed to watch your jobs. It is there because an office you look at every day should be a nice place.

Seven themes
Geek, 1980s office, gym, modern office, restaurant kitchen, neon city, cozy farm: each tells the statuses its own way.
Two arcade cabinets
Component Snake and Chip Breaker, both playable. High scores hang on the wall.
A wall screen
Up to four numbers of your own: jobs today, errors, queue size, budget.
The lead
Does its rounds while it runs, then reports in front of the wall screen and reads your announcements.
A window on the weather
Sun, rain, snow or storm, day or night, with the temperature you pass it.
Visitors and couriers
Bump a counter and someone walks in: a visitor greets the lead, a courier drops a parcel.
Seasons
Pumpkins and a ghost all October, a Christmas tree and garlands all December, hidden eggs and a hopping bunny at Easter.
The office cat
Naps on whichever desk was left empty.
Reduced motion
If your system asks for less motion, everybody stays at their desk.
The day timeline
Under the room, one dot per run since midnight, red when it failed. Click a job’s name for its runs of the day, and since when it has been failing.
A settings gear
Whoever watches the room renames the sign, picks the weather city, the theme and the language, and turns things on or off. Saved in their browser.
Alerts and sound
Browser notifications when a job fails, 8-bit beeps for starts and failures. Both off until you turn them on.

What’s new

The latest versions, straight from the changelog. Each one is also a GitHub release: watch the repository to hear about the next ones.

Full changelog
  1. 0.15.0

    Changed
    • Iso view: the agents are now little 3D characters instead of animated objects. A round colored head with big eyes, the theme's outfit (top, trousers, sneakers), and for some white headphones or a cap; the lead keeps a crown. Seated at their desk they face us, like the lead.
    • The dashboard and its iso room ignore nightHours by default ([0, 0]): the agents keep walking in the evening. Pass nightHours to bring the night back.
    Added
    • Iso view: click an agent to zoom in on it. The room slides and grows to center it, and its card opens top right; click the floor, the agent again or the card's cross to see the whole room.