Skip to main content

Code Puppy Core Plugins

Official plugin bundle for Code Puppy.

This distribution contains Code Puppy's builtin feature plugins. The core runtime discovers them through the code_puppy.plugins Python entry-point group, so the runtime remains independent of plugin implementation modules.

Installation

Normal users do not need to install this package directly: code-puppy depends on it and installs a compatible version automatically.

For development:

git clone https://github.com/mpfaffenberger/code_puppy.git

git clone https://github.com/mpfaffenberger/code_puppy_core_plugins.git
cd code_puppy_core_plugins
uv sync
uv pip install -e ../code_puppy
uv pip install -e .
uv run pytest

Architecture

Each plugin is a package under code_puppy_core_plugins/ with one register_callbacks.py. Package metadata advertises those modules as entry points. Code Puppy loads the entry points as its builtin tier, followed by user plugins and trusted project plugins.

The package deliberately does not depend on code-puppy in its own metadata. code-puppy depends on this bundle; adding the reverse edge would create a packaging dependency cycle. Plugin CI installs the core runtime separately.

Completion notifications

The completion_notification plugin is disabled by default. Enable a native, best-effort desktop notification after a successful top-level response with:

/set completion_notifications=true

Notifications use a sanitized, shortened copy of the latest user prompt as the title and a shortened response preview as the body, with Apple Terminal, iTerm2, or Warp labeled through TERM_PROGRAM when available. Unknown terminals omit the terminal label. Sub-agent completions are intentionally silent. Desktop notification centers may retain visible prompt and response previews.

Optional sound configuration is platform-aware:

/set completion_notification_sound=Frog

On macOS, a simple name selects a system sound (Frog, Glass, Ping, etc.). Preview one with afplay /System/Library/Sounds/Frog.aiff. On any platform, an absolute path to a local sound file is accepted when an available platform player can play it. Linux uses notify-send for desktop notifications when it is installed; Windows uses a best-effort PowerShell toast. No external Python dependencies are required.

Logfire

The logfire_instrumentation, logfire_oauth and logfire_sessions plugins do not import the SDK until you opt in. The SDK is an optional extra:

uv tool install code-puppy --with 'code-puppy-core-plugins[logfire]'

Opt in to pydantic-ai instrumentation with /set enable_logfire=true (or a truthy CODE_PUPPY_ENABLE_LOGFIRE for headless runs), then restart. Spans are sent only when a write token is available, either your own LOGFIRE_TOKEN or one minted by /logfire onboard. Opting in without the extra installed shows an install hint instead.

pstack

The pstack plugin bundles poteto's pstack skill pack (MIT, Lauren Tan), adapted from Cursor to Code Puppy. It is disabled by default. /pstack describes it and /pstack on enables it. Details are in code_puppy_core_plugins/pstack/README.md.

Releases

Pushes to main run lint and tests, bump the patch version, build, publish to PyPI as code-puppy-core-plugins, and push the version tag. Configure the PYPI_API_TOKEN repository secret before the first release.

License

MIT

Metadata

Release files for code-puppy-core-plugins 0.0.106

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for code-puppy-core-plugins 0.0.106
File Size Uploaded Provenance Actions
code_puppy_core_plugins-0.0.106.tar.gz 963.9 kB Without provenance Details for code_puppy_core_plugins-0.0.106.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for code-puppy-core-plugins 0.0.106
File Interpreter ABI Platform Actions
code_puppy_core_plugins-0.0.106-py3-none-any.whl Python 3 none any Details for code_puppy_core_plugins-0.0.106-py3-none-any.whl

Total release size: 2.3 MB

Release files / code_puppy_core_plugins-0.0.106.tar.gz

Download URL code_puppy_core_plugins-0.0.106.tar.gz
Size 963.9 kB
Tags Source
SHA-256 checksum
How to use checksums
bce3e0c4a134d7c9d26835e47b8e21a2d5b635ad0ce3df817ab9f45782a5a5d1
BLAKE2b-256 checksum
How to use checksums
a1833acae4d0c0fd4b3ee1a28bbb03166ceceea6e033c5ee9b885d0514b1f083
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.18

Release files / code_puppy_core_plugins-0.0.106-py3-none-any.whl

Download URL code_puppy_core_plugins-0.0.106-py3-none-any.whl
Size 1.3 MB
Tags Python 3
SHA-256 checksum
How to use checksums
94633d30978ea0886a33a1289b91a2a92bccce766963fb7d609f0f15c73c9709
BLAKE2b-256 checksum
How to use checksums
fc0bb16013d647eceab11242b9392987c46793177e4381bb93ba572763c91779
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.18

Security for code-puppy-core-plugins 0.0.106

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.0.106 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page