pi-swamp-panel

Swamp global stats and Genesis Quest progress as a pi-atelier sidebar panel

Packages

Package details

extension

Install pi-swamp-panel from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-swamp-panel
Package
pi-swamp-panel
Version
0.1.0
Published
Aug 20, 2026
Downloads
151/mo · 24/wk
Author
simon.helson
License
MIT
Types
extension
Size
499.8 KB
Dependencies
1 dependency · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions/index.ts",
    "node_modules/pi-atelier/extensions"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-swamp-panel

A pi-atelier sidebar panel showing your swamp account, CLI version, global telemetry counters, and Genesis Quest progress. Values refresh automatically after any swamp command runs.

SWAMP
User: mrcrocodile · free
Ver: 20260813.214732
Global Stats:
Calls: 5546
ErrCalls: 51  UserErr: 9
Quests:
Tier: 13/15  XP: 5550
Next: Halogen Saint
Current XP: 6100
To Go: 550

Requirements

  • pi-atelier (bundled automatically from npm when this package is installed)
  • swamp on your PATH

You still need to make the sidebar visible (see Enable the panel below) if it is turned off.

Install

pi install npm:pi-swamp-panel

Or from git, or a local checkout:

pi install git:github.com/shelson/pi-swamp-panel
pi install /path/to/pi-swamp-panel

Add -l to write to project settings (.pi/settings.json) instead of your user settings.

Enable the panel

Contributed panels are hidden by default, so the panel will not appear until you turn it on once:

  1. Run /atelier
  2. Go to Settings → Display
  3. Find swamp:global in the sidebar panel list and toggle it visible
  4. Save

This is a one-time step; the setting persists.

Behaviour

The panel only registers itself when the session's working directory is inside a swamp repository, detected by walking up from cwd looking for .swamp.yaml. Switch to a non-swamp project and the panel unregisters itself.

Data comes from swamp auth status, swamp version, swamp telemetry stats, and swamp quest, all run in parallel with --json and a 5s timeout each.

  • Refresh is triggered by any swamp command in a bash tool call (2s trailing debounce) and by !swamp … user bash (6s, since there is no post-execution event). One refresh runs at a time; triggers arriving mid-flight collapse into a single re-run.
  • Staleness: a command that fails or times out keeps its last good values and renders them dimmed, and the panel title turns purple instead of orange. A section that has never returned data is omitted entirely rather than showing zeros.
  • Signed out: User: becomes an orange Not logged in, and the Quests block is hidden (signed out, swamp quest still exits 0 with a zeroed ladder, which is not real progress).

Rows are single-coloured because pi-atelier strips ANSI from contributed panels and paints one role per row.

Development

npm test    # pure, no swamp CLI or network needed

License

MIT