---
slug: "season179-pi-buddy"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/season179/pi-ecosystem@main/README.md"
repo: "https://github.com/season179/pi-ecosystem"
source_file: "README.md"
branch: "main"
---
# pi-ecosystem

Season's Pi packages, published independently to npm.

## Packages

- [`@season179/pi-worktree`](https://github.com/season179/pi-ecosystem/tree/HEAD/packages/pi-worktree) - Adds a Claude Code-like `--worktree` flag to Pi.
- [`@season179/pi-skills-status`](https://github.com/season179/pi-ecosystem/tree/HEAD/packages/pi-skills-status) - Shows the skills used in the current Pi session.
- [`@season179/pi-readbeam`](https://github.com/season179/pi-ecosystem/tree/HEAD/packages/pi-readbeam) - Automatically replaces assistant messages with highlighted placeholders (proof-of-concept).
- [`@season179/pi-guard`](https://github.com/season179/pi-ecosystem/tree/HEAD/packages/pi-guard) - Prevents destructive or unauthorized coding-agent tool actions.
- [`@season179/pi-model-fallback`](https://github.com/season179/pi-ecosystem/tree/HEAD/packages/pi-model-fallback) - Automatic model failover driven by a standalone fallback-models.json config.

## Development

```bash
npm install
npm run build
npm pack --workspace @season179/pi-worktree
npm pack --workspace @season179/pi-skills-status
npm pack --workspace @season179/pi-readbeam
npm pack --workspace @season179/pi-guard
npm pack --workspace @season179/pi-model-fallback
```

## Publishing

Scoped public packages require `--access public`. Prefer the GitHub Actions
`Publish` workflow (`workflow_dispatch`) for packages listed there; local
publish works the same way:

```bash
npm publish --workspace @season179/pi-worktree --access public
npm publish --workspace @season179/pi-skills-status --access public
npm publish --workspace @season179/pi-readbeam --access public
npm publish --workspace @season179/pi-guard --access public
npm publish --workspace @season179/pi-model-fallback --access public
```