pix-core

Pi coding agent extension — core UI/UX meta-package.

Installing pix-core pulls in all of the packages below as npm dependencies and activates them. A single pi install npm:@xynogen/pix-core boots every core extension — you do not need to install the members individually.

How it works

Pi activates extensions per installed package via each package's pi.extensions manifest; it does not walk npm dependencies. So pix-core ships a thin aggregator (src/extension.ts) that imports each member's extension factory and invokes it against the same host. Each member also carries a globalThis idempotency guard, so installing pix-core and a member standalone activates that member only once.

What's included

UI / UX extensions

Package	Description
pix-welcome	ASCII π banner + startup health checks (version, auth, models, gitignore)
pix-footer	Status bar: mode / git branch / model / cost / live TPS
pix-models	/models — enhanced model picker with BenchLM rank, context, cost
pix-update	/update — self-update Pi + refresh extensions
pix-commands	/diff and /clear slash commands
pix-diagnostics	Compact LSP diagnostic widget
pix-prompts	System-prompt injection (AGENTS.md + repo directive files)
pix-skills	Agent skill loader (read_skills tool + 23 bundled skills)
pix-nudge	Tool + capability nudge hooks

Tool suite (drop-in replacements for Pi's built-in tools)

Package	Description
pix-read	read — file read with syntax highlighting
pix-write	write — file write with split-diff rendering
pix-edit	edit — precise text replacement with per-edit diff
pix-find	find — glob search with FFF acceleration
pix-grep	grep — pattern search with FFF-prioritised results
pix-ls	ls — directory listing as an icon tree
pix-bash	bash — shell execution with framed output + exit-code summary
pix-todo	todo — durable execution checklist
pix-ask	ask_user — structured TUI questionnaire

Behaviour

Package	Description
pix-optimizer	Caveman mode + RTK tool rewriting + jq/TOON JSON compression (/opt)
pix-gate	Permission gate for dangerous bash commands

Install

pi install npm:@xynogen/pix-core

Installs and activates the core pix UI/UX extensions in one command. Members are deduped if also installed directly.

Full distro

To install the complete pix suite (all packages + Pi itself):

curl -fsSL https://raw.githubusercontent.com/xynogen/pix-mono/main/scripts/install.sh | sh

License

MIT