@poolzin/plcode 2.1.1 → 3.0.1

package/.plcode/plugin/github-triage.txt

@@ -0,0 +1,88 @@
+Use this tool to assign and/or label a Github issue.
+
+You can assign the following users:
+- thdxr
+- adamdotdevin
+- fwang
+- jayair
+- kommander
+- rekram1-node
+
+
+You can use the following labels:
+- nix
+- opentui
+- perf
+- web
+- zen
+- docs
+
+Always try to assign an issue, if in doubt, assign rekram1-node to it.
+
+## Breakdown of responsibilities:
+
+### thdxr
+
+Dax is responsible for managing core parts of the application, for large feature requests, api changes, or things that require significant changes to the codebase assign him.
+
+This relates to OpenCode server primarily but has overlap with just about anything
+
+### adamdotdevin
+
+Adam is responsible for managing the Desktop/Web app. If there is an issue relating to the desktop app or `opencode web` command. Assign him.
+
+
+### fwang
+
+Frank is responsible for managing Zen, if you see complaints about OpenCode Zen, maybe it's the dashboard, the model quality, billing issues, etc. Assign him to the issue.
+
+### jayair
+
+Jay is responsible for documentation. If there is an issue relating to documentation assign him.
+
+### kommander
+
+Sebastian is responsible for managing an OpenTUI (a library for building terminal user interfaces). OpenCode's TUI is built with OpenTUI. If there are issues about:
+- random characters on screen
+- keybinds not working on different terminals
+- general terminal stuff
+Then assign the issue to Him.
+
+### rekram1-node
+
+ALL BUGS SHOULD BE assigned to rekram1-node unless they have the `opentui` label.
+
+Assign Aiden to an issue as a catch all, if you can't assign anyone else. Most of the time this will be bugs/polish things.
+If no one else makes sense to assign, assign rekram1-node to it.
+
+Always assign to aiden if the issue mentions "acp", "zed", or model performance issues
+
+## Breakdown of Labels:
+
+### nix
+
+Any issue that mentions nix, or nixos should have a nix label
+
+### opentui
+
+Anything relating to the TUI itself should have an opentui label
+
+### perf
+
+Anything related to slow performance, high ram, high cpu usage, or any other performance related issue should have a perf label
+
+### desktop
+
+Anything related to `opencode web` command or the desktop app should have a desktop label. Never add this label for anything terminal/tui related
+
+### zen
+
+Anything related to OpenCode Zen, billing, or model quality from Zen should have a zen label
+
+### docs
+
+Anything related to the documentation should have a docs label
+
+### windows
+
+Use for any issue that involves the windows OS

package/.plcode/plugin/notification.ts

@@ -0,0 +1,21 @@
+import type { Plugin } from "@plcode-ai/plugin"
+
+export const NotificationPlugin: Plugin = async ({ project, client, $, directory, worktree }) => {
+  const isKittyFocused = async (): Promise<boolean> => {
+    const result =
+      await $`osascript -e 'tell application "System Events" to get name of first application process whose frontmost is true'`.text()
+    return result.trim() === "kitty"
+  }
+
+  return {
+    event: async ({ event }) => {
+      if (event.type === "session.idle") {
+        const kittyFocused = await isKittyFocused()
+        if (!kittyFocused) {
+          // MacOS sounds can be found on /System/Library/Sounds
+          await $`osascript -e 'display notification "Hey! Waiting for you..." with title "plcode" sound name "Pop"'`
+        }
+      }
+    },
+  }
+}

package/.plcode/plugin/superpowers.js

