Add Warp support and merge with OpenCode support

- Merge opencode and warp format support from rebase

- Add project documentation (.agent/guidelines.md, AGENTS.md)

- Update .gitignore to exclude exported AI rule files

- Fix path normalization in Amazon Q importer

- Improve Warp test coverage for private rules

- Update README to avoid hardcoding format count

Author: JosXa

.agent/guidelines.md

@@ -0,0 +1,29 @@
+---
+alwaysApply: true
+---
+## Project Overview
+
+dotagent is a multi-file AI agent configuration manager that maintains a single source of truth for AI coding assistant rules across multiple IDEs and tools (including VS Code Copilot, Cursor, Claude Code, OpenCode, Windsurf, and more). It converts between a unified `.agent/` directory format and tool-specific formats, supporting import/export operations, nested folders, private rules, and both CLI and TypeScript API usage.
+
+## Package Manager
+
+This project uses **pnpm** for dependency management.
+
+## Available Scripts
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build the project
+pnpm build
+
+# Development mode (watch)
+pnpm dev
+
+# Run tests (recommended for AI agents - non-interactive)
+pnpm test:ci
+
+# Type checking
+pnpm typecheck
+```

.gitignore

@@ -9,4 +9,19 @@ coverage/
 *.tsbuildinfo
 .vitest/
 .cursor
-.claude
+.claude
+# Added by dotagent: ignore exported AI rule files
+.github/copilot-instructions.md
+.cursor/rules/**
+.clinerules
+.windsurfrules
+.rules
+AGENTS.md
+CONVENTIONS.md
+CLAUDE.md
+GEMINI.md
+best_practices.md
+.amazonq/
+.junie/
+.roo/
+WARP.md

AGENTS.md

@@ -0,0 +1,26 @@
+## Project Overview
+
+dotagent is a multi-file AI agent configuration manager that maintains a single source of truth for AI coding assistant rules across multiple IDEs and tools (including VS Code Copilot, Cursor, Claude Code, OpenCode, Windsurf, and more). It converts between a unified `.agent/` directory format and tool-specific formats, supporting import/export operations, nested folders, private rules, and both CLI and TypeScript API usage.
+
+## Package Manager
+
+This project uses **pnpm** for dependency management.
+
+## Available Scripts
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build the project
+pnpm build
+
+# Development mode (watch)
+pnpm dev
+
+# Run tests (recommended for AI agents - non-interactive)
+pnpm test:ci
+
+# Type checking
+pnpm typecheck
+```

README.md

@@ -1,6 +1,6 @@
 # dotagent
 
-Multi-file AI agent configuration manager with .agent directory support. Maintain a single source of truth for AI coding assistant rules across Claude Code, VS Code Copilot, Cursor, Cline, Windsurf, Zed, Amazon Q Developer, and more.
+Multi-file AI agent configuration manager with .agent directory support. Maintain a single source of truth for AI coding assistant rules across multiple IDEs and tools including VS Code Copilot, Cursor, Claude Code, OpenCode, and more.
 
 ## Features
 

src/cli.ts

@@ -3,11 +3,7 @@
 import { existsSync, readFileSync, writeFileSync, appendFileSync, rmSync } from 'fs'
 import { join, resolve, dirname } from 'path'
 import { parseArgs } from 'util'
