AI pyRevit Developer Template

AI-first pyRevit developer template with a CodexWorkspace plan-to-tasks workflow and a ready-to-load .extension bundle.

Start Here

Install pyRevit: Install pyRevit.
Beginner workflow (no hooks required): CodexWorkspace/human/beginner_quickstart.md.
Advanced workflow (opt-in hooks and stricter checks): CodexWorkspace/human/advanced_workflow.md.
Tier selector and full human docs index: CodexWorkspace/human/README.md.
Agent workflow + references (advanced): CodexWorkspace/skills/develop-pyrevit-extensions/references/agent_overview.md.
Planning artifacts (plans, development.md, tasks, reviews, backlog, advanced overlays): CodexWorkspace/workspace/README.md.
Update log: CHANGELOG.md.

pyRevit extension bundle (what you add in pyRevit Settings): ai-pyrevit-developer-template.extension/.
Hello World scaffold (inside the extension bundle): ai-pyrevit-developer-template.extension/HelloWorld.tab/.
Base skill package (workflow, prompts, templates, scripts): CodexWorkspace/skills/develop-pyrevit-extensions/.
Version-specific skills: CodexWorkspace/skills/pyrevit-revit-2023/, CodexWorkspace/skills/pyrevit-revit-2024/ (scaffold), CodexWorkspace/skills/pyrevit-revit-2025/ (scaffold).
Icon-selection helper skill: CodexWorkspace/skills/select-svg-icon/ for SVG-only icon acquisition (svgrepo automated first, svgfind manual fallback) and vision-based icon-to-script matching.

Current references are aligned with Revit 2023; use the matching CodexWorkspace/skills/pyrevit-revit-20xx/ skill and adjust as needed for other versions.
This repository is a template/meta workflow repository, not a project-specific add-on implementation repo.
Keep ai-pyrevit-developer-template.extension/ and the HelloWorld scaffold path in this template; put project-specific .tab content in your own extension repo.

Contribute only to static template files under CodexWorkspace/human/ and CodexWorkspace/skills/ (including versioned pyrevit-revit-20xx skills), plus the Hello World scaffold.
Call for contributions: add guidance for any Revit version by extending or adding pyrevit-revit-20xx skills.
Keep project-specific planning artifacts in CodexWorkspace/workspace/ out of template contributions.
Do not propose or include plans for a specific add-on.
Keep additional .tab folders out of the template and project code in your extension repo.
When updating static docs, also update CodexWorkspace/skills/develop-pyrevit-extensions/references/docs_overview.md and any relevant indexes.
Follow the repo conventions in AGENTS.md.
Record user-visible template changes in CHANGELOG.md.
Use GitHub Discussions for questions and ideas: Discussions.