prjct-cli 1.1.1 → 1.2.1

package/CHANGELOG.md

@@ -1,12 +1,115 @@
 # Changelog
 
+## [1.2.1] - 2026-02-06
+
+### Bug Fixes
+
+- replace raw ANSI codes with chalk library (PRJ-132) (#111)
+- replace raw ANSI codes with chalk library (PRJ-132)
+
+
+## [1.2.0] - 2026-02-06
+
+### Features
+
+- git hooks integration for auto-sync (PRJ-128) (#112)
+
+
+## [1.2.0] - 2026-02-05
+
+### Added
+
+- **Git hooks integration (PRJ-128)**: New `prjct hooks` command for auto-syncing context on commit and branch checkout
+
+### Implementation Details
+
+New `prjct hooks` CLI subcommand with three operations:
+- `prjct hooks install` — auto-detects hook manager (lefthook > husky > direct `.git/hooks/`) and installs post-commit + post-checkout hooks
+- `prjct hooks uninstall` — cleanly removes only prjct hooks, preserving existing hooks
+- `prjct hooks status` — shows active hooks, strategy, and available managers
+
+Hook scripts feature:
+- **Rate limiting** — 30-second lockfile prevents over-syncing on rapid commits
+- **Background execution** — hooks run `prjct sync` in background, never blocking git
+- **Branch-only checkout** — post-checkout only fires on branch switch, not file checkout
+- **Cross-platform** — handles macOS/Linux differences in `stat` and `md5` commands
+
+Supports three installation strategies:
+- **Lefthook** — adds `prjct-sync-*` commands to existing `lefthook.yml`
+- **Husky** — appends to existing `.husky/` hook scripts
+- **Direct** — writes to `.git/hooks/` as fallback
+
+Hook configuration saved to `project.json` for persistence across sessions.
+
+### Learnings
+
+- Strategy pattern works well for hook manager abstraction (detect → select → install)
+- `stat -f%m` (macOS) vs `stat -c%Y` (Linux) for file modification time
+- Lefthook section merging needs careful regex to avoid duplicates
+- `$3` parameter in post-checkout distinguishes branch checkout (1) from file checkout (0)
+
+### Test Plan
+
+#### For QA
+1. Run `prjct hooks status` — verify shows "Not installed" with available managers
+2. Run `prjct hooks install` — verify detects manager and installs hooks
+3. Run `prjct hooks status` — verify shows "Active"
+4. Make a git commit — verify sync runs in background
+5. Switch branches — verify post-checkout triggers sync
+6. Run `prjct hooks uninstall` — verify clean removal
+7. Run `bun run build && bun run typecheck` — zero errors
+
+#### For Users
+**What changed:** New `prjct hooks` command for automatic context syncing
+**How to use:** Run `prjct hooks install` in any prjct project
+**Breaking changes:** None
+
+## [1.1.2] - 2026-02-05
+
+### Fixed
+
+- **Replace raw ANSI codes with chalk library (PRJ-132)**: Replaced ~60 raw ANSI escape codes across 7 files with chalk library calls
+
+### Implementation Details
+
+Replaced all raw ANSI color/formatting constants (`\x1b[32m`, `\x1b[1m`, etc.) with chalk equivalents (`chalk.green()`, `chalk.bold()`, etc.) in:
+- `bin/prjct.ts` — version display, provider status, welcome message
+- `core/index.ts` — version display, provider status
+- `core/cli/start.ts` — gradient banner using `chalk.rgb()`, setup UI
+- `core/utils/subtask-table.ts` — color palette as chalk functions, progress display
+- `core/utils/help.ts` — all help formatting
+- `core/workflow/workflow-preferences.ts` — hook status display
+- `core/infrastructure/setup.ts` — installation messages
+
+Terminal control sequences (cursor movement, hide/show) kept as raw ANSI since chalk only handles colors/formatting.
+
+### Learnings
+
+- `chalk.rgb(R,G,B)` replaces `\x1b[38;2;R;G;Bm` for true-color support
+- Chalk functions can be stored as array values and called dynamically (useful for color palettes)
+- `chalk.bold.white()` chains work for compound styling
+- Terminal control sequences (`\x1b[?25l`, cursor movement) must stay raw — chalk doesn't handle them
+
+### Test Plan
+
+#### For QA
+1. Run `prjct --version` — verify colored output with provider status
+2. Run `prjct help` — verify formatted help with colors
+3. Run `prjct start --force` — verify gradient banner and colored UI
+4. Set `NO_COLOR=1` and repeat above — verify all color is suppressed
+5. Run `bun run build && bun run typecheck` — verify zero errors
+
+#### For Users
+**What changed:** Terminal colors now use the chalk library instead of raw ANSI codes
+**How to use:** No change — colors appear the same but now respect `NO_COLOR` env variable
+**Breaking changes:** None
+
 ## [1.1.1] - 2026-02-06
 
 ### Bug Fixes
 
 - visual grouping with boxes and tables for structured output (PRJ-134) (#110)
 
-
 ## [1.1.1] - 2026-02-05
 
 ### Improved

package/bin/prjct.ts

@@ -11,6 +11,7 @@
 import fs from 'node:fs'
 import os from 'node:os'
 import path from 'node:path'
+import chalk from 'chalk'
 import { detectAllProviders } from '../core/infrastructure/ai-provider'
 import configManager from '../core/infrastructure/config-manager'
 import editorsConfig from '../core/infrastructure/editors-config'
@@ -61,12 +62,7 @@ if (isQuietMode) {
   setQuietMode(true)
 }
 
-// Colors for output
-const CYAN = '\x1b[36m'
-const YELLOW = '\x1b[33m'
-const DIM = '\x1b[2m'
-const BOLD = '\x1b[1m'
-const RESET = '\x1b[0m'
+// Colors for output (chalk respects NO_COLOR env)
 
 if (args[0] === 'start' || args[0] === 'setup') {
   // Interactive setup with beautiful UI
@@ -108,6 +104,12 @@ if (args[0] === 'start' || args[0] === 'setup') {
     console.log(JSON.stringify(result, null, 2))
     process.exitCode = result.tool === 'error' ? 1 : 0
   }
+} else if (args[0] === 'hooks') {
+  // Git hooks management
+  const { hooksService } = await import('../core/services/hooks-service')
+  const subcommand = args[1] || 'status'
+  const exitCode = await hooksService.run(process.cwd(), subcommand)
+  process.exitCode = exitCode
 } else if (args[0] === 'doctor') {
   // Health check command
   const { doctorService } = await import('../core/services/doctor-service')
@@ -200,52 +202,50 @@ if (args[0] === 'start' || args[0] === 'setup') {
   const windsurfDetected = fs.existsSync(path.join(cwd, '.windsurf'))
   const windsurfConfigured = fs.existsSync(path.join(cwd, '.windsurf', 'rules', 'prjct.md'))
 
-  const GREEN = '\x1b[32m'
-
   console.log(`
-${CYAN}p/${RESET} prjct v${VERSION}
-${DIM}Context layer for AI coding agents${RESET}
+${chalk.cyan('p/')} prjct v${VERSION}
+${chalk.dim('Context layer for AI coding agents')}
 
-${DIM}Providers:${RESET}`)
+${chalk.dim('Providers:')}`)
 
   // Claude status
   if (detection.claude.installed) {
-    const status = claudeConfigured ? `${GREEN}✓ ready${RESET}` : `${YELLOW}● installed${RESET}`
+    const status = claudeConfigured ? chalk.green('✓ ready') : chalk.yellow('● installed')
     const ver = detection.claude.version ? ` (v${detection.claude.version})` : ''
-    console.log(`  Claude Code   ${status}${DIM}${ver}${RESET}`)
+    console.log(`  Claude Code   ${status}${chalk.dim(ver)}`)
   } else {
-    console.log(`  Claude Code   ${DIM}○ not installed${RESET}`)
+    console.log(`  Claude Code   ${chalk.dim('○ not installed')}`)
   }
 
   // Gemini status
   if (detection.gemini.installed) {
-    const status = geminiConfigured ? `${GREEN}✓ ready${RESET}` : `${YELLOW}● installed${RESET}`
+    const status = geminiConfigured ? chalk.green('✓ ready') : chalk.yellow('● installed')
     const ver = detection.gemini.version ? ` (v${detection.gemini.version})` : ''
-    console.log(`  Gemini CLI    ${status}${DIM}${ver}${RESET}`)
+    console.log(`  Gemini CLI    ${status}${chalk.dim(ver)}`)
   } else {
-    console.log(`  Gemini CLI    ${DIM}○ not installed${RESET}`)
+    console.log(`  Gemini CLI    ${chalk.dim('○ not installed')}`)
   }
 
   // Cursor status (project-level)
   if (cursorDetected) {
-    const status = cursorConfigured ? `${GREEN}✓ ready${RESET}` : `${YELLOW}● detected${RESET}`
-    console.log(`  Cursor IDE    ${status}${DIM} (project)${RESET}`)
+    const status = cursorConfigured ? chalk.green('✓ ready') : chalk.yellow('● detected')
+    console.log(`  Cursor IDE    ${status}${chalk.dim(' (project)')}`)
   } else {
-    console.log(`  Cursor IDE    ${DIM}○ not detected${RESET}`)
+    console.log(`  Cursor IDE    ${chalk.dim('○ not detected')}`)
   }
 
   // Windsurf status (project-level)
   if (windsurfDetected) {
-    const status = windsurfConfigured ? `${GREEN}✓ ready${RESET}` : `${YELLOW}● detected${RESET}`
-    console.log(`  Windsurf IDE  ${status}${DIM} (project)${RESET}`)
+    const status = windsurfConfigured ? chalk.green('✓ ready') : chalk.yellow('● detected')
+    console.log(`  Windsurf IDE  ${status}${chalk.dim(' (project)')}`)
   } else {
-    console.log(`  Windsurf IDE  ${DIM}○ not detected${RESET}`)
+    console.log(`  Windsurf IDE  ${chalk.dim('○ not detected')}`)
   }
 
   console.log(`
-${DIM}Run 'prjct start' to configure (CLI providers)${RESET}
-${DIM}Run 'prjct init' to configure (Cursor/Windsurf IDE)${RESET}
-${CYAN}https://prjct.app${RESET}
+${chalk.dim("Run 'prjct start' to configure (CLI providers)")}
+${chalk.dim("Run 'prjct init' to configure (Cursor/Windsurf IDE)")}
+${chalk.cyan('https://prjct.app')}
 `)
 } else {
   // Check if setup has been done
@@ -255,12 +255,12 @@ ${CYAN}https://prjct.app${RESET}
   if (!fs.existsSync(configPath) || !routersInstalled) {
     // First time - prompt to run start
     console.log(`
-${CYAN}${BOLD}  Welcome to prjct!${RESET}
+${chalk.cyan.bold('  Welcome to prjct!')}
 
-  Run ${BOLD}prjct start${RESET} to configure your AI providers.
+  Run ${chalk.bold('prjct start')} to configure your AI providers.
 
-  ${DIM}This is a one-time setup that lets you choose between
-  Claude Code, Gemini CLI, or both.${RESET}
+  ${chalk.dim(`This is a one-time setup that lets you choose between
+  Claude Code, Gemini CLI, or both.`)}
 `)
     process.exitCode = 0
   } else {
@@ -269,7 +269,7 @@ ${CYAN}${BOLD}  Welcome to prjct!${RESET}
       const lastVersion = await editorsConfig.getLastVersion()
 
       if (lastVersion && lastVersion !== VERSION) {
-        console.log(`\n${YELLOW}ℹ${RESET} Updating prjct v${lastVersion} → v${VERSION}...\n`)
+        console.log(`\n${chalk.yellow('ℹ')} Updating prjct v${lastVersion} → v${VERSION}...\n`)
 
         const { default: setup } = await import('../core/infrastructure/setup')
         await setup.run()

package/core/cli/start.ts

@@ -12,46 +12,35 @@ import fs from 'node:fs'
 import os from 'node:os'
 import path from 'node:path'
 import readline from 'node:readline'
+import chalk from 'chalk'
 import { detectAllProviders, Providers } from '../infrastructure/ai-provider'
 import type { AIProviderName } from '../types/provider'
 import { VERSION } from '../utils/version'
 
-// Colors
-const RESET = '\x1b[0m'
-const BOLD = '\x1b[1m'
-const DIM = '\x1b[2m'
-const GREEN = '\x1b[32m'
-const YELLOW = '\x1b[33m'
-const _BLUE = '\x1b[34m'
-const _MAGENTA = '\x1b[35m'
-const CYAN = '\x1b[36m'
-const WHITE = '\x1b[37m'
-const _BG_BLUE = '\x1b[44m'
-
 // True color gradient (cyan -> blue -> purple -> pink)
-const G1 = '\x1b[38;2;0;255;255m' // Cyan
-const G2 = '\x1b[38;2;80;180;255m' // Sky blue
-const G3 = '\x1b[38;2;140;120;255m' // Blue-purple
-const G4 = '\x1b[38;2;200;80;220m' // Purple
-const G5 = '\x1b[38;2;255;80;180m' // Pink
+const G1 = chalk.rgb(0, 255, 255)
+const G2 = chalk.rgb(80, 180, 255)
+const G3 = chalk.rgb(140, 120, 255)
+const G4 = chalk.rgb(200, 80, 220)
+const G5 = chalk.rgb(255, 80, 180)
 
 // Large block letters - PRJCT (7 lines tall)
 const BANNER = `
 
-${G1} ██████╗ ${G2} ██████╗ ${G3}     ██╗${G4} ██████╗${G5}████████╗${RESET}
-${G1} ██╔══██╗${G2} ██╔══██╗${G3}     ██║${G4}██╔════╝${G5}╚══██╔══╝${RESET}
-${G1} ██████╔╝${G2} ██████╔╝${G3}     ██║${G4}██║     ${G5}   ██║   ${RESET}
-${G1} ██╔═══╝ ${G2} ██╔══██╗${G3}██   ██║${G4}██║     ${G5}   ██║   ${RESET}
-${G1} ██║     ${G2} ██║  ██║${G3}╚█████╔╝${G4}╚██████╗${G5}   ██║   ${RESET}
-${G1} ╚═╝     ${G2} ╚═╝  ╚═╝${G3} ╚════╝ ${G4} ╚═════╝${G5}   ╚═╝   ${RESET}
+${G1(' ██████╗ ')}${G2(' ██████╗ ')}${G3('     ██╗')}${G4(' ██████╗')}${G5('████████╗')}
+${G1(' ██╔══██╗')}${G2(' ██╔══██╗')}${G3('     ██║')}${G4('██╔════╝')}${G5('╚══██╔══╝')}
+${G1(' ██████╔╝')}${G2(' ██████╔╝')}${G3('     ██║')}${G4('██║     ')}${G5('   ██║   ')}
+${G1(' ██╔═══╝ ')}${G2(' ██╔══██╗')}${G3('██   ██║')}${G4('██║     ')}${G5('   ██║   ')}
+${G1(' ██║     ')}${G2(' ██║  ██║')}${G3('╚█████╔╝')}${G4('╚██████╗')}${G5('   ██║   ')}
+${G1(' ╚═╝     ')}${G2(' ╚═╝  ╚═╝')}${G3(' ╚════╝ ')}${G4(' ╚═════╝')}${G5('   ╚═╝   ')}
 
 `
 
-const WELCOME_BOX = `  ${WHITE}Context Layer for AI Agents${RESET}  ${DIM}v${VERSION}${RESET}
+const WELCOME_BOX = `  ${chalk.white('Context Layer for AI Agents')}  ${chalk.dim(`v${VERSION}`)}
 
-  ${DIM}Project context layer for AI coding agents.
-  Works with Claude Code, Gemini CLI, and more.${RESET}
-  ${CYAN}https://prjct.app${RESET}
+  ${chalk.dim(`Project context layer for AI coding agents.
+  Works with Claude Code, Gemini CLI, and more.`)}
+  ${chalk.cyan('https://prjct.app')}
 `
 
 interface ProviderOption {
@@ -85,17 +74,14 @@ function showBanner(): void {
  * Show provider selection UI
  */
 function showProviderSelection(options: ProviderOption[], currentIndex: number): void {
-  console.log(`\n${BOLD}  Select AI providers to configure:${RESET}\n`)
-  console.log(`  ${DIM}(Use arrow keys to navigate, space to toggle, enter to confirm)${RESET}\n`)
+  console.log(`\n${chalk.bold('  Select AI providers to configure:')}\n`)
+  console.log(`  ${chalk.dim('(Use arrow keys to navigate, space to toggle, enter to confirm)')}\n`)
 
   options.forEach((option, index) => {
-    const cursor = index === currentIndex ? `${CYAN}❯${RESET}` : ' '
-    const checkbox = option.selected ? `${GREEN}[✓]${RESET}` : `${DIM}[ ]${RESET}`
-    const status = option.installed
-      ? `${GREEN}(installed)${RESET}`
-      : `${YELLOW}(will install)${RESET}`
-    const name =
-      index === currentIndex ? `${BOLD}${option.displayName}${RESET}` : option.displayName
+    const cursor = index === currentIndex ? chalk.cyan('❯') : ' '
+    const checkbox = option.selected ? chalk.green('[✓]') : chalk.dim('[ ]')
+    const status = option.installed ? chalk.green('(installed)') : chalk.yellow('(will install)')
+    const name = index === currentIndex ? chalk.bold(option.displayName) : option.displayName
 
     console.log(`  ${cursor} ${checkbox} ${name} ${status}`)
   })
@@ -131,10 +117,10 @@ async function selectProviders(): Promise<AIProviderName[]> {
 
   // Non-interactive mode: auto-select detected providers
   if (!process.stdin.isTTY) {
-    console.log(`\n${BOLD}  Detected providers:${RESET}\n`)
+    console.log(`\n${chalk.bold('  Detected providers:')}\n`)
     options.forEach((option) => {
       if (option.installed) {
-        console.log(`  ${GREEN}✓${RESET} ${option.displayName}`)
+        console.log(`  ${chalk.green('✓')} ${option.displayName}`)
       }
     })
     console.log('')
@@ -230,7 +216,7 @@ async function installRouter(provider: AIProviderName): Promise<boolean> {
     return false
   } catch (error) {
     console.error(
-      `  ${YELLOW}⚠${RESET} Failed to install ${provider} router: ${(error as Error).message}`
+      `  ${chalk.yellow('⚠')} Failed to install ${provider} router: ${(error as Error).message}`
     )
     return false
   }
@@ -294,7 +280,7 @@ async function installGlobalConfig(provider: AIProviderName): Promise<boolean> {
     return false
   } catch (error) {
     console.error(
-      `  ${YELLOW}⚠${RESET} Failed to install ${provider} config: ${(error as Error).message}`
+      `  ${chalk.yellow('⚠')} Failed to install ${provider} config: ${(error as Error).message}`
     )
     return false
   }
@@ -324,27 +310,27 @@ async function saveSetupConfig(providers: AIProviderName[]): Promise<void> {
  * Show completion message
  */
 function showCompletion(providers: AIProviderName[]): void {
-  console.log(`\n${GREEN}${BOLD}  ✓ Setup complete!${RESET}\n`)
+  console.log(`\n${chalk.green.bold('  ✓ Setup complete!')}\n`)
 
-  console.log(`  ${DIM}Configured providers:${RESET}`)
+  console.log(`  ${chalk.dim('Configured providers:')}`)
   providers.forEach((p) => {
     const config = Providers[p]
-    console.log(`    ${GREEN}✓${RESET} ${config.displayName}`)
+    console.log(`    ${chalk.green('✓')} ${config.displayName}`)
   })
 
   console.log(`
-  ${BOLD}Next steps:${RESET}
+  ${chalk.bold('Next steps:')}
 
-  ${CYAN}1.${RESET} Navigate to your project directory
-  ${CYAN}2.${RESET} Run ${BOLD}p. init${RESET} to initialize prjct for that project
-  ${CYAN}3.${RESET} Start tracking with ${BOLD}p. task "your task"${RESET}
+  ${chalk.cyan('1.')} Navigate to your project directory
+  ${chalk.cyan('2.')} Run ${chalk.bold('p. init')} to initialize prjct for that project
+  ${chalk.cyan('3.')} Start tracking with ${chalk.bold('p. task "your task"')}
 
-  ${DIM}Tips:${RESET}
-  ${DIM}•${RESET} Use ${BOLD}p. sync${RESET} to analyze your codebase
-  ${DIM}•${RESET} Use ${BOLD}p. done${RESET} to complete tasks
-  ${DIM}•${RESET} Use ${BOLD}p. ship${RESET} to create PRs
+  ${chalk.dim('Tips:')}
+  ${chalk.dim('•')} Use ${chalk.bold('p. sync')} to analyze your codebase
+  ${chalk.dim('•')} Use ${chalk.bold('p. done')} to complete tasks
+  ${chalk.dim('•')} Use ${chalk.bold('p. ship')} to create PRs
 
-  ${DIM}Learn more: https://prjct.app/docs${RESET}
+  ${chalk.dim('Learn more: https://prjct.app/docs')}
 `)
 }
 
@@ -359,8 +345,8 @@ export async function runStart(): Promise<void> {
   if (fs.existsSync(configPath)) {
     const existing = JSON.parse(fs.readFileSync(configPath, 'utf-8'))
     if (existing.version === VERSION) {
-      console.log(`  ${YELLOW}ℹ${RESET} Already configured for v${VERSION}`)
-      console.log(`  ${DIM}Run with --force to reconfigure${RESET}\n`)
+      console.log(`  ${chalk.yellow('ℹ')} Already configured for v${VERSION}`)
+      console.log(`  ${chalk.dim('Run with --force to reconfigure')}\n`)
 
       if (!process.argv.includes('--force')) {
         return
@@ -371,22 +357,22 @@ export async function runStart(): Promise<void> {
   // Select providers
   const selectedProviders = await selectProviders()
 
-  console.log(`\n  ${CYAN}Setting up...${RESET}\n`)
+  console.log(`\n  ${chalk.cyan('Setting up...')}\n`)
 
   // Install for each selected provider
   for (const provider of selectedProviders) {
     const config = Providers[provider]
-    process.stdout.write(`  ${DIM}•${RESET} ${config.displayName}... `)
+    process.stdout.write(`  ${chalk.dim('•')} ${config.displayName}... `)
 
     const routerOk = await installRouter(provider)
     const configOk = await installGlobalConfig(provider)
 
     if (routerOk && configOk) {
-      console.log(`${GREEN}✓${RESET}`)
+      console.log(chalk.green('✓'))
     } else if (routerOk || configOk) {
-      console.log(`${YELLOW}partial${RESET}`)
+      console.log(chalk.yellow('partial'))
     } else {
-      console.log(`${YELLOW}skipped${RESET}`)
+      console.log(chalk.yellow('skipped'))
     }
   }
 

package/core/commands/planning.ts

@@ -207,6 +207,7 @@ export class PlanningCommands extends PrjctCommandsBase {
     console.log('  Quick start:')
     console.log('    prjct sync     Update context after changes')
     console.log('    prjct task     Start working on a task')
+    console.log('    prjct hooks    Auto-sync on commit/checkout')
     console.log('')
 
     if (wizardResult) {

package/core/index.ts

@@ -10,6 +10,7 @@ import './commands/register' // Ensure commands are registered
 import fs from 'node:fs'
 import os from 'node:os'
 import path from 'node:path'
+import chalk from 'chalk'
 import type { CommandMeta } from './commands/registry'
 import { detectAllProviders, detectAntigravity } from './infrastructure/ai-provider'
 import out from './utils/output'
@@ -195,12 +196,7 @@ function parseCommandArgs(_cmd: CommandMeta, rawArgs: string[]): ParsedCommandAr
   return { parsedArgs, options }
 }
 
-// Colors for version display
-const CYAN = '\x1b[36m'
-const GREEN = '\x1b[32m'
-const YELLOW = '\x1b[33m'
-const DIM = '\x1b[2m'
-const RESET = '\x1b[0m'
+// Colors via chalk (respects NO_COLOR env)
 
 /**
  * Display version with provider status
@@ -219,53 +215,53 @@ function displayVersion(version: string): void {
   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}
+${chalk.cyan('p/')} prjct v${version}
+${chalk.dim('Context layer for AI coding agents')}
 
-${DIM}Providers:${RESET}`)
+${chalk.dim('Providers:')}`)
 
   // Claude status
   if (detection.claude.installed) {
-    const status = claudeConfigured ? `${GREEN}✓ ready${RESET}` : `${YELLOW}● installed${RESET}`
+    const status = claudeConfigured ? chalk.green('✓ ready') : chalk.yellow('● installed')
     const ver = detection.claude.version ? ` (v${detection.claude.version})` : ''
-    console.log(`  Claude Code   ${status}${DIM}${ver}${RESET}`)
+    console.log(`  Claude Code   ${status}${chalk.dim(ver)}`)
   } else {
-    console.log(`  Claude Code   ${DIM}○ not installed${RESET}`)
+    console.log(`  Claude Code   ${chalk.dim('○ not installed')}`)
   }
 
   // Gemini status
   if (detection.gemini.installed) {
-    const status = geminiConfigured ? `${GREEN}✓ ready${RESET}` : `${YELLOW}● installed${RESET}`
+    const status = geminiConfigured ? chalk.green('✓ ready') : chalk.yellow('● installed')
     const ver = detection.gemini.version ? ` (v${detection.gemini.version})` : ''
-    console.log(`  Gemini CLI    ${status}${DIM}${ver}${RESET}`)
+    console.log(`  Gemini CLI    ${status}${chalk.dim(ver)}`)
   } else {
-    console.log(`  Gemini CLI    ${DIM}○ not installed${RESET}`)
+    console.log(`  Gemini CLI    ${chalk.dim('○ not installed')}`)
   }
 
   // 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}`
+      ? chalk.green('✓ ready')
+      : chalk.yellow('● detected')
+    const hint = antigravityDetection.skillInstalled ? '' : ` ${chalk.dim('(run prjct start)')}`
     console.log(`  Antigravity   ${status}${hint}`)
   } else {
-    console.log(`  Antigravity   ${DIM}○ not installed${RESET}`)
+    console.log(`  Antigravity   ${chalk.dim('○ not installed')}`)
   }
 
   // Cursor status (project-level, but shown in same format)
   if (cursorConfigured) {
-    console.log(`  Cursor IDE    ${GREEN}✓ ready${RESET} ${DIM}(use /sync, /task)${RESET}`)
+    console.log(`  Cursor IDE    ${chalk.green('✓ ready')} ${chalk.dim('(use /sync, /task)')}`)
   } else if (cursorExists) {
-    console.log(`  Cursor IDE    ${YELLOW}● detected${RESET} ${DIM}(run prjct init)${RESET}`)
+    console.log(`  Cursor IDE    ${chalk.yellow('● detected')} ${chalk.dim('(run prjct init)')}`)
   } else {
-    console.log(`  Cursor IDE    ${DIM}○ no .cursor/ folder${RESET}`)
+    console.log(`  Cursor IDE    ${chalk.dim('○ no .cursor/ folder')}`)
   }
 
   console.log(`
-${DIM}Run 'prjct start' for Claude/Gemini, 'prjct init' for Cursor${RESET}
-${CYAN}https://prjct.app${RESET}
+${chalk.dim("Run 'prjct start' for Claude/Gemini, 'prjct init' for Cursor")}
+${chalk.cyan('https://prjct.app')}
 `)
 }
 
@@ -306,6 +302,7 @@ TERMINAL COMMANDS (this CLI)
   prjct setup            Reconfigure installations
   prjct sync             Sync project state
   prjct watch            Auto-sync on file changes (Ctrl+C to stop)
+  prjct hooks            Manage git hooks for auto-sync
   prjct doctor           Check system health and dependencies
 
 EXAMPLES