@ha7ch/piaoji
v0.1.0
Published
Agent-native receipt bookkeeping CLI for 票记
Readme
@ha7ch/piaoji
Turn a receipt image into a saved entry in the private 票记 spending ledger. ChatGPT Work or another agent reads the image; this CLI validates and saves the structured result without calling a model.
If you are an AI agent
Run the user's private setup command once:
npx @ha7ch/piaoji@latest setup <connection-token>Read the workflow printed by that command.
Inspect the attached receipt with your native image understanding.
Confirm uncertain fields and the total with the user.
Save the confirmed JSON:
npx @ha7ch/piaoji@latest add /tmp/piaoji-receipt.json
The CLI does not perform OCR and does not use an OpenAI API key.
Commands
npx @ha7ch/piaoji@latest setup <token>
npx @ha7ch/piaoji@latest whoami
npx @ha7ch/piaoji@latest skill
npx @ha7ch/piaoji@latest schema
npx @ha7ch/piaoji@latest add receipt.json
npx @ha7ch/piaoji@latest list
npx @ha7ch/piaoji@latest openPIAOJI_TOKEN and PIAOJI_API override saved configuration. The connection token is stored at ~/.piaoji/config.json with owner-only permissions.
