prjct-cli 0.36.1 → 0.37.1

package/CHANGELOG.md

@@ -1,5 +1,69 @@
 # Changelog
 
+## [0.37.1] - 2026-01-24
+
+### Fix: Cursor Command Syntax (PRJ-65)
+
+Fixed Cursor IDE commands not working. Cursor uses `/command` syntax, not `p. command`.
+
+**Changes:**
+- Created individual command files: `/sync`, `/task`, `/done`, `/ship`, `/bug`, `/pause`, `/resume`
+- Updated `CURSOR.mdc` with correct `/command` syntax documentation
+- Updated `router.mdc` with new syntax examples
+- Updated `README.md` with Cursor-specific syntax section
+- Fixed `installCursorProject()` to install all individual command files
+
+**Cursor Syntax:**
+```
+/sync                  # Analyze project
+/task "description"    # Start task
+/done                  # Complete subtask
+/ship                  # Ship feature
+```
+
+---
+
+## [0.37.0] - 2026-01-24
+
+### Feature: Cursor IDE Support (PRJ-63)
+
+prjct now works with **Cursor IDE** in addition to Claude Code and Gemini CLI. Use any AI model Cursor supports (GPT-4, Claude, Gemini, DeepSeek, etc.).
+
+**Key Insight:** Cursor has NO global config directory. Unlike Claude/Gemini which use `~/.claude/` and `~/.gemini/`, Cursor uses project-level config in `.cursor/`.
+
+**Solution: Minimal Router Pattern**
+- Router files are minimal (~15 lines), point to npm package for real instructions
+- If deleted, `p. sync` regenerates them automatically
+- Added to `.gitignore` - each developer regenerates their own
+
+**New Files:**
+- `templates/global/CURSOR.mdc` - Full prjct instructions for Cursor
+- `templates/cursor/router.mdc` - Minimal router (installed in projects)
+- `templates/cursor/p.md` - Command router for `p. <command>`
+
+**Modified:**
+- `core/types/provider.ts` - Added 'cursor' to AIProviderName
+- `core/infrastructure/ai-provider.ts` - Added CursorProvider, detectCursorProject()
+- `core/infrastructure/setup.ts` - Added installCursorProject(), hasCursorProject()
+- `templates/commands/init.md` - Cursor detection and setup
+- `templates/commands/sync.md` - Cursor router regeneration
+- `bin/prjct.ts` - Cursor status in --version output
+- `README.md` - Added Cursor to supported platforms
+
+**Architecture:**
+```
+Claude/Gemini (CLI)          Cursor (GUI)
+~/.claude/CLAUDE.md         .cursor/rules/prjct.mdc (router)
+~/.gemini/GEMINI.md                ↓
+        ↓                   npm/prjct-cli/templates/global/CURSOR.mdc
+Global config                      ↓
+        └──────────────────────────┘
+                    ↓
+        ~/.prjct-cli/projects/{id}/  (shared storage)
+```
+
+---
+
 ## [0.36.1] - 2026-01-23
 
 ### Docs: Minimal README

package/README.md

@@ -2,10 +2,11 @@
 
 **Context layer for AI coding agents.**
 
