prjct-cli 0.37.1 → 0.40.0

package/CHANGELOG.md

@@ -1,5 +1,128 @@
 # Changelog
 
+## [0.40.0] - 2026-01-28
+
+### Feature: Enhanced Skill System
+
+Inspired by vercel-labs/skills, prjct-cli now supports remote skill installation, version tracking via lock file, and full ecosystem-standard SKILL.md subdirectory format across all skill directories.
+
+**New: Remote Skill Installation (`p. skill add`)**
+- Install skills from GitHub repos: `p. skill add owner/repo`
+- Install specific skill: `p. skill add owner/repo@skill-name`
+- Install from local directory: `p. skill add ./path`
+- Automatic source metadata injection (`_prjct` frontmatter block)
+
+**New: Skill Lock File**
+- Tracks installed skills at `~/.prjct-cli/skills/.skill-lock.json`
+- Records source URL, commit SHA, install timestamp
+- Enables update detection via `p. skill check`
+
+**New: Additional Subcommands**
+- `p. skill add <source>` — Install from GitHub or local path
+- `p. skill remove <name>` — Uninstall a skill
+- `p. skill init <name>` — Scaffold a new skill template
+- `p. skill check` — Detect available updates
+
+**Improved: Full SKILL.md Subdirectory Support**
+- All skill directories now support both `{name}.md` (flat) and `{name}/SKILL.md` (subdirectory) formats
+- Previously only provider dirs (`~/.claude/skills/`) checked subdirectories
+- Orchestrator executor now checks both patterns when loading agent skills
+
+**New Files:**
+- `core/services/skill-installer.ts` — Remote installation service
+- `core/services/skill-lock.ts` — Lock file management
+
+**Modified:**
+- `core/types/services.ts` — Extended `SkillMetadata` with `sourceUrl`, `sourceType`, `installedAt`, `sha`; added `'remote'` source type
+- `core/services/skill-service.ts` — Unified SKILL.md discovery in all dirs
+- `core/agentic/orchestrator-executor.ts` — Both path patterns for skill loading
+- `templates/commands/skill.md` — New subcommands documentation
+
+## [0.39.0] - 2026-01-24
+
+### Feature: Windsurf IDE Support (PRJ-66)
+
+prjct now works with **Windsurf IDE** as a project-level integration.
+
+**Architecture:**
+- Windsurf uses `.md` files (not `.mdc` like Cursor) with YAML frontmatter
+- Uses `trigger: always_on` instead of `alwaysApply: true`
+- Uses "workflows" directory instead of "commands"
+- Character limits: 6000 per file, 12000 total
+
+**New Files:**
+- `templates/windsurf/router.md` - Minimal router with YAML frontmatter
+- `templates/global/WINDSURF.md` - Full prjct instructions for Windsurf
+- `templates/windsurf/workflows/*.md` - Individual workflow files (sync, task, done, ship, bug, pause, resume)
+
+**Modified:**
+- `core/types/provider.ts` - Added `'windsurf'` to AIProviderName, added `WindsurfProjectDetection`
+- `core/infrastructure/ai-provider.ts` - Added WindsurfProvider, detectWindsurfProject(), branding
+- `core/infrastructure/setup.ts` - Added installWindsurfProject(), hasWindsurfProject()
+- `bin/prjct.ts` - Added Windsurf to --version display
+
+**Project Structure:**
+```
+.windsurf/
+├── rules/
+│   └── prjct.md          # Router (auto-generated)
+└── workflows/
+    ├── sync.md
+    ├── task.md
+    ├── done.md
+    ├── ship.md
+    ├── bug.md
+    ├── pause.md
+    └── resume.md
+```
+
+---
+
+## [0.38.1] - 2026-01-24
+
+### Docs: Complete Antigravity documentation
+
+- Added Antigravity badge to README
+- Added Antigravity Quick Start section
+- Updated "How It Works" table with Antigravity column
+- Updated Requirements to include Antigravity
+- Fixed version display to show all providers consistently
+
+---
+
+## [0.38.0] - 2026-01-24
+
+### Feature: Google Antigravity Support (PRJ-64)
+
+prjct now works with **Google Antigravity** as a skill (not MCP server).
+
+**Why Skills over MCP:**
+- Zero overhead (just SKILL.md files)
+- Cross-compatible with Claude Code skills
+- No daemon process needed
+- Aligned with prjct as "context layer"
+
+**New Files:**
+- `templates/global/ANTIGRAVITY.md` - Full prjct instructions
+- `templates/antigravity/SKILL.md` - Skill router for Antigravity
+
+**Modified:**
+- `core/infrastructure/ai-provider.ts` - Added AntigravityProvider, detectAntigravity()
+- `core/infrastructure/setup.ts` - Added installAntigravitySkill()
+- `core/index.ts` - Show Antigravity in --version
+
+**Skills Location:**
+```
+~/.gemini/antigravity/skills/prjct/SKILL.md
+```
+
+**Critical Rule Added:**
+All agent templates (CLAUDE.md, GEMINI.md, CURSOR.mdc, ANTIGRAVITY.md) now include:
+- Rule #0: Plan Before Action (NON-NEGOTIABLE)
+- Agent must create plan and get user approval before ANY execution
+
+---
+
 ## [0.37.1] - 2026-01-24
 
 ### Fix: Cursor Command Syntax (PRJ-65)

