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.
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
1 maintainer
Release files for code-puppy-core-plugins 0.0.42
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| code_puppy_core_plugins-0.0.42.tar.gz | 543.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| code_puppy_core_plugins-0.0.42-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.3 MB
Release files / code_puppy_core_plugins-0.0.42.tar.gz
| Download URL | code_puppy_core_plugins-0.0.42.tar.gz |
|---|---|
| Size | 543.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1236d1850cd0022c36f2a3215c2614740bc641d35286f99653f8470a2d85d146
|
|
BLAKE2b-256 checksum How to use checksums |
3e2a1bc8ef299c5c40b81183890c2ff31449f2952022cfeb329f483b5763eb60
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
Release files / code_puppy_core_plugins-0.0.42-py3-none-any.whl
| Download URL | code_puppy_core_plugins-0.0.42-py3-none-any.whl |
|---|---|
| Size | 735.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
17ee286deb9c1a738d9a8ad73539a63a060f07161782c016216f4f7c98a7c73a
|
|
BLAKE2b-256 checksum How to use checksums |
43b5df5367961332e63b8f8583fd47ed68ee1df79edbff099198493a58f7d4a1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