-Works with Claude Code, Gemini CLI, and more.
+Works with Claude Code, Gemini CLI, 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)]()
+[![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)
 
 ## What is prjct?
@@ -13,81 +14,107 @@ Works with Claude Code, Gemini CLI, 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)     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 (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           │
 ```
 
 ## Install
 
 ```bash
 npm install -g prjct-cli
-prjct start
 ```
 
-## Usage
+## Quick Start
 
-Inside Claude Code or Gemini CLI, use the `p.` prefix:
+### Claude Code / Gemini CLI
 
-```
-p. sync                    # Analyze project, generate agents
+```bash
+# 1. One-time global setup
+prjct start
+
+# 2. Initialize your project
+cd my-project
+prjct init
+
+# 3. Open in Claude Code or Gemini CLI and use:
+p. sync                    # Analyze project
 p. task "add user auth"    # Start a task
-p. done                    # Complete current subtask
-p. ship "user auth"        # Ship with PR + version bump
+p. done                    # Complete subtask
+p. ship                    # Ship with PR
 ```
 
+### Cursor IDE
+
+```bash
+# 1. Initialize your project (no global setup needed)
+cd my-project
+prjct init
+
+# 2. Open in Cursor and use:
+/sync                      # Analyze project
+/task "add user auth"      # Start a task
+/done                      # Complete subtask
+/ship                      # Ship with PR
+```
+
+> **Note:** Cursor uses `/command` syntax. Commands are installed per-project in `.cursor/commands/`. If deleted, run `/sync` to regenerate.
+
 ### Core Workflow
 
 ```
-p. sync  →  p. task "..."  →  [code]  →  p. done  →  p. ship
+Claude/Gemini:  p. sync  →  p. task "..."  →  [code]  →  p. done  →  p. ship
+Cursor:         /sync    →  /task "..."    →  [code]  →  /done    →  /ship
 ```
 
 ## How It Works
 
-| Component | Claude Code | Gemini CLI |
-|-----------|-------------|------------|
-| Router | `~/.claude/commands/p.md` | `~/.gemini/commands/p.toml` |
-| Config | `~/.claude/CLAUDE.md` | `~/.gemini/GEMINI.md` |
-| Storage | `~/.prjct-cli/projects/` | `~/.prjct-cli/projects/` |
+| 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` |
 
-Both agents share the same project storage, so you can switch between them freely.
+All agents share the same project storage, so you can switch between them freely.
 
 ## Commands
 
-| Command | Description |
-|---------|-------------|
-| `p. sync` | Analyze project, generate domain agents |
-| `p. task "desc"` | Start task with auto-classification |
-| `p. done` | Complete current subtask |
-| `p. ship "name"` | Ship feature with PR + version bump |
-| `p. pause` | Pause current task |
-| `p. resume` | Resume paused task |
-| `p. linear` | Linear integration |
-| `p. github` | GitHub Issues integration |
+| Claude/Gemini | Cursor | Description |
+|---------------|--------|-------------|
+| `p. sync` | `/sync` | Analyze project, generate domain agents |
+| `p. task "desc"` | `/task "desc"` | Start task with auto-classification |
+| `p. done` | `/done` | Complete current subtask |
+| `p. ship "name"` | `/ship "name"` | Ship feature with PR + version bump |
+| `p. pause` | `/pause` | Pause current task |
+| `p. resume` | `/resume` | Resume paused task |
+| `p. bug "desc"` | `/bug "desc"` | Report a bug |
+| `p. linear` | - | Linear integration |
+| `p. github` | - | GitHub Issues integration |
 
 ## CLI Commands
 
 ```bash
-prjct start          # First-time setup
+prjct start          # First-time setup (Claude/Gemini)
+prjct init           # Initialize project (+ Cursor setup)
 prjct --version      # Show version + provider status
 prjct --help         # Show help
-prjct init           # Initialize project
-prjct sync           # Sync project state
 ```
 
 ## Requirements
 
 - Node.js 18+ or Bun 1.0+
-- Claude Code and/or Gemini CLI
+- One of: Claude Code, Gemini CLI, or Cursor IDE
 
 ## Links
 

package/bin/prjct.ts

@@ -89,8 +89,11 @@ if (args[0] === 'start' || args[0] === 'setup') {
   // Show version with provider status
   const detection = detectAllProviders()
   const home = os.homedir()
+  const cwd = process.cwd()
   const claudeConfigured = fs.existsSync(path.join(home, '.claude', 'commands', 'p.md'))
   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 GREEN = '\x1b[32m'
 
@@ -118,8 +121,17 @@ ${DIM}Providers:${RESET}`)
     console.log(`  Gemini CLI    ${DIM}○ not installed${RESET}`)
   }
 
