prjct-cli 0.37.0 → 0.37.1

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # 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)

package/README.md

@@ -32,49 +32,75 @@ Your AI Agent (Claude/Gemini/Cursor)     prjct
 
 ```bash
 npm install -g prjct-cli
-prjct start
 ```
 
-## Usage
+## Quick Start
 
-Inside Claude Code, Gemini CLI, or Cursor IDE, 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 | Cursor IDE |
 |-----------|-------------|------------|------------|
-| Router | `~/.claude/commands/p.md` | `~/.gemini/commands/p.toml` | `.cursor/commands/p.md` |
+| 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` |
 
 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
 

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
 ---------

package/core/infrastructure/setup.ts

@@ -307,6 +307,7 @@ async function installGeminiGlobalConfig(): Promise<{ success: boolean; action:
  * configuration in .cursor/rules/ and .cursor/commands/.
  *
  * Creates minimal routers that point to the npm package for real instructions.
+ * Installs individual command files for better Cursor UX (/sync, /task, etc.)
  *
  * @param projectRoot - The project root directory
  * @returns Object with success status and files created
@@ -330,10 +331,9 @@ export async function installCursorProject(projectRoot: string): Promise<{
     const commandsDir = path.join(cursorDir, 'commands')
 
     const routerMdcDest = path.join(rulesDir, 'prjct.mdc')
-    const commandRouterDest = path.join(commandsDir, 'p.md')
 
     const routerMdcSource = path.join(getPackageRoot(), 'templates', 'cursor', 'router.mdc')
-    const commandRouterSource = path.join(getPackageRoot(), 'templates', 'cursor', 'p.md')
+    const cursorCommandsSource = path.join(getPackageRoot(), 'templates', 'cursor', 'commands')
 
     // Ensure directories exist
     fs.mkdirSync(rulesDir, { recursive: true })
@@ -345,10 +345,18 @@ export async function installCursorProject(projectRoot: string): Promise<{
       result.rulesCreated = true
     }
 
-    // Copy p.md → .cursor/commands/p.md
-    if (fs.existsSync(commandRouterSource)) {
-      fs.copyFileSync(commandRouterSource, commandRouterDest)
-      result.commandsCreated = true
+    // Copy individual command files → .cursor/commands/
+    // This enables /sync, /task, /done, /ship, etc. syntax in Cursor
+    if (fs.existsSync(cursorCommandsSource)) {
+      const commandFiles = fs.readdirSync(cursorCommandsSource)
+        .filter(f => f.endsWith('.md'))
+
+      for (const file of commandFiles) {
+        const src = path.join(cursorCommandsSource, file)
+        const dest = path.join(commandsDir, file)
+        fs.copyFileSync(src, dest)
+      }
+      result.commandsCreated = commandFiles.length > 0
     }
 
     // Update .gitignore to exclude prjct Cursor routers
@@ -373,7 +381,13 @@ async function addCursorToGitignore(projectRoot: string): Promise<boolean> {
     const entriesToAdd = [
       '# prjct Cursor routers (regenerated per-developer)',
       '.cursor/rules/prjct.mdc',
-      '.cursor/commands/p.md',
+      '.cursor/commands/sync.md',
+      '.cursor/commands/task.md',
+      '.cursor/commands/done.md',
+      '.cursor/commands/ship.md',
+      '.cursor/commands/bug.md',
+      '.cursor/commands/pause.md',
+      '.cursor/commands/resume.md',
     ]
 
     let content = ''

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.37.0",
+  "version": "0.37.1",
   "description": "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
   "main": "core/index.ts",
   "bin": {

package/templates/cursor/commands/bug.md

@@ -0,0 +1,8 @@
+# /bug - Report a bug
+
+**ARGUMENTS**: {{args}}
+
+Run `npm root -g` to get npm global root, then read and execute:
+`{npmRoot}/prjct-cli/templates/commands/bug.md`
+
+Pass the arguments as the bug description.

package/templates/cursor/commands/done.md

@@ -0,0 +1,4 @@
+# /done - Complete current subtask
+
+Run `npm root -g` to get npm global root, then read and execute:
+`{npmRoot}/prjct-cli/templates/commands/done.md`

package/templates/cursor/commands/pause.md

@@ -0,0 +1,6 @@
+# /pause - Pause current task
+
+**ARGUMENTS**: {{args}}
+
+Run `npm root -g` to get npm global root, then read and execute:
+`{npmRoot}/prjct-cli/templates/commands/pause.md`

package/templates/cursor/commands/resume.md

@@ -0,0 +1,4 @@
+# /resume - Resume paused task
+
+Run `npm root -g` to get npm global root, then read and execute:
+`{npmRoot}/prjct-cli/templates/commands/resume.md`

package/templates/cursor/commands/ship.md

@@ -0,0 +1,8 @@
+# /ship - Ship feature with PR + version bump
+
+**ARGUMENTS**: {{args}}
+
+Run `npm root -g` to get npm global root, then read and execute:
+`{npmRoot}/prjct-cli/templates/commands/ship.md`
+
+Pass the arguments as the feature name (optional).

package/templates/cursor/commands/sync.md

@@ -0,0 +1,4 @@
+# /sync - Analyze project
+
+Run `npm root -g` to get npm global root, then read and execute:
+`{npmRoot}/prjct-cli/templates/commands/sync.md`

package/templates/cursor/commands/task.md

@@ -0,0 +1,8 @@
+# /task - Start a task
+
+**ARGUMENTS**: {{args}}
+
+Run `npm root -g` to get npm global root, then read and execute:
+`{npmRoot}/prjct-cli/templates/commands/task.md`
+
+Pass the arguments as the task description.

package/templates/cursor/router.mdc

@@ -11,18 +11,18 @@ You are using **prjct**, a context layer for AI coding agents.
 
 1. Run: `npm root -g` to get the npm global root
 2. Read: `{npmRoot}/prjct-cli/templates/global/CURSOR.mdc`
-3. Follow those instructions for ALL `p. <command>` requests
+3. Follow those instructions for ALL `/command` requests
 
 ## Quick Reference
 
 | Command | Action |
 |---------|--------|
-| `p. sync` | Analyze project, generate agents |
-| `p. task "..."` | Start a task |
-| `p. done` | Complete subtask |
-| `p. ship` | Ship with PR + version |
+| `/sync` | Analyze project, generate agents |
+| `/task "..."` | Start a task |
+| `/done` | Complete subtask |
+| `/ship` | Ship with PR + version |
 
 ## Note
 
-This router auto-regenerates with `p. sync` if deleted.
+This router auto-regenerates with `/sync` if deleted.
 Full instructions are in the npm package (always up-to-date).

package/templates/global/CURSOR.mdc

@@ -10,15 +10,20 @@ alwaysApply: true
 
 ## HOW TO USE PRJCT (Read This First)
 
-When user types `p. <command>`, load the template from the prjct-cli npm package and execute it intelligently.
+In Cursor, use the `/command` syntax. Type `/` followed by the command name:
 
 ```