package/README.md

@@ -2,10 +2,11 @@
 
 **Context layer for AI coding agents.**
 
-Works with Claude Code, Gemini CLI, Cursor IDE, and more.
+Works with Claude Code, Gemini CLI, Antigravity, Cursor IDE, and more.
 
 [![Claude Code](https://img.shields.io/badge/Claude%20Code-Ready-6366f1)](CLAUDE.md)
 [![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-Ready-4285F4)]()
+[![Antigravity](https://img.shields.io/badge/Antigravity-Ready-EA4335)]()
 [![Cursor IDE](https://img.shields.io/badge/Cursor%20IDE-Ready-00D4AA)]()
 [![npm](https://img.shields.io/npm/v/prjct-cli)](https://www.npmjs.com/package/prjct-cli)
 
@@ -14,18 +15,19 @@ Works with Claude Code, Gemini CLI, Cursor IDE, and more.
 prjct gives AI coding agents the context they need about your project. It maintains state between sessions, tracks progress, and ensures agents understand your codebase.
 
 ```
-Your AI Agent (Claude/Gemini/Cursor)     prjct
-         │                                  │
-         │  "What am I working on?"         │
-         │ ───────────────────────────────► │
-         │                                  │ Reads project context
-         │  Task: "Add user auth"           │
-         │  Branch: feature/auth            │
-         │  Subtask 2/5: API routes         │
-         │ ◄─────────────────────────────── │
-         │                                  │
-         ▼                                  │
-    Writes code with full context           │
+Your AI Agent                              prjct
+(Claude/Gemini/Antigravity/Cursor)           │
+         │                                   │
+         │  "What am I working on?"          │
+         │ ────────────────────────────────► │
+         │                                   │ Reads project context
+         │  Task: "Add user auth"            │
+         │  Branch: feature/auth             │
+         │  Subtask 2/5: API routes          │
+         │ ◄──────────────────────────────── │
+         │                                   │
+         ▼                                   │
+    Writes code with full context            │
 ```
 
 ## Install
@@ -53,6 +55,25 @@ p. done                    # Complete subtask
 p. ship                    # Ship with PR
 ```
 
+### Google Antigravity
+
+```bash
+# 1. One-time global setup (installs prjct as a skill)
+prjct start
+
+# 2. Initialize your project
+cd my-project
+prjct init
+
+# 3. Open in Antigravity and use:
+p. sync                    # Analyze project
+p. task "add user auth"    # Start a task
+p. done                    # Complete subtask
+p. ship                    # Ship with PR
+```
+
+> **Note:** prjct integrates as a Skill (not MCP server) for zero-overhead operation.
+
 ### Cursor IDE
 
 ```bash
@@ -72,19 +93,19 @@ prjct init
 ### Core Workflow
 
 ```
-Claude/Gemini:  p. sync  →  p. task "..."  →  [code]  →  p. done  →  p. ship
-Cursor:         /sync    →  /task "..."    →  [code]  →  /done    →  /ship
+Claude/Gemini/Antigravity:  p. sync  →  p. task "..."  →  [code]  →  p. done  →  p. ship
+Cursor:                     /sync    →  /task "..."    →  [code]  →  /done    →  /ship
 ```
 
 ## How It Works
 
-| Component | Claude Code | Gemini CLI | Cursor IDE |
-|-----------|-------------|------------|------------|
-| Router | `~/.claude/commands/p.md` | `~/.gemini/commands/p.toml` | `.cursor/commands/*.md` |
-| Config | `~/.claude/CLAUDE.md` | `~/.gemini/GEMINI.md` | `.cursor/rules/prjct.mdc` |
-| Storage | `~/.prjct-cli/projects/` | `~/.prjct-cli/projects/` | `~/.prjct-cli/projects/` |
-| Scope | Global | Global | Per-project |
-| Syntax | `p. command` | `p. command` | `/command` |
+| Component | Claude Code | Gemini CLI | Antigravity | Cursor IDE |
+|-----------|-------------|------------|-------------|------------|
+| Router | `~/.claude/commands/p.md` | `~/.gemini/commands/p.toml` | Skill | `.cursor/commands/*.md` |
+| Config | `~/.claude/CLAUDE.md` | `~/.gemini/GEMINI.md` | `~/.gemini/antigravity/skills/prjct/` | `.cursor/rules/prjct.mdc` |
+| Storage | `~/.prjct-cli/projects/` | `~/.prjct-cli/projects/` | `~/.prjct-cli/projects/` | `~/.prjct-cli/projects/` |
+| Scope | Global | Global | Global | Per-project |
+| Syntax | `p. command` | `p. command` | `p. command` | `/command` |
 
 All agents share the same project storage, so you can switch between them freely.
 
@@ -114,7 +135,7 @@ prjct --help         # Show help
 ## Requirements
 
 - Node.js 18+ or Bun 1.0+
-- One of: Claude Code, Gemini CLI, or Cursor IDE
+- One of: Claude Code, Gemini CLI, Antigravity, or Cursor IDE
 
 ## Links
 

package/bin/prjct.ts

@@ -94,6 +94,8 @@ if (args[0] === 'start' || args[0] === 'setup') {
   const geminiConfigured = fs.existsSync(path.join(home, '.gemini', 'commands', 'p.toml'))
   const cursorDetected = fs.existsSync(path.join(cwd, '.cursor'))
   const cursorConfigured = fs.existsSync(path.join(cwd, '.cursor', 'rules', 'prjct.mdc'))
+  const windsurfDetected = fs.existsSync(path.join(cwd, '.windsurf'))
+  const windsurfConfigured = fs.existsSync(path.join(cwd, '.windsurf', 'rules', 'prjct.md'))
 
   const GREEN = '\x1b[32m'
 
@@ -129,9 +131,17 @@ ${DIM}Providers:${RESET}`)
     console.log(`  Cursor IDE    ${DIM}○ not detected${RESET}`)
   }
 
+  // Windsurf status (project-level)
+  if (windsurfDetected) {
+    const status = windsurfConfigured ? `${GREEN}✓ ready${RESET}` : `${YELLOW}● detected${RESET}`
+    console.log(`  Windsurf IDE  ${status}${DIM} (project)${RESET}`)
+  } else {
+    console.log(`  Windsurf IDE  ${DIM}○ not detected${RESET}`)
+  }
+
   console.log(`
 ${DIM}Run 'prjct start' to configure (CLI providers)${RESET}
-${DIM}Run 'prjct init' to configure (Cursor IDE)${RESET}
+${DIM}Run 'prjct init' to configure (Cursor/Windsurf IDE)${RESET}
 ${CYAN}https://prjct.app${RESET}
 `)
 } else {

package/core/agentic/orchestrator-executor.ts

@@ -344,18 +344,35 @@ export class OrchestratorExecutor {
         // Skip if already loaded
         if (loadedSkillNames.has(skillName)) continue
 
-        const skillPath = path.join(skillsDir, `${skillName}.md`)
+        // Check both patterns: flat file and subdirectory (ecosystem standard)
+        const flatPath = path.join(skillsDir, `${skillName}.md`)
+        const subdirPath = path.join(skillsDir, skillName, 'SKILL.md')
+
+        let content: string | null = null
+        let resolvedPath = flatPath
+
+        // Prefer subdirectory format (ecosystem standard)
         try {
-          const content = await fs.readFile(skillPath, 'utf-8')
+          content = await fs.readFile(subdirPath, 'utf-8')
+          resolvedPath = subdirPath
+        } catch {
+          // Fall back to flat file
+          try {
+            content = await fs.readFile(flatPath, 'utf-8')
+            resolvedPath = flatPath
+          } catch {
+            // Skill not found - not an error, just skip
+            console.warn(`Skill not found: ${skillName}`)
+          }
+        }
+
+        if (content) {
           skills.push({
             name: skillName,
             content,
-            filePath: skillPath,
+            filePath: resolvedPath,
           })
           loadedSkillNames.add(skillName)
-        } catch {
-          // Skill not found - not an error, just skip
-          console.warn(`Skill not found: ${skillName}`)
         }
       }
     }

package/core/index.ts

@@ -9,7 +9,7 @@ import { commandRegistry } from './commands/registry'
 import './commands/register' // Ensure commands are registered
 import out from './utils/output'
 import type { CommandMeta } from './commands/registry'
-import { detectAllProviders, Providers } from './infrastructure/ai-provider'
+import { detectAllProviders, detectAntigravity, Providers } from './infrastructure/ai-provider'
 import fs from 'fs'
 import path from 'path'
 import os from 'os'
@@ -206,7 +206,7 @@ function displayVersion(version: string): void {
 ${CYAN}p/${RESET} prjct v${version}
 ${DIM}Context layer for AI coding agents${RESET}
 
-${DIM}Global Providers:${RESET}`)
+${DIM}Providers:${RESET}`)
 
   // Claude status
   if (detection.claude.installed) {
@@ -226,9 +226,17 @@ ${DIM}Global Providers:${RESET}`)
     console.log(`  Gemini CLI    ${DIM}○ not installed${RESET}`)
   }
 
-  // Cursor status (per-project)
-  console.log(`
-${DIM}Project Providers:${RESET}`)
+  // Antigravity status (global, skills-based)
+  const antigravityDetection = detectAntigravity()
+  if (antigravityDetection.installed) {
+    const status = antigravityDetection.skillInstalled ? `${GREEN}✓ ready${RESET}` : `${YELLOW}● detected${RESET}`
+    const hint = antigravityDetection.skillInstalled ? '' : ` ${DIM}(run prjct start)${RESET}`
+    console.log(`  Antigravity   ${status}${hint}`)
+  } else {
+    console.log(`  Antigravity   ${DIM}○ not installed${RESET}`)
+  }
+
+  // Cursor status (project-level, but shown in same format)
   if (cursorConfigured) {
     console.log(`  Cursor IDE    ${GREEN}✓ ready${RESET} ${DIM}(use /sync, /task)${RESET}`)
   } else if (cursorExists) {
@@ -249,7 +257,7 @@ ${CYAN}https://prjct.app${RESET}
 function displayHelp(): void {
   console.log(`
 prjct - Context layer for AI coding agents
-Works with Claude Code, Gemini CLI, Cursor IDE, and more.
+Works with Claude Code, Gemini CLI, Antigravity, Cursor IDE, and more.
 
 QUICK START
 -----------

package/core/infrastructure/ai-provider.ts

@@ -5,14 +5,16 @@
  * - Claude Code (CLI): ~/.claude/, CLAUDE.md, .md commands
  * - Gemini CLI (CLI): ~/.gemini/, GEMINI.md, .toml commands
  * - Cursor IDE (GUI): .cursor/ (project-level), .mdc rules
+ * - Windsurf IDE (GUI): .windsurf/ (project-level), .md rules with YAML frontmatter
  *
  * Key differences:
  * - CLI providers (Claude/Gemini) have global config directories
- * - Cursor has project-level config only (no ~/.cursor/)
+ * - Cursor/Windsurf have project-level config only (no ~/.cursor/ or ~/.windsurf/)
  *
  * @see https://geminicli.com/docs/cli/gemini-md/
  * @see https://geminicli.com/docs/cli/skills/
  * @see https://cursor.com/docs/context/rules
+ * @see https://docs.windsurf.com/windsurf/cascade/memories
  */
 
 import { execSync } from 'child_process'
@@ -26,6 +28,7 @@ import type {
   ProviderSelectionResult,
   ProviderBranding,
   CursorProjectDetection,
+  WindsurfProjectDetection,
 } from '../types/provider'
 
 // =============================================================================
@@ -70,6 +73,29 @@ export const GeminiProvider: AIProviderConfig = {
   docsUrl: 'https://geminicli.com/docs',
 }
 
+/**
+ * Google Antigravity provider configuration
+ *
+ * An "agent-first" platform that manages multiple agents.
+ * Config is located in ~/.gemini/antigravity/
+ * Uses SKILL.md for skills and mcp_config.json for tools.
+ */
+export const AntigravityProvider: AIProviderConfig = {
+  name: 'antigravity',
+  displayName: 'Google Antigravity',
+  cliCommand: null, // Not a CLI command, but a platform/app
+  configDir: path.join(os.homedir(), '.gemini', 'antigravity'),
+  contextFile: 'ANTIGRAVITY.md',
+  skillsDir: path.join(os.homedir(), '.gemini', 'antigravity', 'global_skills'),
+  commandsDir: '.agent/skills', // Antigravity uses .agent/skills in projects
+  commandFormat: 'md', // Uses SKILL.md
+  settingsFile: 'mcp_config.json', // Uses MCP config
+  projectSettingsFile: null,
+  ignoreFile: '.agentignore', // Assumed
+  websiteUrl: 'https://gemini.google.com/app/antigravity',
+  docsUrl: 'https://gemini.google.com/app/antigravity',
+}
+
 /**
  * Cursor IDE provider configuration
  *
@@ -99,6 +125,36 @@ export const CursorProvider: AIProviderConfig = {
   docsUrl: 'https://cursor.com/docs',
 }
 
+/**
+ * Windsurf IDE provider configuration
+ *
+ * Key differences from Cursor:
+ * - Uses .md files (not .mdc) with YAML frontmatter
+ * - Uses "workflows" instead of "commands"
+ * - Frontmatter uses `trigger: always_on` instead of `alwaysApply: true`
+ * - Character limits: 6000 per file, 12000 total
+ *
+ * @see https://docs.windsurf.com/windsurf/cascade/memories
+ * @see https://docs.windsurf.com/windsurf/cascade/workflows
+ */
+export const WindsurfProvider: AIProviderConfig = {
+  name: 'windsurf',
+  displayName: 'Windsurf IDE',
+  cliCommand: null,                    // Not a CLI - GUI app
+  configDir: null,                     // No global config directory
+  contextFile: 'prjct.md',             // Uses .md format (not .mdc)
+  skillsDir: null,                     // No skills directory
+  commandsDir: '.windsurf/workflows',  // Windsurf uses "workflows" not "commands"
+  rulesDir: '.windsurf/rules',
+  commandFormat: 'md',
+  settingsFile: null,
+  projectSettingsFile: null,
+  ignoreFile: '.windsurfignore',
+  isProjectLevel: true,                // Config is project-level only
+  websiteUrl: 'https://windsurf.com',
+  docsUrl: 'https://docs.windsurf.com',
+}
+
 /**
  * All available providers
  */
@@ -106,6 +162,8 @@ export const Providers: Record<AIProviderName, AIProviderConfig> = {
   claude: ClaudeProvider,
   gemini: GeminiProvider,
   cursor: CursorProvider,
+  antigravity: AntigravityProvider,
+  windsurf: WindsurfProvider,
 }
 
 // =============================================================================
@@ -243,6 +301,22 @@ Built with [Cursor](${config.websiteUrl})`,
     }
   }
 
+  if (provider === 'antigravity') {
+    return {
+      commitFooter: `🤖 Generated with [p/](https://www.prjct.app/)
+Powered by [Antigravity](${config.websiteUrl})`,
+      signature: '⚡ prjct + Antigravity',
+    }
+  }
+
+  if (provider === 'windsurf') {
+    return {
+      commitFooter: `🤖 Generated with [p/](https://www.prjct.app/)
+Built with [Windsurf](${config.websiteUrl})`,
+      signature: '⚡ prjct + Windsurf',
+    }
+  }
+
   // Default: Claude
   return {
     commitFooter: `🤖 Generated with [p/](https://www.prjct.app/)
@@ -287,6 +361,83 @@ export function needsCursorRouterRegeneration(projectRoot: string): boolean {
   return detection.detected && !detection.routerInstalled
 }
 
+// =============================================================================
+// Windsurf Project Detection
+// =============================================================================
+
+/**
+ * Detect if a project is configured for Windsurf IDE
+ *
+ * Windsurf has NO global config (~/.windsurf/ doesn't exist).
+ * Detection is based on project-level .windsurf/ directory.
+ */
+export function detectWindsurfProject(projectRoot: string): WindsurfProjectDetection {
+  const windsurfDir = path.join(projectRoot, '.windsurf')
+  const rulesDir = path.join(windsurfDir, 'rules')
+  const routerPath = path.join(rulesDir, 'prjct.md')
+
+  const detected = fs.existsSync(windsurfDir)
+  const routerInstalled = fs.existsSync(routerPath)
+
+  return {
+    detected,
+    routerInstalled,
+    projectRoot: detected ? projectRoot : undefined,
+  }
+}
+
+/**
+ * Check if Windsurf routers need to be regenerated
+ */
+export function needsWindsurfRouterRegeneration(projectRoot: string): boolean {
+  const detection = detectWindsurfProject(projectRoot)
+
+  // Only check if .windsurf/ exists (project uses Windsurf)
+  // and prjct router is missing
+  return detection.detected && !detection.routerInstalled
+}
+
+// =============================================================================
+// Antigravity Detection
+// =============================================================================
+
+/**
+ * Result of Antigravity detection
+ */
+export interface AntigravityDetection {
+  /** Whether ~/.gemini/antigravity/ exists */
+  installed: boolean
+
+  /** Whether prjct skill is installed */
+  skillInstalled: boolean
+
+  /** Path to config directory */
+  configPath?: string
+}
+
+/**
+ * Detect if Google Antigravity is installed
+ *
+ * Antigravity is NOT a CLI command - it's a GUI platform.
+ * Detection is based on ~/.gemini/antigravity/ directory.
+ */
+export function detectAntigravity(): AntigravityDetection {
+  const configPath = AntigravityProvider.configDir
+  if (!configPath) {
+    return { installed: false, skillInstalled: false }
+  }
+
+  const installed = fs.existsSync(configPath)
+  const skillPath = path.join(configPath, 'skills', 'prjct', 'SKILL.md')
+  const skillInstalled = fs.existsSync(skillPath)
+
+  return {
+    installed,
+    skillInstalled,
+    configPath: installed ? configPath : undefined,
+  }
+}
+
 // =============================================================================
 // Provider Paths
 // =============================================================================
@@ -398,8 +549,11 @@ export default {
   ClaudeProvider,
   GeminiProvider,
   CursorProvider,
+  AntigravityProvider,
+  WindsurfProvider,
   detectProvider,
   detectAllProviders,
+  detectAntigravity,
   getActiveProvider,
   hasProviderConfig,
   getProviderBranding,
@@ -411,4 +565,6 @@ export default {
   selectProvider,
   detectCursorProject,
   needsCursorRouterRegeneration,
+  detectWindsurfProject,
+  needsWindsurfRouterRegeneration,
 }