@kmjayadeep/pi-jobs-done-sound

Play a small sound when Pi finishes an agent turn.

Package details

extension

Install @kmjayadeep/pi-jobs-done-sound from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@kmjayadeep/pi-jobs-done-sound

Pi manifest JSON

{
  "extensions": [
    "./extension"
  ]
}

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

A tiny Pi extension that plays a short sound when Pi finishes an agent turn and is ready for your next instruction.

Useful when you kick off a longer task, switch windows, and want an audible cue when the job is done.

pi install git:github.com/kmjayadeep/pi-jobs-done-sound

Then restart Pi, or run /reload in an existing Pi session.

pi install npm:@kmjayadeep/pi-jobs-done-sound

pi install git:github.com/kmjayadeep/pi-jobs-done-sound

Then restart Pi, or run /reload in an existing Pi session.

pi -e git:github.com/kmjayadeep/pi-jobs-done-sound

# Or from npm
pi -e npm:@kmjayadeep/pi-jobs-done-sound

The extension includes extension/jobs_done.mp3 and tries these players:

If no player works, it falls back to the terminal bell.

The extension listens for Pi's agent_end event and plays the bundled MP3:

pi.on("agent_end", async () => {
  // play jobs_done.mp3
});

.
├── extension/
│   ├── index.ts
│   └── jobs_done.mp3
├── package.json
├── tsconfig.json
├── LICENSE
└── README.md

package.json declares this as a Pi package with:

{
  "keywords": ["pi-package", "pi-extension"],
  "pi": {
    "extensions": ["./extension"]
  }
}

npm install
npm run typecheck
pi -e ./extension

New versions are published to npm via a GitHub Actions workflow that uses OIDC for authentication and npm provenance — no stored secrets needed.

Before the first publish, set up an npm publisher on npmjs.com:

Go to npm publishers page for your account.
Click "Add Publisher".
Enter your GitHub repository URL: https://github.com/kmjayadeep/pi-jobs-done-sound.
Confirm the OIDC connection.

This tells npm to trust OIDC tokens from GitHub Actions for this repo.

Create and push a GitHub Release (with a tag like v0.1.0). The workflow at .github/workflows/publish.yml runs automatically:

# Tag and push
cd pi-jobs-done-sound
npm version patch    # bumps to 0.1.1, creates a git tag
git push --tags origin main

Then create a GitHub Release from the tag on the Releases page — this triggers the publish workflow.

Uses npm publish --provenance with id-token: write for OIDC.
Runs on release events (tag published) and can be triggered manually via the GitHub UI.
Runs type checking before publishing.

MIT