pi-godot-toolkit

Godot 4 toolkit for pi: GDScript best practices, docs lookup, gdUnit4 tests and verification.

Packages

Package details

extension

Install pi-godot-toolkit from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:pi-godot-toolkit
Package
pi-godot-toolkit
Version
0.0.2
Published
Sep 29, 2026
Downloads
327/mo · 19/wk
Author
tudorrr
License
MIT
Types
extension
Size
17.3 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions/godot.ts"
  ]
}

Security note

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

README

pi-godot-toolkit

An all-in-one extension for using Godot with pi.

It helps agents write better, more maintainable GDScript and automate common tasks without being prompted to.

The extension activates only inside a Godot project, where it discovers the skills and adds a short task → skill map to pi's instructions.

Features

  • Best practices - code and scenes follow Godot's best practices advice.
  • Task automation - skills for researching APIs, moving .gd files, and running tests.
  • Verification - GDScript is compiled by Godot itself, so autoloads resolve and the errors are real.
  • gdUnit4 - support for writing and running unit tests.

Requirements

  • Godot Engine 4.x (resolved via GODOT_BIN or PATH).

Optional

Installation

pi install npm:pi-godot-toolkit

Or add it to settings.json under packages:

{ "packages": ["npm:pi-godot-toolkit"] }

Verify

  • Type / to browse the skills, or load one with /skill:<name>.
  • Or just ask: "run the tests for test/settings", "what signals does Area2D emit?", "rename this script".

Skills

  • godot-best-practices - follow best practices when writing or reviewing code.
  • godot-doc-search - API research based on your project's Godot version.
  • gdscript-check - compile, format, and lint .gd files.
  • gdscript-file-manager - move/rename/delete .gd files with their .uid companions.
  • running-gdunit4-tests - run gdUnit4 tests.
  • writing-gdunit4-tests - write gdUnit4 test suites.