@@ -0,0 +1,417 @@
+/**
+ * Superpowers Plugin for PLCODE
+ * VERSION: 3.0.0 (Professional Enterprise Edition)
+ *
+ * A complete software development workflow built on composable skills.
+ * Based on https://github.com/obra/superpowers
+ *
+ * Features:
+ * - Multi-path skill resolution (project > personal > global)
+ * - Automatic skill discovery and loading
+ * - Integration with PLCODE's native skill system
+ * - Tool mapping for cross-platform compatibility
+ *
+ * Skill Locations (in priority order):
+ * 1. .plcode/skills/           - Project-specific skills
+ * 2. .plcode/superpowers/skills/ - Project superpowers
+ * 3. ~/.config/plcode/skills/  - Personal skills
+ * 4. ~/.config/plcode/superpowers/skills/ - Global superpowers
+ */
+
+import path from "path"
+import fs from "fs"
+import os from "os"
+import { fileURLToPath } from "url"
+import { tool } from "@plcode-ai/plugin/tool"
+
+// ============================================================================
+// CONFIGURATION
+// ============================================================================
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+const homeDir = os.homedir()
+const CONFIG = {
+  // Local paths (relative to .plcode)
+  localSuperpowersDir: path.join(__dirname, "..", "superpowers"),
+  projectSkillsDir: path.join(__dirname, "..", "skills"),
+
+  // Global paths
+  globalSuperpowersDir: path.join(homeDir, ".config", "plcode", "superpowers"),
+  personalSkillsDir: path.join(homeDir, ".config", "plcode", "skills"),
+
+  // Skill file name
+  skillFileName: "SKILL.md",
+
+  // Max recursion depth for skill discovery
+  maxDepth: 3,
+}
+
+// ============================================================================
+// SKILLS CORE IMPLEMENTATION
+// ============================================================================
+
+/**
+ * Extract YAML frontmatter from a skill file
+ */
+function extractFrontmatter(filePath) {
+  try {
+    const content = fs.readFileSync(filePath, "utf8")
+    const lines = content.split("\n")
+
+    let inFrontmatter = false
+    const metadata = {}
+
+    for (const line of lines) {
+      if (line.trim() === "---") {
+        if (inFrontmatter) break
+        inFrontmatter = true
+        continue
+      }
+
+      if (inFrontmatter) {
+        const match = line.match(/^(\w+):\s*(.*)$/)
+        if (match) {
+          const [, key, value] = match
+          // Handle quoted strings
+          metadata[key] = value.replace(/^["']|["']$/g, "").trim()
+        }
+      }
+    }
+
+    return metadata
+  } catch {
+    return {}
+  }
+}
+
+/**
+ * Strip frontmatter from content, returning only the body
+ */
+function stripFrontmatter(content) {
+  const lines = content.split("\n")
+  let inFrontmatter = false
+  let endIndex = 0
+
+  for (let i = 0; i < lines.length; i++) {
+    if (lines[i].trim() === "---") {
+      if (!inFrontmatter) {
+        inFrontmatter = true
+      } else {
+        endIndex = i + 1
+        break
+      }
+    }
+  }
+
+  return lines.slice(endIndex).join("\n").trim()
+}
+
+/**
+ * Find all skills in a directory recursively
+ */
+function findSkillsInDir(dir, sourceType, maxDepth = CONFIG.maxDepth) {
+  const skills = []
+  if (!dir || !fs.existsSync(dir)) return skills
+
+  function recurse(currentDir, depth) {
+    if (depth > maxDepth) return
+
+    try {
+      const entries = fs.readdirSync(currentDir, { withFileTypes: true })
+
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue
+        if (entry.name.startsWith(".")) continue // Skip hidden directories
+
+        const fullPath = path.join(currentDir, entry.name)
+        const skillFile = path.join(fullPath, CONFIG.skillFileName)
+
+        if (fs.existsSync(skillFile)) {
+          const metadata = extractFrontmatter(skillFile)
+          skills.push({
+            id: entry.name,
+            path: fullPath,
+            skillFile,
+            name: metadata.name || entry.name,
+            description: metadata.description || "",
+            sourceType,
+          })
+        }
+
+        // Recurse into subdirectories
+        recurse(fullPath, depth + 1)
+      }
+    } catch {
+      // Silently ignore permission errors
+    }
+  }
+
+  recurse(dir, 0)
+  return skills
+}
+
+/**
+ * Resolve a skill by name, checking all locations in priority order
+ */
+function resolveSkill(skillName, directories) {
+  const cleanName = skillName.replace(/^(project:|superpowers:|personal:)/, "")
+
+  for (const { dir, sourceType } of directories) {
+    if (!dir || !fs.existsSync(dir)) continue
+
+    const skillFile = path.join(dir, cleanName, CONFIG.skillFileName)
+    if (fs.existsSync(skillFile)) {
+      return {
+        skillFile,
+        sourceType,
+        skillPath: cleanName,
+        metadata: extractFrontmatter(skillFile),
+      }
+    }
+  }
+
+  return null
+}
+
+// ============================================================================
+// PLUGIN EXPORT
+// ============================================================================
+
+export const SuperpowersPlugin = async ({ directory }) => {
+  // Build directory list for this project
+  const projectRoot = directory
+  const projectPlcodeDir = path.join(projectRoot, ".plcode")
+
+  const skillDirectories = [
+    { dir: path.join(projectPlcodeDir, "skill"), sourceType: "native" }, // PLCODE native skills
+    { dir: path.join(projectPlcodeDir, "skills"), sourceType: "project" },
+    { dir: CONFIG.personalSkillsDir, sourceType: "personal" },
+    {
+      dir: CONFIG.globalSuperpowersDir ? path.join(CONFIG.globalSuperpowersDir, "skills") : null,
+      sourceType: "global",
+    },
+  ]
+
+  // Collect all available skills
+  const getAllSkills = () => {
+    const allSkills = []
+    const seenNames = new Set()
+
+    for (const { dir, sourceType } of skillDirectories) {
+      const skills = findSkillsInDir(dir, sourceType)
+      for (const skill of skills) {
+        // Only add if not already seen (respects priority)
+        if (!seenNames.has(skill.id)) {
+          seenNames.add(skill.id)
+          allSkills.push(skill)
+        }
+      }
+    }
+
+    return allSkills
+  }
+
+  // ==========================================================================
+  // TOOLS
+  // ==========================================================================
+
+  return {
+    tool: {
+      // NOTE: The primary "skill" tool is provided natively by PLCODE (src/tool/skill.ts)
+      // This plugin provides additional superpowers-specific tools that complement the native skill tool
+
+      /**
+       * Alias for skill tool (for compatibility with superpowers ecosystem)
+       */
+      use_skill: tool({
+        description: "Alias for 'skill' tool. Load a Superpowers skill.",
+        args: {
+          skill_name: tool.schema.string().describe("Skill name to load"),
+        },
+        execute: async (args) => {
+          // Delegate to skill tool
+          const resolved = resolveSkill(args.skill_name, skillDirectories)
+          if (!resolved) {
+            return `Skill "${args.skill_name}" not found. Use find_skills to see available skills.`
+          }
+
+          const fullContent = fs.readFileSync(resolved.skillFile, "utf8")
+          const content = stripFrontmatter(fullContent)
+          const { name, description } = resolved.metadata
+
+          return `# SKILL LOADED: ${name || args.skill_name}
+
+**Source:** ${resolved.sourceType}
+${description ? `**Description:** ${description}` : ""}
+
+---
+
+${content}
+
+---
+
+Follow the instructions above exactly.`
+        },
+      }),
+
+      /**
+       * Find all available skills
+       */
+      find_skills: tool({
+        description: "List all available Superpowers skills from all locations.",
+        args: {
+          filter: tool.schema.string().optional().describe("Optional filter to search skill names"),
+        },
+        execute: async (args) => {
+          const allSkills = getAllSkills()
+          const filter = args.filter?.toLowerCase()
+
+          let filtered = allSkills
+          if (filter) {
+            filtered = allSkills.filter(
+              (s) =>
+                s.id.toLowerCase().includes(filter) ||
+                s.name.toLowerCase().includes(filter) ||
+                s.description.toLowerCase().includes(filter),
+            )
+          }
+
+          if (filtered.length === 0) {
+            return filter
+              ? `No skills found matching "${filter}".`
+              : "No skills found. Check if superpowers is installed."
+          }
+
+          // Group by source type
+          const grouped = {}
+          for (const skill of filtered) {
+            const key = skill.sourceType
+            if (!grouped[key]) grouped[key] = []
+            grouped[key].push(skill)
+          }
+
+          let output = `# SUPERPOWERS SKILLS
+
+You have ${filtered.length} skills available.${filter ? ` (filtered by "${filter}")` : ""}
+
+`
+
+          const sourceLabels = {
+            native: "Native Skills (.plcode/skill/)",
+            project: "Project Skills (.plcode/skills/)",
+            personal: "Personal Skills (~/.config/plcode/skills/)",
+            global: "Global Skills (~/.config/plcode/superpowers/skills/)",
+          }
+
+          for (const [sourceType, skills] of Object.entries(grouped)) {
+            output += `## ${sourceLabels[sourceType] || sourceType}\n\n`
+            for (const skill of skills) {
+              const prefix = sourceType === "project" ? "project:" : ""
+              output += `- **${prefix}${skill.id}** - ${skill.description || "No description"}\n`
+            }
+            output += "\n"
+          }
+
+          output += `---
+
+**Usage:** \`skill("brainstorming")\` or \`skill("superpowers:writing-plans")\`
+
+**Workflow Skills (use in order):**
+1. brainstorming - Before any creative work
+2. writing-plans - After design approval
+3. executing-plans - Execute with checkpoints
+4. test-driven-development - During implementation
+5. verification-before-completion - Before declaring done`
+
+          return output
+        },
+      }),
+
+      /**
+       * Get superpowers status and info
+       */
+      superpowers_info: tool({
+        description: "Get information about Superpowers capabilities and status.",
+        args: {},
+        execute: async () => {
+          const allSkills = getAllSkills()
+
+          // Count by source
+          const counts = {}
+          for (const skill of allSkills) {
+            counts[skill.sourceType] = (counts[skill.sourceType] || 0) + 1
+          }
+
+          let locationsInfo = ""
+          for (const [type, count] of Object.entries(counts)) {
+            locationsInfo += `- **${type}:** ${count} skills\n`
+          }
+
+          // Check for key workflow skills
+          const workflowSkills = [
+            "brainstorming",
+            "writing-plans",
+            "executing-plans",
+            "test-driven-development",
+            "systematic-debugging",
+            "verification-before-completion",
+          ]
+
+          const available = workflowSkills.filter((s) => allSkills.some((skill) => skill.id === s))
+          const missing = workflowSkills.filter((s) => !allSkills.some((skill) => skill.id === s))
+
+          return `# SUPERPOWERS ACTIVE
+
+You have ${allSkills.length} skills available!
+
+## Skill Locations
+${locationsInfo}
+
+## Core Workflow Skills
+${available.map((s) => `- [x] ${s}`).join("\n")}
+${missing.map((s) => `- [ ] ${s} (missing)`).join("\n")}
+
+## Quick Reference
+
+| Action | Skill |
+|--------|-------|
+| Starting new feature | brainstorming |
+| After design approval | writing-plans |
+| Execute implementation | executing-plans |
+| Writing code | test-driven-development |
+| Fixing bugs | systematic-debugging |
+| Before completion | verification-before-completion |
+
+## Tool Mapping (Claude Code to PLCODE)
+
+| Claude Code | PLCODE |
+|-------------|--------|
+| TodoWrite | todowrite |
+| Task | task (with subagent_type) |
+| Skill | skill |
+| Read/Write/Edit | read/write/edit |
+
+## Usage
+
+\`\`\`
+skill("brainstorming")     # Before creative work
+skill("writing-plans")     # Create implementation plan
+find_skills()              # List all available skills
+find_skills("debug")       # Search for debug-related skills
+\`\`\`
+
+REMEMBER: If there's even a 1% chance a skill applies, YOU MUST use it!`
+        },
+      }),
+    },
+
+    // ========================================================================
+    // EVENT HANDLERS (optional, for auto-activation)
+    // ========================================================================
+
+    // Note: Event handlers removed to avoid issues with thinking models
+    // Skills should be invoked explicitly using the skill tool
+  }
+}

package/.plcode/scripts/install-mcp-servers.ps1

@@ -0,0 +1,33 @@
+# Pre-install local MCP servers to avoid timeout issues
+# Run this once after cloning the repo
+
+Write-Host "Installing local MCP servers..." -ForegroundColor Cyan
+Write-Host ""
+
+$MCP_PACKAGES = @(
+  "chrome-devtools-mcp@latest"
+)
+
+$INSTALLED = 0
+$FAILED = 0
+
+foreach ($package in $MCP_PACKAGES) {
+  Write-Host "Installing: $package" -ForegroundColor Yellow
+  
+  try {
+    $null = npx -y $package --version 2>$null
+    if (-not $?) {
+      $null = npx -y $package --help 2>$null
+    }
+    Write-Host "  OK: $package" -ForegroundColor Green
+    $INSTALLED++
+  }
+  catch {
+    Write-Host "  FAIL: $package" -ForegroundColor Red
+    $FAILED++
+  }
+  Write-Host ""
+}
+
+Write-Host "Done: $INSTALLED installed, $FAILED failed" -ForegroundColor Cyan
+Write-Host "MCP servers cached and ready." -ForegroundColor Green

package/.plcode/scripts/install-mcp-servers.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+# Pre-install local MCP servers to avoid timeout issues
+# Run this once after cloning the repo
+
+set -e
+
+echo "Installing local MCP servers..."
+echo ""
+
+MCP_PACKAGES=(
+  "chrome-devtools-mcp@latest"
+)
+
+INSTALLED=0
+FAILED=0
+
+for package in "${MCP_PACKAGES[@]}"; do
+  echo "Installing: $package"
+  if npx -y "$package" --version &>/dev/null || npx -y "$package" --help &>/dev/null; then
+    echo "  OK: $package"
+    ((INSTALLED++))
+  else
+    echo "  FAIL: $package"
+    ((FAILED++))
+  fi
+  echo ""
+done
+
+echo "Done: $INSTALLED installed, $FAILED failed"
+echo "MCP servers cached and ready."