guneriu-pi-files

内容来源:README.md(说明文档) · 原始地址 · 查看安装指南

原始内容

pi-extension-mono

Pi coding agent extensions by guneriu.

Extensions

Package npm Description
@guneriu/pi-files pi install npm:@guneriu/pi-files Agent-edited files widget + interactive project tree (/pi-files, type-to-filter, Space to peek)
@guneriu/pi-session-files pi install npm:@guneriu/pi-session-files Track context, read, and modified files in your session
@guneriu/pi-keybindings-help pi install npm:@guneriu/pi-keybindings-help Press ? on an empty editor → floating keybindings reference
@guneriu/pi-copilot-quota git only GitHub Copilot quota chip, session cost, /copilot-rates
@guneriu/pi-footer git only Enhanced footer — tokens, cache %, context bar, Copilot cost breakdown

Install

# Individual packages (npm — latest):
pi install npm:@guneriu/pi-files
pi install npm:@guneriu/pi-session-files
pi install npm:@guneriu/pi-keybindings-help

# Individual packages (npm — pinned to a release):
pi install npm:@guneriu/pi-files@0.2.0
pi install npm:@guneriu/pi-session-files@0.2.0
pi install npm:@guneriu/pi-keybindings-help@0.2.0

# All five from GitHub (the only way to get copilot-quota and pi-footer):
# Note: git install always loads all extensions listed in the root package.json.
pi install git:github.com/guneriu/pi-extension-mono

# Local development:
pi install /path/to/pi-extension-mono

Requirements

  • pi coding agent
  • gh CLI — required by pi-copilot-quota
  • GitHub Copilot subscription — required by pi-copilot-quota

Development

npm ci                      # install workspace deps
pi install ./pi-extension-mono   # try it inside pi; /reload after edits
make check                  # local gate: test + pack/publint checks

See Makefile (make help) for all automation targets.

Versioning & releases

Packages are versioned independently with Changesets. Releases are run locally by the maintainer (no CI/CD).

  1. Make a change, then record it: npx changeset (or make changeset).
  2. When ready to ship: make version (bumps + writes CHANGELOGs), commit it.
  3. make release-local publishes changed public packages to npm; then git push --follow-tags (and optionally gh release create per tag).

Git-only packages (copilot-quota, pi-footer) are private: true and are versioned/changelogged but never published to npm. Full details in .changeset/README.md and AGENTS.md.

Contributing

Issues and PRs welcome — see CONTRIBUTING.md, CODE_OF_CONDUCT.md, and SECURITY.md.

License

MIT © Uğur Güneri