+  // Cursor status (project-level)
+  if (cursorDetected) {
+    const status = cursorConfigured ? `${GREEN}✓ ready${RESET}` : `${YELLOW}● detected${RESET}`
+    console.log(`  Cursor IDE    ${status}${DIM} (project)${RESET}`)
+  } else {
+    console.log(`  Cursor IDE    ${DIM}○ not detected${RESET}`)
+  }
+
   console.log(`
-${DIM}Run 'prjct start' to configure${RESET}
+${DIM}Run 'prjct start' to configure (CLI providers)${RESET}
+${DIM}Run 'prjct init' to configure (Cursor IDE)${RESET}
 ${CYAN}https://prjct.app${RESET}
 `)
 } else {

package/core/agentic/template-executor.ts

@@ -27,7 +27,11 @@ export interface TemplateExecutionContext {
   command: string
   args: string
 
-  // Paths for Claude (not content - Claude reads what it needs)
+  // Agent information
+  agentName: string
+  agentSettingsPath: string
+
+  // Paths for agent (not content)
   paths: {
     orchestrator: string
     agentRouting: string
@@ -85,6 +89,8 @@ export class TemplateExecutor {
   ): Promise<TemplateExecutionContext> {
     const projectId = await this.getProjectId(projectPath)
     const globalPath = pathManager.getGlobalProjectPath(projectId)
+    const aiProvider = require('../infrastructure/ai-provider')
+    const activeProvider = aiProvider.getActiveProvider()
 
     // Get templates directory - use local path during development
     let templatesDir: string
@@ -102,6 +108,8 @@ export class TemplateExecutor {
       globalPath,
       command,
       args,
+      agentName: activeProvider.displayName,
+      agentSettingsPath: pathManager.getAgentSettingsPath(),
       paths: {
         orchestrator: path.join(templatesDir, 'agentic', 'orchestrator.md'),
         agentRouting: path.join(templatesDir, 'agentic', 'agent-routing.md'),
@@ -109,7 +117,7 @@ export class TemplateExecutor {
         commandTemplate: path.join(templatesDir, 'commands', `${command}.md`),
         repoAnalysis: path.join(globalPath, 'analysis', 'repo-analysis.json'),
         agentsDir: path.join(globalPath, 'agents'),
-        skillsDir: path.join(os.homedir(), '.claude', 'skills'),
+        skillsDir: activeProvider.skillsDir,
         stateJson: path.join(globalPath, 'storage', 'state.json'),
       }
     }
@@ -157,7 +165,7 @@ export class TemplateExecutor {
   }
 
   /**
-   * Build prompt that tells Claude to execute templates agentically
+   * Build prompt that tells agent to execute templates agentically
    */
   buildAgenticPrompt(context: TemplateExecutionContext): AgenticPromptInfo {
     const requiresOrchestration = this.requiresOrchestration(context.command)
@@ -165,9 +173,11 @@ export class TemplateExecutor {
     const prompt = `
 ## Agentic Execution Mode
 
-You are executing a prjct command. Follow the template-first approach.
+You are executing a prjct command as ${context.agentName}. Follow the template-first approach.
 
 ### Context
+- Agent: ${context.agentName}
+- Settings: ${context.agentSettingsPath}
 - Command: ${context.command}
 - Args: ${context.args}
 - Project: ${context.projectPath}

package/core/cli/start.ts

@@ -198,12 +198,17 @@ async function selectProviders(): Promise<AIProviderName[]> {
 }
 
 /**
- * Install router for a provider
+ * Install router for a CLI-based provider (Claude/Gemini)
+ * Note: Cursor uses project-level config, not global
  */
 async function installRouter(provider: AIProviderName): Promise<boolean> {
-  const home = os.homedir()
   const config = Providers[provider]
 
+  // Skip project-level providers (Cursor)
+  if (!config.configDir) {
+    return false
+  }
+
   try {
     // Create commands directory
     const commandsDir = path.join(config.configDir, 'commands')
@@ -231,12 +236,17 @@ async function installRouter(provider: AIProviderName): Promise<boolean> {
 }
 
 /**
- * Install global config for a provider
+ * Install global config for a CLI-based provider (Claude/Gemini)
+ * Note: Cursor uses project-level config, not global
  */
 async function installGlobalConfig(provider: AIProviderName): Promise<boolean> {
-  const home = os.homedir()
   const config = Providers[provider]
 
+  // Skip project-level providers (Cursor)
+  if (!config.configDir) {
+    return false
+  }
+
   try {
     // Ensure config directory exists
     fs.mkdirSync(config.configDir, { recursive: true })

package/core/commands/analysis.ts

@@ -74,14 +74,17 @@ export class AnalysisCommands extends PrjctCommandsBase {
 
       await generateContext(projectId!, projectPath)
 
+      const aiProvider = require('../infrastructure/ai-provider')
+      const activeProvider = aiProvider.getActiveProvider()
+
       const globalConfigResult = await commandInstaller.installGlobalConfig()
       if (globalConfigResult.success) {
-        console.log('📝 Updated ~/.claude/CLAUDE.md')
+        console.log(`📝 Updated ${pathManager.getDisplayPath(globalConfigResult.path!)}`)
       }
 
       console.log('✅ Analysis complete!\n')
       console.log('📄 Full report: analysis/repo-summary.md')
-      console.log('📝 Context: ~/.prjct-cli/projects/' + projectId + '/CLAUDE.md\n')
+      console.log(`📝 Context: ~/.prjct-cli/projects/${projectId}/${activeProvider.contextFile}\n`)
       console.log('Next steps:')
       console.log('• /p:sync → Generate agents based on stack')
       console.log('• /p:feature → Add a new feature')
@@ -220,7 +223,7 @@ export class AnalysisCommands extends PrjctCommandsBase {
       // Update global config
       const globalConfigResult = await commandInstaller.installGlobalConfig()
       if (globalConfigResult.success) {
-        console.log('📝 Updated ~/.claude/CLAUDE.md')
+        console.log(`📝 Updated ${pathManager.getDisplayPath(globalConfigResult.path!)}`)
       }
 
       // Format output

package/core/commands/setup.ts

@@ -17,17 +17,19 @@ export class SetupCommands extends PrjctCommandsBase {
    * First-time setup - Install commands to editors
    */
   async start(): Promise<CommandResult> {
-    console.log('🚀 Setting up prjct for Claude...\n')
+    const aiProvider = require('../infrastructure/ai-provider')
+    const activeProvider = aiProvider.getActiveProvider()
+    
+    console.log(`🚀 Setting up prjct for ${activeProvider.displayName}...\n`)
 
     const status = await commandInstaller.checkInstallation()
 
-    if (!status.claudeDetected) {
+    if (!status.claudeDetected) { // Note: variable name is legacy, checks active provider
       return {
         success: false,
         message:
-          '❌ Claude not detected.\n\nPlease install Claude Code or Claude Desktop first:\n' +
-          '  - Claude Code: https://claude.com/code\n' +
-          '  - Claude Desktop: https://claude.com/desktop',
+          `❌ ${activeProvider.displayName} not detected.\n\nPlease install it first:\n` +
+          `  - ${activeProvider.displayName}: ${activeProvider.docsUrl}`,
       }
     }
 
@@ -41,7 +43,7 @@ export class SetupCommands extends PrjctCommandsBase {
       }
     }
 
-    console.log(`\n✅ Installed ${result.installed?.length ?? 0} commands to:\n   ${result.path}`)
+    console.log(`\n✅ Installed ${result.installed?.length ?? 0} commands to:\n   ${pathManager.getDisplayPath(result.path || '')}`)
 
     if ((result.errors?.length ?? 0) > 0) {
       console.log(`\n⚠️  ${result.errors?.length ?? 0} errors:`)
@@ -50,9 +52,9 @@ export class SetupCommands extends PrjctCommandsBase {
 
     console.log('\n🎉 Setup complete!')
     console.log('\nNext steps:')
-    console.log('  1. Open Claude Code or Claude Desktop')
+    console.log(`  1. Open ${activeProvider.displayName}`)
     console.log('  2. Navigate to your project')
-    console.log('  3. Run: /p:init')
+    console.log('  3. Run: /p:init') // This might need adjustment for Gemini (p init) but /p:init is likely fine for now or we can make it dynamic
 
     return {
       success: true,
@@ -90,25 +92,32 @@ export class SetupCommands extends PrjctCommandsBase {
 
     console.log('\n📝 Installing global configuration...')
     const configResult = await commandInstaller.installGlobalConfig()
+    const displayPath = configResult.path ? pathManager.getDisplayPath(configResult.path) : 'global config'
 
     if (configResult.success) {
       if (configResult.action === 'created') {
-        console.log('✅ Created ~/.claude/CLAUDE.md')
+        console.log(`✅ Created ${displayPath}`)
       } else if (configResult.action === 'updated') {
-        console.log('✅ Updated ~/.claude/CLAUDE.md')
+        console.log(`✅ Updated ${displayPath}`)
       } else if (configResult.action === 'appended') {
-        console.log('✅ Added prjct config to ~/.claude/CLAUDE.md')
+        console.log(`✅ Added prjct config to ${displayPath}`)
       }
     } else {
       console.log(`⚠️  ${configResult.error}`)
     }
 
-    console.log('\n⚡ Installing status line...')
-    const statusLineResult = await this.installStatusLine()
-    if (statusLineResult.success) {
-      console.log('✅ Status line configured')
-    } else {
-      console.log(`⚠️  ${statusLineResult.error}`)
+    const aiProvider = require('../infrastructure/ai-provider')
+    const activeProvider = aiProvider.getActiveProvider()
+    
+    // Status line is currently Claude-only
+    if (activeProvider.name === 'claude') {
+      console.log('\n⚡ Installing status line...')
+      const statusLineResult = await this.installStatusLine()
+      if (statusLineResult.success) {
+        console.log('✅ Status line configured')
+      } else {
+        console.log(`⚠️  ${statusLineResult.error}`)
+      }
     }
 
     console.log('\n🎉 Setup complete!\n')
@@ -126,6 +135,7 @@ export class SetupCommands extends PrjctCommandsBase {
    */
   async installStatusLine(): Promise<{ success: boolean; error?: string }> {
     try {
+      // Note: This method is currently Claude-specific
       const claudeDir = pathManager.getClaudeDir()
       const settingsPath = pathManager.getClaudeSettingsPath()
       const statusLinePath = path.join(claudeDir, 'prjct-statusline.sh')

package/core/index.ts

@@ -198,11 +198,15 @@ function displayVersion(version: string): void {
   const claudeConfigured = fs.existsSync(claudeCommandPath)
   const geminiConfigured = fs.existsSync(geminiCommandPath)
 
+  // Check current project for Cursor
+  const cursorConfigured = fs.existsSync(path.join(process.cwd(), '.cursor', 'commands', 'sync.md'))
+  const cursorExists = fs.existsSync(path.join(process.cwd(), '.cursor'))
+
   console.log(`
 ${CYAN}p/${RESET} prjct v${version}
 ${DIM}Context layer for AI coding agents${RESET}
 
-${DIM}Providers:${RESET}`)
+${DIM}Global Providers:${RESET}`)
 
   // Claude status
   if (detection.claude.installed) {
@@ -222,8 +226,19 @@ ${DIM}Providers:${RESET}`)
     console.log(`  Gemini CLI    ${DIM}○ not installed${RESET}`)
   }
 
+  // Cursor status (per-project)
+  console.log(`
+${DIM}Project Providers:${RESET}`)
+  if (cursorConfigured) {
+    console.log(`  Cursor IDE    ${GREEN}✓ ready${RESET} ${DIM}(use /sync, /task)${RESET}`)
+  } else if (cursorExists) {
+    console.log(`  Cursor IDE    ${YELLOW}● detected${RESET} ${DIM}(run prjct init)${RESET}`)
+  } else {
+    console.log(`  Cursor IDE    ${DIM}○ no .cursor/ folder${RESET}`)
+  }
+
   console.log(`
-${DIM}Run 'prjct start' to configure providers${RESET}
+${DIM}Run 'prjct start' for Claude/Gemini, 'prjct init' for Cursor${RESET}
 ${CYAN}https://prjct.app${RESET}
 `)
 }
@@ -234,45 +249,49 @@ ${CYAN}https://prjct.app${RESET}
 function displayHelp(): void {
   console.log(`
 prjct - Context layer for AI coding agents
-Works with Claude Code, Gemini CLI, and more.
+Works with Claude Code, Gemini CLI, Cursor IDE, and more.
 
 QUICK START
 -----------
-  1. prjct start          Configure your AI provider (Claude/Gemini)
-  2. Open project in your AI coding agent
-  3. Type: p. sync        Analyze project and generate context
-  4. Type: p. task "..."  Start working on a task
-
-HOW IT WORKS
-------------
-  prjct gives AI agents the context they need about your project.
-  Use "p." commands inside Claude Code or Gemini CLI:
-
-    p. sync              Analyze project, generate domain agents
-    p. task "desc"       Start task with auto-classification
-    p. done              Complete current subtask
-    p. ship "name"       Ship feature with PR + version
+  Claude/Gemini:
+    1. prjct start              Configure your AI provider
+    2. cd my-project && prjct init
+    3. Open in Claude Code or Gemini CLI
+    4. Type: p. sync            Analyze project
+
+  Cursor IDE:
+    1. cd my-project && prjct init
+    2. Open in Cursor
+    3. Type: /sync              Analyze project
+
+COMMANDS (inside your AI agent)
+-------------------------------
+  Claude/Gemini          Cursor            Description
+  ─────────────────────────────────────────────────────
+  p. sync                /sync             Analyze project
+  p. task "desc"         /task "desc"      Start a task
+  p. done                /done             Complete subtask
+  p. ship "name"         /ship "name"      Ship with PR
 
 TERMINAL COMMANDS (this CLI)
 ----------------------------
-  prjct start            First-time setup
+  prjct start            First-time setup (Claude/Gemini global config)
+  prjct init             Initialize project (required for Cursor)
   prjct setup            Reconfigure installations
-  prjct init             Initialize project (creates .prjct/)
   prjct sync             Sync project state
 
 EXAMPLES
 --------
-  # First time setup
+  # Claude Code / Gemini CLI (global setup, then per-project)
   $ prjct start
-
-  # Initialize a new project
   $ cd my-project && prjct init
-
-  # Inside Claude Code or Gemini CLI
   > p. sync
   > p. task "add user authentication"
-  > p. done
-  > p. ship "user auth"
+
+  # Cursor IDE (per-project only)
+  $ cd my-project && prjct init
+  > /sync
+  > /task "add user authentication"
 
 MORE INFO
 ---------