prjct-cli 0.36.1 → 0.37.1

package/core/types/provider.ts

@@ -1,19 +1,23 @@
 /**
  * AI Provider Types
  *
- * Abstractions for supporting multiple AI CLI agents (Claude Code, Gemini CLI).
- * Both agents share similar architectures, making compatibility achievable.
+ * Abstractions for supporting multiple AI coding agents:
+ * - Claude Code (CLI)
+ * - Gemini CLI (CLI)
+ * - Cursor IDE (GUI, project-level config)
  *
- * Key discovery: Skills use identical SKILL.md format for both providers.
+ * Key discovery: Skills use identical SKILL.md format for CLI providers.
+ * Cursor uses .mdc files with frontmatter for rules.
  *
  * @see https://geminicli.com/docs/cli/gemini-md/
  * @see https://geminicli.com/docs/cli/skills/
+ * @see https://cursor.com/docs/context/rules
  */
 
 /**
  * Supported AI provider names
  */
-export type AIProviderName = 'claude' | 'gemini'
+export type AIProviderName = 'claude' | 'gemini' | 'cursor'
 
 /**
  * Command format for each provider
@@ -24,7 +28,7 @@ export type CommandFormat = 'md' | 'toml'
 
 /**
  * AI Provider configuration
- * Defines paths and formats for each AI CLI agent
+ * Defines paths and formats for each AI coding agent
  */
 export interface AIProviderConfig {
   /** Provider identifier */
@@ -33,33 +37,39 @@ export interface AIProviderConfig {
   /** Display name for UI/logs */
   displayName: string
 
-  /** CLI command name (e.g., 'claude', 'gemini') */
-  cliCommand: string
+  /** CLI command name (e.g., 'claude', 'gemini'). Null for GUI apps like Cursor */
+  cliCommand: string | null
 
-  /** Global config directory (e.g., ~/.claude, ~/.gemini) */
-  configDir: string
+  /** Global config directory (e.g., ~/.claude, ~/.gemini). Null for project-level only (Cursor) */
+  configDir: string | null
 
-  /** Context file name (CLAUDE.md or GEMINI.md) */
+  /** Context file name (CLAUDE.md, GEMINI.md, or prjct.mdc for Cursor) */
   contextFile: string
 
-  /** Skills directory (e.g., ~/.claude/skills, ~/.gemini/skills) */
-  skillsDir: string
+  /** Skills directory (e.g., ~/.claude/skills). Null for providers without skill support */
+  skillsDir: string | null
 
-  /** Commands directory relative to project (e.g., .claude/commands, .gemini/commands) */
+  /** Commands directory relative to project (e.g., .claude/commands, .cursor/commands) */
   commandsDir: string
 
+  /** Rules directory for project-level config (e.g., .cursor/rules). Only used by Cursor */
+  rulesDir?: string
+
   /** Command file format */
   commandFormat: CommandFormat
 
-  /** Settings file name (settings.json for both) */
-  settingsFile: string
+  /** Settings file name (settings.json). Null if not applicable */
+  settingsFile: string | null
 
-  /** Project settings file (e.g., settings.local.json, settings.json) */
-  projectSettingsFile: string
+  /** Project settings file (e.g., settings.local.json). Null if not applicable */
+  projectSettingsFile: string | null
 
-  /** Ignore file name (.claudeignore, .geminiignore) */
+  /** Ignore file name (.claudeignore, .geminiignore, .cursorignore) */
   ignoreFile: string
 
+  /** Whether config is project-level only (no global config directory) */
+  isProjectLevel?: boolean
+
   /** URL for provider website */
   websiteUrl: string
 
@@ -88,16 +98,30 @@ export interface ProviderSelectionResult {
   /** Selected provider */
   provider: AIProviderName
 
-  /** Whether user was prompted to choose (both installed) */
+  /** Whether user was prompted to choose (multiple installed) */
   userSelected: boolean
 
-  /** Detection details */
+  /** Detection details for CLI-based providers */
   detection: {
     claude: ProviderDetectionResult
     gemini: ProviderDetectionResult
   }
 }
 
+/**
+ * Result of Cursor project detection
+ */
+export interface CursorProjectDetection {
+  /** Whether .cursor/ directory exists in project */
+  detected: boolean
+
+  /** Whether prjct router is installed */
+  routerInstalled: boolean
+
+  /** Project root path */
+  projectRoot?: string
+}
+
 /**
  * Provider-aware branding configuration
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.36.1",
+  "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/_bases/tracker-base.md

@@ -15,6 +15,8 @@ All issue tracker integrations (Linear, JIRA, GitHub Issues, Monday.com) inherit
 
 - `{projectId}`: From `.prjct/prjct.config.json`
 - `{globalPath}`: `~/.prjct-cli/projects/{projectId}`
+- `{agentName}`: Name of the AI agent (Claude Code, Gemini CLI)
+- `{agentSettingsPath}`: Path to agent settings (settings.json)
 - `{args}`: User-provided arguments (subcommand)
 - `{tracker}`: The tracker name (linear, jira, github, monday)
 - `{mcpPrefix}`: MCP tool prefix (e.g., `mcp__linear__`, `mcp__atlassian__jira_`)
@@ -75,7 +77,7 @@ ELSE:
 ## Step 3: Install MCP Server (COMMON)
 
 ```
-READ: ~/.claude/settings.json (create {} if not exists)
+READ: {agentSettingsPath} (create {} if not exists)
 CHECK: Does mcpServers.{mcpServerName} exist?
 
 IF not exists:
@@ -86,11 +88,11 @@ IF not exists:
     }
   }
 
-  WRITE: ~/.claude/settings.json
+  WRITE: {agentSettingsPath}
 
   OUTPUT: "✅ Installed {TRACKER} MCP server"
   OUTPUT: ""
-  OUTPUT: "⚠️ Restart Claude Code to activate the MCP server."
+  OUTPUT: "⚠️ Restart your AI agent ({agentName}) to activate the MCP server."
   OUTPUT: "Then run `p. {tracker} setup` again to complete configuration."
   STOP
 ```
@@ -104,7 +106,7 @@ CHECK: Are {mcpPrefix}* tools available?
 
 IF not available:
   OUTPUT: "{TRACKER} MCP is installed but not yet active."
-  OUTPUT: "Restart Claude Code, then run `p. {tracker} setup` again."
+  OUTPUT: "Restart {agentName}, then run `p. {tracker} setup` again."
   STOP
 ```
 
@@ -238,7 +240,7 @@ Comment added to {ID}
 |-------|--------|
 | No project | "Run `p. init` first" |
 | Auth not configured | "Run `p. {tracker} setup` first" |
-| MCP tools not found | "Restart Claude Code after setup" |
+| MCP tools not found | "Restart {agentName} after setup" |
 | Auth failed | Re-authenticate message |
 | Issue not found | "Issue {ID} not found in {TRACKER}" |
 | Rate limited | "Rate limited. Try again later" |

package/templates/commands/github.md

@@ -22,6 +22,8 @@ Manage GitHub Issues directly from prjct using MCP.
 
 - `{projectId}`: From `.prjct/prjct.config.json`
 - `{globalPath}`: `~/.prjct-cli/projects/{projectId}`
+- `{agentName}`: Name of the AI agent (Claude Code, Gemini CLI)
+- `{agentSettingsPath}`: Path to agent settings (settings.json)
 - `{args}`: User-provided arguments (subcommand)
 
 ---
@@ -81,14 +83,14 @@ IF not set:
 ## Step 3: Install MCP Server (if needed)
 
 ```
-READ: ~/.claude/settings.json (create {} if not exists)
+READ: {agentSettingsPath} (create {} if not exists)
 CHECK: Does mcpServers.github exist?
 
 IF not exists:
   READ: templates/mcp-config.json
   EXTRACT: mcpServers.github
 
-  MERGE into ~/.claude/settings.json:
+  MERGE into {agentSettingsPath}:
   {
     "mcpServers": {
       "github": {
@@ -101,11 +103,11 @@ IF not exists:
     }
   }
 
-  WRITE: ~/.claude/settings.json
+  WRITE: {agentSettingsPath}
 
   OUTPUT: "✅ Installed GitHub MCP server"
   OUTPUT: ""
-  OUTPUT: "⚠️ Restart Claude Code to activate the MCP server."
+  OUTPUT: "⚠️ Restart {agentName} to activate the MCP server."
   OUTPUT: "Then run `p. github setup` again to complete configuration."
   STOP
 ```
@@ -119,7 +121,7 @@ CHECK: Are mcp__github__* tools available?
 
 IF not available:
   OUTPUT: "GitHub MCP is installed but not yet active."
-  OUTPUT: "Restart Claude Code, then run `p. github setup` again."
+  OUTPUT: "Restart {agentName}, then run `p. github setup` again."
   STOP
 ```
 

package/templates/commands/init.md

@@ -22,6 +22,21 @@ Create `.prjct/prjct.config.json`:
 
 Create `{globalPath}/project.json` with project name from package.json
 
+## Cursor IDE Detection
+
+If `.cursor/` directory exists in project:
+1. Ask: "Cursor IDE detected. Configure prjct for Cursor?"
+2. If yes:
+   - Get npm root: `npm root -g`
+   - Copy router: `{npmRoot}/prjct-cli/templates/cursor/router.mdc` → `.cursor/rules/prjct.mdc`
+   - Copy commands: `{npmRoot}/prjct-cli/templates/cursor/p.md` → `.cursor/commands/p.md`
+   - Add to `.gitignore`:
+     ```
+     # prjct Cursor routers (regenerated per-developer)
+     .cursor/rules/prjct.mdc
+     .cursor/commands/p.md
+     ```
+
 Optional: Ask about JIRA/Linear integration
 
 **Output**:
@@ -30,6 +45,7 @@ Optional: Ask about JIRA/Linear integration
 
 Project ID: {uuid}
 Data: ~/.prjct-cli/projects/{uuid}/
+Cursor: {configured/not detected}
 
 Next:
 - Analyze project → `p. sync`

package/templates/commands/jira.md

@@ -22,6 +22,8 @@ Manage JIRA issues directly from prjct.
 
 - `{projectId}`: From `.prjct/prjct.config.json`
 - `{globalPath}`: `~/.prjct-cli/projects/{projectId}`
+- `{agentName}`: Name of the AI agent (Claude Code, Gemini CLI)
+- `{agentSettingsPath}`: Path to agent settings (settings.json)
 - `{args}`: User-provided arguments (subcommand)
 
 ---
@@ -82,14 +84,14 @@ IF file not found:
 ## Step 2: Install MCP Server (if needed)
 
 ```
-READ: ~/.claude/settings.json (create {} if not exists)
+READ: {agentSettingsPath} (create {} if not exists)
 CHECK: Does mcpServers.Atlassian exist?
 
 IF not exists:
   READ: templates/mcp-config.json
   EXTRACT: mcpServers.Atlassian
 
-  MERGE into ~/.claude/settings.json:
+  MERGE into {agentSettingsPath}:
   {
     "mcpServers": {
       "Atlassian": {
@@ -99,11 +101,11 @@ IF not exists:
     }
   }
 
-  WRITE: ~/.claude/settings.json
+  WRITE: {agentSettingsPath}
 
   OUTPUT: "✅ Installed Atlassian MCP server"
   OUTPUT: ""
-  OUTPUT: "⚠️ Restart Claude Code to activate the MCP server."
+  OUTPUT: "⚠️ Restart {agentName} to activate the MCP server."
   OUTPUT: "Then run `p. jira setup` again to complete configuration."
   STOP
 ```
@@ -122,9 +124,9 @@ ELSE IF mcp__atlassian__jira_* tools available:
   SET: authMode = "mcp"
 
 # MCP installed but not active
-ELSE IF mcpServers.Atlassian exists in settings.json:
+ELSE IF mcpServers.Atlassian exists in {agentSettingsPath}:
   OUTPUT: "Atlassian MCP is installed but not yet active."
-  OUTPUT: "Restart Claude Code, then run `p. jira setup` again."
+  OUTPUT: "Restart {agentName}, then run `p. jira setup` again."
   STOP
 
 # Neither available

package/templates/commands/linear.md

@@ -22,6 +22,8 @@ Manage Linear issues directly from prjct using MCP (no SDK needed).
 
 - `{projectId}`: From `.prjct/prjct.config.json`
 - `{globalPath}`: `~/.prjct-cli/projects/{projectId}`
+- `{agentName}`: Name of the AI agent (Claude Code, Gemini CLI)
+- `{agentSettingsPath}`: Path to agent settings (settings.json)
 - `{args}`: User-provided arguments (subcommand)
 
 ---
@@ -64,14 +66,14 @@ IF file not found:
 ## Step 2: Install MCP Server (if needed)
 
 ```
-READ: ~/.claude/settings.json (create {} if not exists)
+READ: {agentSettingsPath} (create {} if not exists)
 CHECK: Does mcpServers.linear exist?
 
 IF not exists:
   READ: templates/mcp-config.json
   EXTRACT: mcpServers.linear
 
-  MERGE into ~/.claude/settings.json:
+  MERGE into {agentSettingsPath}:
   {
     "mcpServers": {
       "linear": {
@@ -81,11 +83,11 @@ IF not exists:
     }
   }
 
-  WRITE: ~/.claude/settings.json
+  WRITE: {agentSettingsPath}
 
   OUTPUT: "✅ Installed Linear MCP server"
   OUTPUT: ""
-  OUTPUT: "⚠️ Restart Claude Code to activate the MCP server."
+  OUTPUT: "⚠️ Restart {agentName} to activate the MCP server."
   OUTPUT: "Then run `p. linear setup` again to complete configuration."
   STOP
 ```
@@ -99,7 +101,7 @@ CHECK: Are mcp__linear__* tools available?
 
 IF not available:
   OUTPUT: "Linear MCP is installed but not yet active."
-  OUTPUT: "Restart Claude Code, then run `p. linear setup` again."
+  OUTPUT: "Restart {agentName}, then run `p. linear setup` again."
   STOP
 ```
 
@@ -293,7 +295,7 @@ PARAMS:
 
 | Error | Action |
 |-------|--------|
-| MCP tools not found | "Add Linear MCP to settings, restart Claude" |
+| MCP tools not found | "Add Linear MCP to settings, restart {agentName}" |
 | OAuth failed | "Re-authenticate via browser" |
 | Issue not found | "Issue {ID} not found in Linear" |
 

package/templates/commands/monday.md

@@ -22,6 +22,8 @@ Manage Monday.com boards directly from prjct using MCP.
 
 - `{projectId}`: From `.prjct/prjct.config.json`
 - `{globalPath}`: `~/.prjct-cli/projects/{projectId}`
+- `{agentName}`: Name of the AI agent (Claude Code, Gemini CLI)
+- `{agentSettingsPath}`: Path to agent settings (settings.json)
 - `{args}`: User-provided arguments (subcommand)
 
 ---
@@ -63,14 +65,14 @@ IF file not found:
 ## Step 2: Install MCP Server (if needed)
 
 ```
-READ: ~/.claude/settings.json (create {} if not exists)
+READ: {agentSettingsPath} (create {} if not exists)
 CHECK: Does mcpServers.monday exist?
 
 IF not exists:
   READ: templates/mcp-config.json
   EXTRACT: mcpServers.monday
 
-  MERGE into ~/.claude/settings.json:
+  MERGE into {agentSettingsPath}:
   {
     "mcpServers": {
       "monday": {
@@ -80,11 +82,11 @@ IF not exists:
     }
   }
 
-  WRITE: ~/.claude/settings.json
+  WRITE: {agentSettingsPath}
 
   OUTPUT: "✅ Installed Monday.com MCP server"
   OUTPUT: ""
-  OUTPUT: "⚠️ Restart Claude Code to activate the MCP server."
+  OUTPUT: "⚠️ Restart {agentName} to activate the MCP server."
   OUTPUT: "Then run `p. monday setup` again to complete configuration."
   STOP
 ```
@@ -98,7 +100,7 @@ CHECK: Are mcp__monday__* tools available?
 
 IF not available:
   OUTPUT: "Monday MCP is installed but not yet active."
-  OUTPUT: "Restart Claude Code, then run `p. monday setup` again."
+  OUTPUT: "Restart {agentName}, then run `p. monday setup` again."
   STOP
 ```
 
@@ -224,7 +226,7 @@ Next: Work on the task, then `p. done`
 
 | Error | Action |
 |-------|--------|
-| MCP tools not found | "Add Monday MCP to settings, restart Claude" |
+| MCP tools not found | "Add Monday MCP to settings, restart {agentName}" |
 | OAuth failed | "Re-authenticate via browser" |
 | Item not found | "Item not found in board" |
 

package/templates/commands/sync.md

@@ -1,5 +1,5 @@
 ---
-allowed-tools: [Bash]
+allowed-tools: [Bash, Read, Write]
 ---
 
 # p. sync
@@ -10,12 +10,22 @@ prjct sync
 
 CLI handles: git analysis, context generation, agents, skills.
 
+## Cursor Router Regeneration
+
+If `.cursor/` exists but `.cursor/rules/prjct.mdc` is missing:
+1. Get npm root: `npm root -g`
+2. Create `.cursor/rules/` directory if needed
+3. Copy router: `{npmRoot}/prjct-cli/templates/cursor/router.mdc` → `.cursor/rules/prjct.mdc`
+4. Copy commands: `{npmRoot}/prjct-cli/templates/cursor/p.md` → `.cursor/commands/p.md`
+5. Report: "Cursor routers regenerated"
+
 **Output**:
 ```
 ✅ Synced: {projectName}
 
 Ecosystem: {ecosystem}
 Agents: {count} generated
+Cursor: {regenerated/ready/not detected}
 
 Next:
 - Start work → `p. task "description"`

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/p.md

@@ -0,0 +1,29 @@
+# p. Command Router for Cursor IDE
+
+**ARGUMENTS**: {{args}}
+
+## Instructions
+
+1. **Get npm root**: Run `npm root -g`
+2. **Parse arguments**: First word = `command`, rest = `commandArgs`
+3. **Read template**: `{npmRoot}/prjct-cli/templates/commands/{command}.md`
+4. **Execute**: Follow the template with `commandArgs` as input
+
+## Example
+
+If arguments = `task fix the login bug`:
+- command = `task`
+- commandArgs = `fix the login bug`
+- npm root → `/opt/homebrew/lib/node_modules`
+- Read: `/opt/homebrew/lib/node_modules/prjct-cli/templates/commands/task.md`
+- Execute template with: `fix the login bug`
+
+## Available Commands
+
+task, done, ship, sync, init, idea, dash, next, pause, resume, bug,
+linear, github, jira, monday, enrich, feature, prd, plan, review,
+merge, git, test, cleanup, design, analyze, history, update, spec
+
+## Action
+
+NOW run `npm root -g` and read the appropriate command template.

package/templates/cursor/router.mdc

@@ -0,0 +1,28 @@
+---
+description: "prjct - Context layer for AI coding agents"
+alwaysApply: true
+---
+
+# prjct
+
+You are using **prjct**, a context layer for AI coding agents.
+
+## Load Full Instructions
+
+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 `/command` requests
+
+## Quick Reference
+
+| Command | Action |
+|---------|--------|
+| `/sync` | Analyze project, generate agents |
+| `/task "..."` | Start a task |
+| `/done` | Complete subtask |
+| `/ship` | Ship with PR + version |
+
+## Note
+
+This router auto-regenerates with `/sync` if deleted.
+Full instructions are in the npm package (always up-to-date).