-<<<<<<< HEAD
-import { importAll, importAgent, exportToAgent, exportAll, exportToCopilot, exportToCursor, exportToCline, exportToWindsurf, exportToZed, exportToCodex, exportToAider, exportToClaudeCode, exportToGemini, exportToQodo, importRoo, exportToRoo, exportToJunie, importOpenCode, exportToOpenCode } from './index.js'
-=======
-import { importAll, importAgent, exportToAgent, exportAll, exportToCopilot, exportToCursor, exportToCline, exportToWindsurf, exportToZed, exportToCodex, exportToAider, exportToClaudeCode, exportToGemini, exportToQodo, importRoo, exportToRoo, exportToJunie, importWarp, exportToWarp } from './index.js'
->>>>>>> d5e19dd (feat: Add Warp.dev terminal support)
+import { importAll, importAgent, exportToAgent, exportAll, exportToCopilot, exportToCursor, exportToCline, exportToWindsurf, exportToZed, exportToCodex, exportToAider, exportToClaudeCode, exportToGemini, exportToQodo, importRoo, exportToRoo, exportToJunie, importOpenCode, exportToOpenCode, importWarp, exportToWarp } from './index.js'
 import { color, header, formatList } from './utils/colors.js'
 import { select, confirm } from './utils/prompt.js'
 
@@ -46,11 +42,7 @@ ${color.bold('Usage:')}
 ${color.bold('Options:')}
   ${color.yellow('-h, --help')}       Show this help message
   ${color.yellow('-o, --output')}     Output file path (for convert command)
-<<<<<<< HEAD
-  ${color.yellow('-f, --format')}     Specify format (copilot|cursor|cline|windsurf|zed|codex|aider|claude|gemini|qodo|roo|junie|opencode)
-=======
-  ${color.yellow('-f, --format')}     Specify format (copilot|cursor|cline|windsurf|zed|codex|aider|claude|gemini|qodo|roo|junie|warp)
->>>>>>> d5e19dd (feat: Add Warp.dev terminal support)
+  ${color.yellow('-f, --format')}     Specify format (copilot|cursor|cline|windsurf|zed|codex|aider|claude|gemini|qodo|roo|junie|opencode|warp)
   ${color.yellow('--formats')}        Specify multiple formats (comma-separated)
   ${color.yellow('-w, --overwrite')}  Overwrite existing files
   ${color.yellow('-d, --dry-run')}    Preview operations without making changes
