@janvitos/pi-clear-screen

Clear Pi's terminal viewport on launch and when starting a new session.

Packages

Package details

extension

Install @janvitos/pi-clear-screen from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@janvitos/pi-clear-screen
Package
@janvitos/pi-clear-screen
Version
0.1.3
Published
Aug 12, 2026
Downloads
481/mo · 481/wk
Author
janvitos
License
MIT
Types
extension
Size
4.4 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

Pi Clear Screen

A small Pi coding agent extension that clears the visible terminal viewport:

  • when Pi launches;
  • after the user starts a session with /new.

It also adds /clear as an alias for /new. The command starts a fresh session, clears the conversation context, and triggers the same reliable screen clear as /new.

The extension clears only the visible viewport, not terminal scrollback. It does not clear automatically on /reload, /resume, or /fork. Non-interactive Pi modes are unaffected.

Usage

Enter /clear in interactive mode to start a fresh session and clear the screen.

Install

Install from npm:

pi install npm:@janvitos/pi-clear-screen

Or install from GitHub:

pi install git:github.com/janvitos/pi-clear-screen

Restart Pi after installation, or run /reload in an existing session.

Try without installing

pi -e npm:@janvitos/pi-clear-screen

Requirements

  • Pi 0.84.1 or newer
  • Node.js 22.6 or newer for development tests
  • Interactive TUI mode

Development

npm test
npm run check
npm pack --dry-run

For local development, clone the repository and load index.ts with pi -e, or symlink the repository into ~/.pi/agent/extensions/.

Publishing

Releases are published through npm Trusted Publishing. Bump the version, push a matching tag, and publish a GitHub release; .github/workflows/publish.yml tests and publishes the package using GitHub Actions OIDC, without a long-lived npm token.

License

MIT