pi-zenmoney

ZenMoney Pi extension for account discovery and register exports.

Packages

Package details

extension

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

npm repohome report
$ pi install npm:pi-zenmoney
Package
pi-zenmoney
Version
0.1.1
Published
Jul 4, 2026
Downloads
318/mo · 12/wk
Author
eirenik0
License
MIT
Types
extension
Size
75.8 KB
Dependencies
1 dependency · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

README

pi-zenmoney

ZenMoney Pi package for account discovery, transaction export, and entity-scoped balance snapshots.

Overview

  • /zenmoney opens the settings hub for profiles, accounts, archived-account toggling, and snapshot-path setup.
  • /zen-transactions <selector[,selector...]> [YYYY-MM] exports normalized transactions for selected accounts.

Install

pi install pi-zenmoney

Local development:

pi install /absolute/path/to/this/repo

Git install:

pi install git:github.com/eirenik0/pi-zenmoney

Restart Pi after installing.

Configuration

Required:

  • ZENMONEY_TOKEN

The token may be a raw token, an op:// 1Password reference, op read ..., or $(op read ...).

Optional:

  • ZENMONEY_API_BASE_URL
  • ZENMONEY_SNAPSHOT_SELECTORS — fallback selectors for balance workflows when none are passed
  • ZENMONEY_SNAPSHOT_PATH — fallback relative snapshot folder, resolved in the working files folder
  • .pi/zenmoney/config.json — workspace config for the active entity
  • .pi/zenmoney/entities/<entity>/policy.json — per-entity selectors and snapshot_path used by /zenmoney
  • .pi/zenmoney/entities/<entity>/registry.json — cached live snapshot for analysis on top of the registry

Release notes

Release entries are tracked in CHANGELOG.md.

Publishing

GitHub Actions publishes the package from semver tags like v0.1.1. The workflow expects an NPM_TOKEN secret and skips versions that already exist on npm.

ZenMoney API

This extension uses the official ZenMoney API:

If you only need an API token, the ZenMoney wiki notes that you can reuse a previously registered ZenMoney service. For example: Zerro.app.

Notes

  • Extension entrypoint: src/index.ts
  • Core logic: src/zenmoney.ts, src/hub.ts
  • Secret reference helper: src/secret-refs.ts
  • Entity snapshots default to .pi/zenmoney/entities/<entity>/snapshots/ unless overridden by a relative path