-p. sync     → templates/commands/sync.md
-p. task X   → templates/commands/task.md
-p. done     → templates/commands/done.md
-p. ship X   → templates/commands/ship.md
+/sync       → Analyze project, generate agents
+/task X     → Start task with description X
+/done       → Complete current subtask
+/ship       → Ship feature with PR + version bump
+/bug X      → Report bug with description X
+/pause      → Pause current task
+/resume     → Resume paused task
 ```
 
+Each command loads templates from the prjct-cli npm package.
+
 **Key Insight**: Templates are GUIDANCE, not scripts. Use your intelligence to adapt them to the situation.
 
 ---
@@ -90,29 +95,29 @@ Built with [Cursor](https://www.cursor.com/)
 ## CORE WORKFLOW
 
 ```
-p. sync  →  p. task "description"  →  [work]  →  p. done  →  p. ship
-   │              │                                  │            │
-   │              └─ Creates branch, breaks down     │            │
-   │                 task, starts tracking           │            │
-   │                                                 │            │
-   └─ Analyzes project, generates agents             │            │
-                                                     │            │
-                              Completes subtask ─────┘            │
-                                                                  │
-                                        Ships feature, PR, tag ───┘
+/sync  →  /task "description"  →  [work]  →  /done  →  /ship
+  │             │                               │          │
+  │             └─ Creates branch, breaks down  │          │
+  │                task, starts tracking        │          │
+  │                                             │          │
+  └─ Analyzes project, generates agents         │          │
+                                                │          │
+                           Completes subtask ───┘          │
+                                                           │
+                                     Ships feature, PR ────┘
 ```
 
 ### Quick Reference
 
-| Trigger | What It Does |
+| Command | What It Does |
 |---------|--------------|
-| `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. bug <desc>` | Report bug with auto-priority |
+| `/sync` | Analyze project, generate domain agents |
+| `/task <desc>` | Start task with auto-classification |
+| `/done` | Complete current subtask |
+| `/ship [name]` | Ship feature with PR + version bump |
+| `/pause` | Pause current task |
+| `/resume` | Resume paused task |
+| `/bug <desc>` | Report bug with auto-priority |
 
 ---
 
@@ -213,8 +218,8 @@ These agents contain project-specific patterns. **USE THEM**.
 ## CURSOR-SPECIFIC NOTES
 
 ### Router Regeneration
-If this file or `.cursor/commands/p.md` is deleted:
-- Run `p. sync` to regenerate them
+If command files in `.cursor/commands/` are deleted:
+- Run `/sync` to regenerate them
 - Or run `prjct init` in the project
 
 ### Model Agnostic