feat: Add Warp.dev terminal support

Add support for importing from and exporting to Warp.dev WARP.md format.

- Add warp format to importers and exporters

- Add comprehensive Warp test coverage

- Update CLI to support warp format

- Add project documentation files

- Update .gitignore to exclude exported AI rule files

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
 
@@ -33,6 +33,7 @@ Multi-file AI agent configuration manager with .agent directory support. Maintai
 | Amazon Q Developer | `.amazonq/rules/*.md`                 | Plain Markdown                 | amazonq  |
 | JetBrains Junie    | `.junie/guidelines.md`                | Plain Markdown                 | junie    |
 | Roo Code           | `.roo/rules/*.md`                     | Markdown with YAML frontmatter | roo      |
+| Warp.dev           | `WARP.md`                             | Plain Markdown                 | warp     |
 
 ## Installation
 
@@ -103,7 +104,7 @@ dotagent convert my-rules.md -f cursor
 | Flag | Short | Description |
 |------|-------|-------------|
 | `--help` | `-h` | Show help message |
-| `--format`          | `-f`  | Export to single format (copilot\|cursor\|cline\|windsurf\|zed\|codex\|aider\|claude\|gemini\|qodo\|junie\|roo\|opencode) |
+| `--format`          | `-f`  | Export to single format (copilot\|cursor\|cline\|windsurf\|zed\|codex\|aider\|claude\|gemini\|qodo\|junie\|roo\|opencode\|warp) |
 | `--formats` | | Export to multiple formats (comma-separated list) |
 | `--output` | `-o` | Output directory path |
 | `--overwrite` | `-w` | Overwrite existing files |
@@ -223,6 +224,7 @@ Confidential requirements
 | Gemini   | `GEMINI.md`                       | `GEMINI.local.md`                       |
 | Junie    | `.junie/guidelines.md`            | `.junie/guidelines.local.md`            |
 | Roo Code | `.roo/rules/*.md`                | `.roo/rules/*.local.md`               |
+| Warp.dev | `WARP.md`                         | `WARP.local.md`                       |
 
 ### CLI Options
 
@@ -255,6 +257,7 @@ CLAUDE.local.md
 GEMINI.local.md
 .junie/guidelines.local.md
 .roo/rules/*.local.md
+WARP.local.md
 ```
 
 ## Programmatic Usage
@@ -323,6 +326,7 @@ interface RuleMetadata {
 - `importAmazonQ(rulesDir: string): ImportResult` - Import Amazon Q Developer rules
 - `importJunie(filePath: string): ImportResult` - Import JetBrains Junie guidelines
 - `importRoo(rulesDir: string): ImportResult` - Import Roo Code rules
+- `importWarp(filePath: string): ImportResult` - Import Warp.dev rules
 
 ### Export Functions
 
@@ -340,6 +344,7 @@ interface RuleMetadata {
 - `exportToQodo(rules: RuleBlock[], outputPath: string): void`
 - `exportToJunie(rules: RuleBlock[], outputPath: string): void`
 - `exportToRoo(rules: RuleBlock[], outputDir: string): void`
+- `exportToWarp(rules: RuleBlock[], outputPath: string): void`
 
 ## Development
 

src/cli.ts

@@ -3,7 +3,7 @@
 import { existsSync, readFileSync, writeFileSync, appendFileSync, rmSync } from 'fs'
 import { join, resolve, dirname } from 'path'
 import { parseArgs } from 'util'
-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, importOpenCode, exportToOpenCode, importWarp, exportToWarp } from './index.js'
 import { color, header, formatList } from './utils/colors.js'
 import { select, confirm } from './utils/prompt.js'
 
@@ -42,7 +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)
-  ${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|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
@@ -108,7 +108,8 @@ async function main() {
           'AGENTS.md',
           'CLAUDE.md',
           'GEMINI.md',
-          'best_practices.md'
+          'best_practices.md',
+          'WARP.md'
         ]))
       } else {
         console.log(color.success(`Found ${color.number(results.length.toString())} rule file(s):`))
@@ -180,7 +181,6 @@ async function main() {
       }
 
       const outputDir = values.output || repoPath
-      
       const exportFormats = [
         { name: 'All formats', value: 'all' },
         { name: 'VS Code Copilot (.github/copilot-instructions.md)', value: 'copilot' },
@@ -195,7 +195,8 @@ async function main() {
         { name: 'Qodo Merge (best_practices.md)', value: 'qodo' },
         { name: 'Roo Code (.roo/rules/)', value: 'roo' },
         { name: 'JetBrains Junie (.junie/guidelines.md)', value: 'junie' },
-        { name: 'OpenCode (AGENTS.md)', value: 'opencode' }
+        { name: 'OpenCode (AGENTS.md)', value: 'opencode' },
+        { name: 'Warp.dev (WARP.md)', value: 'warp' }
       ]
 
       // Handle format parameter or show interactive menu
@@ -207,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()
@@ -215,7 +219,7 @@ async function main() {
       }
 
       // Validate formats
-      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', 'opencode', 'warp']
       const invalidFormats = selectedFormats.filter(f => !validFormats.includes(f))
       if (invalidFormats.length > 0) {
         console.error(color.error(`Invalid format(s): ${invalidFormats.join(', ')}`))
@@ -235,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/',
@@ -247,7 +264,8 @@ async function main() {
             'CONVENTIONS.md',
             'CLAUDE.md',
             'GEMINI.md',
-            'best_practices.md'
+            'best_practices.md',
+            'WARP.md'
           )
         } else {
           // Export to specific format
@@ -319,10 +337,19 @@ async function main() {
               exportPath = join(outputDir, '.junie/guidelines.md')
               exportedPaths.push('.junie/guidelines.md')
               break
+            case 'warp':
+              exportPath = join(outputDir, 'WARP.md')
+              if (!isDryRun) exportToWarp(rules, exportPath, options)
+              exportedPaths.push('WARP.md')
+              break
           }
 
           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)}`))
+            }
           }
         }
       }
@@ -387,9 +414,10 @@ async function main() {
         else if (inputPath.endsWith('CONVENTIONS.md')) format = 'aider'
         else if (inputPath.endsWith('best_practices.md')) format = 'qodo'
         else if (inputPath.includes('.roo/rules')) format = 'roo'
+        else if (inputPath.endsWith('WARP.md')) format = 'warp'
         else {
           console.error(color.error('Cannot auto-detect format'))
-          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|opencode|warp)'))
           process.exit(1)
         }
       }
@@ -398,7 +426,7 @@ async function main() {
       console.log(`Input: ${color.path(inputPath)}`)
 
       // Import using appropriate importer
-      const { importCopilot, importCursor, importCline, importWindsurf, importZed, importCodex, importAider, importClaudeCode, importGemini, importQodo } = await import('./importers.js')
+      const { importCopilot, importCursor, importCline, importWindsurf, importZed, importCodex, importAider, importClaudeCode, importGemini, importQodo, importWarp } = await import('./importers.js')
 
       let result
       switch (format) {
@@ -438,6 +466,9 @@ async function main() {
         case 'roo':
           result = importRoo(inputPath)
           break
+        case 'warp':
+          result = importWarp(inputPath)
+          break
         default:
           console.error(color.error(`Unknown format: ${format}`))
           process.exit(1)
@@ -550,7 +581,8 @@ function updateGitignore(repoPath: string): void {
     'AGENTS.local.md',
     'CONVENTIONS.local.md',
     'CLAUDE.local.md',
-    'GEMINI.local.md'
+    'GEMINI.local.md',
+    'WARP.local.md'
   ].join('\n')
 
   if (existsSync(gitignorePath)) {

src/exporters.ts

@@ -543,6 +543,28 @@ export function exportToJunie(rules: RuleBlock[], outputDir: string, options?: E
   writeFileSync(filePath, fullContent, 'utf-8')
 }
 
+export function exportToWarp(rules: RuleBlock[], outputPath: string, options?: ExportOptions): void {
+  // Filter out private rules unless includePrivate is true
+  const filteredRules = rules.filter(rule => !rule.metadata.private || options?.includePrivate)
+  
+  const alwaysApplyRules = filteredRules.filter(r => r.metadata.alwaysApply !== false)
+  const conditionalSection = generateConditionalRulesSection(filteredRules, dirname(outputPath))
+  
+  const mainContent = alwaysApplyRules
+    .map(rule => {
+      const header = rule.metadata.description ? `# ${rule.metadata.description}\n\n` : ''
+      return header + rule.content
+    })
+    .join('\n\n')
+  
+  const fullContent = conditionalSection
+    ? `${mainContent}\n\n${conditionalSection}`
+    : mainContent
+
+  ensureDirectoryExists(outputPath)
+  writeFileSync(outputPath, fullContent, 'utf-8')
+}
+
 export function exportAll(rules: RuleBlock[], repoPath: string, dryRun = false, options: ExportOptions = { includePrivate: false }): void {
   // Export to all supported formats
   if (!dryRun) {
@@ -561,6 +583,7 @@ export function exportAll(rules: RuleBlock[], repoPath: string, dryRun = false,
     exportToAmazonQ(rules, repoPath, options)
     exportToRoo(rules, repoPath, options)
     exportToJunie(rules, repoPath, options)
+    exportToWarp(rules, join(repoPath, 'WARP.md'), options)
   }
 }