portent
New in 0.3.0 Claude status and a portent CLI

See what your coding agents left running.

portent lives in the macOS menu bar: Claude plan usage per account, every dev server with who started it, and every live agent session, a click away.

Download for Mac

v0.3.0 · macOS 14+ · Apple silicon and Intel · free

Not notarized yet: the first time, macOS blocks the disk image, then the app. Allow each in Privacy & Security › Open Anyway. The command below skips this.

curl -fsSL https://getportent.pages.dev/install.sh | bash

No account, no tracking. portent only talks to Claude and this site, and update checks are counted without IDs.

The portent panel under its menu bar icon: plan usage for three Claude accounts, six dev servers with their health and who started them, and live sessions grouped by account changing state.

Plan usage

Know where every Claude account stands.

Session and weekly limits for each account and organization you use, side by side. portent tells you at 75% and 90%, and again when a heavily used window resets, so you can switch accounts before you hit the wall.

Work · Acme crosses 75% and a notification arrives; Personal crosses 90%, then its session limit resets.

Dev servers

Every dev server, and who started it.

Each port gets a health dot, its branch and its origin: a Claude Code or Claude Desktop session, Docker, or started by you.

  • CPU and memory per project, in orange when one runs hot.
  • Stop one port, a whole project, or everything an ended session left behind.
  • Protect the servers that must stay up; portent won't stop them.
  • Relaunch recently closed projects with the command they ran.
storefront finishes booting; orders-service is stopped, then started again from Recently closed.
Sessions grouped by account move between working, needs you and your turn.

Agent sessions

Which session is working, and which one needs you.

Live Claude Code and Claude Desktop sessions, grouped by account: working, needs you, or your turn. A bar shows how full each context window is, next to the servers that session started.

Notifications

Back to the right session in one click.

A notification when a session is waiting for a permission or an answer, or finishes a long turn. Click it and that exact session opens in Claude Desktop.

ACME-482 asks for a permission and a notification arrives; after a click, recipe-box finishes its turn.
Claude Code reports elevated errors: a notification arrives and a banner shows in the panel; later the incident is resolved and a second notification says so.

Claude status

Is it Claude, or is it you?

When claude.ai, the Claude API or Claude Code has an incident, a banner shows in the panel and a notification tells you, and again when it's resolved. Click either to read the incident.

Command line

Ask from the terminal, or let your agent ask.

The portent command lists your dev servers, stops one by port and shows your plan usage, with or without the app running. Add --json and Claude Code can check what's already on port 3000 before it starts another server.

 portent ls
PROJECT         PORTS        AGENT           BRANCH    STATE    COMMAND
portent         :3000 :5173  Claude Desktop  main      -        npm run dev
storefront      :4200        Claude Desktop  ACME-482  network  ng serve --port 4200
orders-service  :8080        Claude Code     ACME-490  -        java -jar app.jar
telemetry-api   :8000        Claude Code     NIM-37    orphan   python3 -m uvicorn app:api
mailpit         :8025        -               -         locked   docker compose up mailpit

Homebrew puts portent on your PATH. With the install script or the disk image, turn it on in Settings › General › Command line tool, which links it into ~/.local/bin.

And more

Made for busy days.

Floating window

Detach the panel into a translucent window on any display, as tall as you like, above other windows. Close it and portent goes back to the menu bar.

The panel detaches into a window, moves to the side and grows.

Open on your phone

Ports open to the network get an orange globe. Click it for a QR code, or right-click for the network URL.

storefront and mailpit with an orange network globe, and the QR code card it opens for http://192.168.1.20:4200.

Scales with your day

Fifteen servers, two dozen sessions: extras and idle sessions fold away when the panel is full.

The panel with four accounts and fifteen servers, the rest folded under More servers.

Light and dark

Follows your system appearance, or pick one in Settings.

Quiet health checks

A plain connection check every few seconds. HTTP requests only while the panel is open, so your server logs stay clean.

● :3000 connect · no request logged

Global shortcut

Open the panel from anywhere with a shortcut you pick in Settings.

For example Option Command P

Updates itself

Signed in-app updates with Sparkle. Install them automatically or when you choose.

v0.3.0 · release notes

What portent touches

Everything it shows comes from your Mac. No tracking, no portent account.

Reads locally
Listening ports, the processes behind them and their CPU and memory, Claude Code and Claude Desktop session files.
Goes online for
Your plan usage and Claude's status page, and updates plus a small table of model context sizes from this site.
Asks you for
Notifications, and Keychain access to read the login Claude Code already saved.

Install portent

One line in the terminal, Homebrew, or a disk image. Every way gets the same signed app, and it updates itself from then on.

curl -fsSL https://getportent.pages.dev/install.sh | bash

Downloads the latest release into Applications, clears the quarantine flag and opens it. Read the script first.

First launch

portent is signed with its own certificate and isn't notarized by Apple. The install script and the Homebrew cask clear the quarantine flag, so it opens normally. From the disk image, macOS says it can't verify the developer twice: once for the image and once for the app. Each time, open System Settings › Privacy & Security and click Open Anyway. On macOS 15 and later, right-click › Open no longer gets past it.

Questions

What do I need?

A Mac on macOS 14 Sonoma or later, Apple silicon or Intel. Plan usage works with the account Claude Code is signed into, and with any claude.ai accounts you sign in to inside portent.

Which agents does it know about?

Sessions from Claude Code and Claude Desktop. Dev servers show whether a Claude session, Docker or you started them.

Does it send my data anywhere?

No. portent reads ports, processes and session files on your Mac. It only goes online to read your plan usage and status from Claude, and to fetch updates and a small table of model context sizes from this site. There's no portent account. Update checks are counted per day and version, with no ID or IP stored, and the site counts visits without cookies.

Can my coding agent use it?

Yes, through the portent command. Every command takes --json and works without the app running. Add a line like “Run portent ls --json to see which dev servers and ports are in use” to your CLAUDE.md, and Claude Code checks before it starts another server.

Will it stop something I didn't ask it to?

No. portent stops a server only when you click Stop, and never stops projects you protect. When ports share a process, it tells you which ones stop together.

Why does macOS warn me the first time?

portent is self-signed, not notarized. The install script and Homebrew clear the warning for you; from the disk image, use Open Anyway in Privacy & Security once for the image and once for the app.

How do I uninstall it?

Quit portent from the panel and move it to the Trash, or run brew uninstall portent if you installed it with Homebrew.

Put your agents in the menu bar.

Download for Mac

v0.3.0 · macOS 14+ · other ways to install

Not notarized yet: the first time, allow the disk image, then the app, in Privacy & Security › Open Anyway.