@@ -216,6 +208,9 @@ async function main() {
       } else if (values.format) {
         // Single format from -f flag
         selectedFormats = [values.format]
+      } else if (isDryRun) {
+        // In dry-run mode, default to 'all' to avoid hanging on prompt
+        selectedFormats = ['all']
       } else {
         // Interactive menu
         console.log()
@@ -224,11 +219,7 @@ async function main() {
       }
 
       // Validate formats
-<<<<<<< HEAD
-      const validFormats = ['all', 'copilot', 'cursor', 'cline', 'windsurf', 'zed', 'codex', 'aider', 'claude', 'gemini', 'qodo', 'roo', 'junie', 'opencode']
-=======
-      const validFormats = ['all', 'copilot', 'cursor', 'cline', 'windsurf', 'zed', 'codex', 'aider', 'claude', 'gemini', 'qodo', 'roo', 'junie', 'warp']
->>>>>>> d5e19dd (feat: Add Warp.dev terminal support)
+      const validFormats = ['all', 'copilot', 'cursor', 'cline', 'windsurf', 'zed', 'codex', 'aider', 'claude', 'gemini', 'qodo', 'roo', 'junie', 'opencode', 'warp']
       const invalidFormats = selectedFormats.filter(f => !validFormats.includes(f))
       if (invalidFormats.length > 0) {
         console.error(color.error(`Invalid format(s): ${invalidFormats.join(', ')}`))
@@ -248,8 +239,21 @@ async function main() {
         if (selectedFormat === 'all') {
           if (!isDryRun) {
             exportAll(rules, outputDir, false, options)
+            console.log(color.success('Exported to all formats'))
+          } else {
+            console.log(color.info('Would export to:'))
+            console.log(color.dim('  - .github/copilot-instructions.md'))
+            console.log(color.dim('  - .cursor/rules/'))
+            console.log(color.dim('  - .clinerules'))
+            console.log(color.dim('  - .windsurfrules'))
+            console.log(color.dim('  - .rules'))
+            console.log(color.dim('  - AGENTS.md'))
+            console.log(color.dim('  - CONVENTIONS.md'))
+            console.log(color.dim('  - CLAUDE.md'))
+            console.log(color.dim('  - GEMINI.md'))
+            console.log(color.dim('  - best_practices.md'))
+            console.log(color.dim('  - WARP.md'))
           }
-          console.log(color.success('Exported to all formats'))
           exportedPaths.push(
             '.github/copilot-instructions.md',
             '.cursor/rules/',
@@ -341,7 +345,11 @@ async function main() {
           }
 
           if (exportPath) {
-            console.log(color.success(`Exported to: ${color.path(exportPath)}`))
+            if (isDryRun) {
+              console.log(color.info(`Would export to: ${color.path(exportPath)}`))
+            } else {
+              console.log(color.success(`Exported to: ${color.path(exportPath)}`))
+            }
           }
         }
       }
@@ -409,11 +417,7 @@ async function main() {
         else if (inputPath.endsWith('WARP.md')) format = 'warp'
         else {
           console.error(color.error('Cannot auto-detect format'))
-<<<<<<< HEAD
-          console.error(color.dim('Hint: Specify format with -f (copilot|cursor|cline|windsurf|zed|codex|aider|claude|gemini|qodo|roo|opencode)'))
-=======
-          console.error(color.dim('Hint: Specify format with -f (copilot|cursor|cline|windsurf|zed|codex|aider|claude|gemini|qodo|roo|warp)'))
->>>>>>> d5e19dd (feat: Add Warp.dev terminal support)
+          console.error(color.dim('Hint: Specify format with -f (copilot|cursor|cline|windsurf|zed|codex|aider|claude|gemini|qodo|roo|opencode|warp)'))
           process.exit(1)
         }
       }

src/importers.ts

@@ -797,10 +797,13 @@ export function importAmazonQ(rulesDir: string): ImportResult {
         if (segments[0] === 'private') segments = segments.slice(1)
         const defaultId = segments.join('/')
 
+        // Normalize path for description (use forward slashes)
+        const normalizedRelPath = relPath.replace(/\\/g, '/')
+        
         const metadata: any = {
           id: `amazonq-${defaultId}`,
           alwaysApply: true,
-          description: `Amazon Q rules from ${relPath}`
+          description: `Amazon Q rules from ${normalizedRelPath}`
         }
 
         if (isPrivateFile) {

test/warp.test.ts

@@ -156,11 +156,23 @@ npm run build    # Build for production
     }
   })
 
-  it('should export to WARP.local.md format', () => {
-    const tempDir = mkdtempSync(join(tmpdir(), 'warp-local-export-'))
-    const warpLocalPath = join(tempDir, 'WARP.local.md')
+  it('should export private rules when includePrivate option is set', () => {
+    const tempDir = mkdtempSync(join(tmpdir(), 'warp-private-export-'))
+    const warpPath = join(tempDir, 'WARP.md')
 
     const rules: RuleBlock[] = [
+      {
+        metadata: {
+          id: 'public-config',
+          description: 'Public Configuration',
+          alwaysApply: true,
+          private: false
+        },
+        content: `## Public Environment
+
+Production server runs on port 443.
+Database connection uses production credentials.`
+      },
       {
         metadata: {
           id: 'private-config',
@@ -176,12 +188,15 @@ Database connection uses local credentials.`
     ]
 
     try {
-      exportToWarp(rules, warpLocalPath, { includePrivate: true })
+      // Export with private rules included
+      exportToWarp(rules, warpPath, { includePrivate: true })
 
-      const exported = readFileSync(warpLocalPath, 'utf8')
+      const exported = readFileSync(warpPath, 'utf8')
 
+      expect(exported).toContain('# Public Configuration')
       expect(exported).toContain('# Private Configuration')
       expect(exported).toContain('Development server runs on port 8000')
+      expect(exported).toContain('Production server runs on port 443')
     } finally {
       rmSync(tempDir, { recursive: true, force: true })
     }