Skip to content

feat: Add Python helper scripts#191

Open
KrystofS wants to merge 3 commits intomsitarzewski:mainfrom
KrystofS:main
Open

feat: Add Python helper scripts#191
KrystofS wants to merge 3 commits intomsitarzewski:mainfrom
KrystofS:main

Conversation

@KrystofS
Copy link

What does this PR do?

Converts the existing Bash integration scripts (scripts/*.sh) into cross-platform Python equivalents (scripts/*.py).

This provides support for Windows users, while preserving the original .sh files so existing UNIX workflows remain unbroken. The new Python scripts have zero third-party dependencies and support Python 3.7+ out of the box.

Key script additions:

  • scripts/utils.py: Shared utilities (color output, frontmatter parsing, Windows ANSI support).
  • scripts/convert.py: Converts agents to all 8 tool formats identically to the bash script.
  • scripts/install.py: Replicates the interactive interactive TUI selector and auto-detection.
  • scripts/lint-agents.py: Frontmatter validator (now used in .github/workflows/lint-agents.yml).

The README.md has also been updated to offer the python commands as explicit alternatives alongside the .sh guides.

Agent Information (if adding/modifying an agent)

  • Agent Name: N/A
  • Category: N/A
  • Specialty: N/A

Checklist

  • Follows the agent template structure from CONTRIBUTING.md
  • Includes YAML frontmatter with name, description, color
  • Has concrete code/template examples (for new agents)
  • Tested in real scenarios
  • Proofread and formatted correctly

@msitarzewski
Copy link
Owner

Hey @KrystofS — thanks for this, and for the thoughtful comments on #153.

We've got four PRs for Windows support now (#171, #172, #190, #191). I've left a comment on #153 asking everyone to converge on one approach. Your maintainability argument for Python is compelling — would love you to make the case there so the group can align.

@msitarzewski
Copy link
Owner

Heads up: we're consolidating the Windows support conversation into a single Discussion: #197 — please weigh in there so we can align on one approach.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants