Focus.AI Labs / Artifact Field Notes Tools & Utilities
Fast browse / jump off / source-grounded
Tools & Utilities

pi-sub

Monorepo for usage tracking extensions with shared core (sub-core, sub-bar UI widget)

Origin
seed-list
Extensibility
standalone
Primary interface
unknown

What this artifact is for

The quick orientation layer before you go deeper upstream.

Profile

Summary

Monorepo for usage tracking extensions with shared core (sub-core, sub-bar UI widget)

Seed description: Monorepo for usage tracking extensions with shared core (sub-core, sub-bar UI widget)

Category: Tools & Utilities

Best for: Not yet synthesized.

Signals

How to read this page

Workflow tags: none captured

Integrations: none captured

Caveats: No caveats captured yet

Maturity: No maturity signals captured

README excerpt

More of the actual upstream surface so you can skim here before deciding to open the repo.

Upstream skim

Monorepo for the sub-* extension ecosystem: a shared usage core (sub-core), UI clients (like sub-bar), and headless consumers that subscribe to usage updates.

sub-core can power multiple sub-* extensions at once, including rich UI clients like sub-bar and compact/headless-friendly clients like sub-status.

| Package | Description | | --- | --- | | @marckrenn/pi-sub-core | Shared fetch/cache core (pi extension). | | @marckrenn/pi-sub-bar | Rich widget display client (pi extension). | | @marckrenn/pi-sub-status | Compact status-line display client (pi extension). | | @marckrenn/pi-sub-shared | Shared types + event contract (npm package). |

Preview source: captured upstream text ↗

What shows up in the source

Quick topics

pi-subOverviewPackagesIdeas / planned sub-* extensionsRequirementsPi package managerQuick Start (manual install)Enable the shared core plus one or both display clients

Skim bullets

  • sub-core: fetches usage + status, manages cache/locks, owns provider selection, and emits updates via pi.events.
  • sub-bar: UI widget that renders the current usage state above the editor.
  • sub-status: compact status-line client that renders the current usage state via ctx.ui.setStatus(...).
  • sub-shared: shared types + event contract (published to npm as @marckrenn/pi-sub-shared).
  • Node.js >= 20 (see .nvmrc)
  • npm (bundled with Node)
  • Render cached state immediately (even if stale).
  • Fetch fresh usage in the background.

Sources and provenance

Everything on this page should be traceable back to the list seed or an upstream surface.

Provenance

Discovery reason: Listed in the awesome-pi-agent README

Discovered from: seed artifact

Claim confidence: medium

Surface capture kind: repo-readme