chatporter 1.0.0

package/SETUP.md

@@ -0,0 +1,146 @@
+# ChatPorter Setup Guide
+
+## Quick Start
+
+1. **Install dependencies:**
+   ```bash
+   npm install
+   ```
+
+2. **Make CLI executable (if needed):**
+   ```bash
+   chmod +x bin/chatporter.js
+   chmod +x src/index.js
+   ```
+
+3. **Test it:**
+   ```bash
+   # Using node directly
+   node src/index.js upload EXAMPLE.md --platform v0
+   
+   # Or use interactive mode
+   node src/index.js
+   ```
+
+## Installation Options
+
+### Option 1: Global Install (Recommended)
+
+```bash
+npm install -g .
+```
+
+Then use from anywhere:
+```bash
+chatporter upload docs/*.md
+```
+
+### Option 2: Use with npx
+
+```bash
+npx chatporter upload docs/*.md
+```
+
+### Option 3: Local Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run directly
+node src/index.js upload <files>
+```
+
+## Usage Examples
+
+### Upload Cherry project docs to v0
+
+```bash
+cd /path/to/Cherry
+chatporter upload docs/spec-integration-summary.md docs/timeline.md docs/task-list.md --platform v0 --output context.txt
+```
+
+### Interactive mode
+
+```bash
+chatporter
+# Follow prompts to select files and platform
+```
+
+### Quick upload and open
+
+```bash
+chatporter upload docs/*.md --platform v0 --open v0
+```
+
+## Moving to Separate Repo
+
+This project is designed to be completely standalone. To move it to its own GitHub repo:
+
+1. **Initialize git:**
+   ```bash
+   cd ChatPorter
+   git init
+   git add .
+   git commit -m "Initial commit: ChatPorter utility"
+   ```
+
+2. **Create GitHub repo** and push:
+   ```bash
+   git remote add origin <your-repo-url>
+   git branch -M main
+   git push -u origin main
+   ```
+
+3. **Publish to npm (optional):**
+   ```bash
+   npm login
+   npm publish
+   ```
+
+## Project Structure
+
+```
+ChatPorter/
+├── bin/
+│   └── chatporter.js      # CLI entry point
+├── src/
+│   └── index.js           # Main logic
+├── package.json           # Dependencies & config
+├── README.md              # User documentation
+├── SETUP.md               # This file
+├── LICENSE                 # MIT license
+└── .chatporterrc.json     # Default config
+```
+
+## Configuration
+
+Edit `.chatporterrc.json` to customize defaults:
+
+```json
+{
+  "defaultPlatform": "v0",
+  "includeMetadata": true,
+  "format": "concise",
+  "maxFileSize": "10MB"
+}
+```
+
+## Troubleshooting
+
+**Issue:** `command not found: chatporter`
+- **Solution:** Use `node src/index.js` directly or install globally with `npm install -g .`
+
+**Issue:** Permission denied
+- **Solution:** Run `chmod +x bin/chatporter.js src/index.js`
+
+**Issue:** Module not found errors
+- **Solution:** Run `npm install` to install dependencies
+
+## Next Steps
+
+1. Test with your own markdown files
+2. Customize platform formatters if needed
+3. Add to your project's workflow
+4. Share with your team!
+

package/USAGE.md

@@ -0,0 +1,124 @@
+# ChatPorter Usage Examples
+
+## Using with Cherry Project
+
+From the Cherry project root, you can upload documentation to AI chats:
+
+```bash
+# Navigate to ChatPorter
+cd ChatPorter
+
+# Install dependencies (first time only)
+npm install
+
+# Set your v0 API key (first time only)
+export V0_API_KEY=your_api_key_here
+# Or create .env file with: V0_API_KEY=your_api_key_here
+
+# Create actual v0 chat via API (Recommended!)
+node src/index.js upload ../docs/spec-integration-summary.md ../docs/timeline.md ../docs/task-list.md --platform v0 --api
+
+# With custom name
+node src/index.js upload ../docs/*.md --platform v0 --api --name "Cherry Project Docs"
+
+# Save formatted output (fallback mode)
+node src/index.js upload ../docs/*.md --platform v0 --output ../chat-context.txt
+
+# Interactive mode
+node src/index.js
+```
+
+## Common Workflows
+
+### 1. Upload Project Specs to v0
+
+```bash
+chatporter upload docs/spec-integration-summary.md docs/timeline.md --platform v0 --output v0-context.txt
+```
+
+### 2. Share Documentation with Team
+
+```bash
+chatporter upload docs/architecture.md docs/data-model.md --platform raw --output shared-context.txt
+```
+
+### 3. Quick Context for ChatGPT
+
+```bash
+chatporter upload README.md docs/setup.md --platform chatgpt
+```
+
+### 4. Multiple Files with Metadata
+
+```bash
+chatporter upload docs/*.md --platform v0 --output full-context.txt
+```
+
+## Platform-Specific Tips
+
+### v0.dev
+- Best for: Technical specs, architecture docs, task lists
+- Format: Includes file list header, clean markdown
+- Usage: Copy output and paste into v0 chat
+
+### ChatGPT
+- Best for: General documentation, explanations
+- Format: Includes friendly intro message
+- Usage: Paste directly into new chat
+
+### Claude
+- Best for: Long-form documentation, analysis
+- Format: XML-style document tags
+- Usage: Paste into Claude chat
+
+### Cursor AI
+- Best for: Code-related documentation
+- Format: Comment-style header
+- Usage: Use in Cursor chat interface
+
+## Advanced Usage
+
+### Custom Output Format
+
+Edit `src/index.js` to add custom formatters:
+
+```javascript
+const platformFormatters = {
+  // ... existing formatters
+  custom: (content, metadata) => {
+    return `CUSTOM FORMAT\n\n${content}`;
+  },
+};
+```
+
+### Batch Processing
+
+Create a script to upload multiple project docs:
+
+```bash
+#!/bin/bash
+# upload-all.sh
+
+chatporter upload \
+  docs/spec-integration-summary.md \
+  docs/timeline.md \
+  docs/task-list.md \
+  docs/architecture.md \
+  --platform v0 \
+  --output all-docs-context.txt
+```
+
+## Tips
+
+1. **File Size**: Large files (>10MB) may need chunking
+2. **Multiple Files**: Use glob patterns: `docs/*.md`
+3. **Output**: Always save to file for sharing: `--output context.txt`
+4. **Platform**: Choose based on your AI assistant's preferences
+
+## Integration Ideas
+
+- Add to your project's `package.json` scripts
+- Create GitHub Actions to auto-generate context
+- Use in CI/CD for documentation updates
+- Share with team members for onboarding
+

package/bin/chatporter.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { createRequire } from 'module';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Import the main module
+const mainPath = join(__dirname, '../src/index.js');
+await import(mainPath);
+

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "chatporter",
+  "version": "1.0.0",
+  "description": "Import repositories and directories from your local machine into v0.dev chats",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "chatporter": "./bin/chatporter.js"
+  },
+  "scripts": {
+    "start": "node src/index.js",
+    "dev": "node --watch src/index.js",
+    "test": "node --test"
+  },
+  "keywords": [
+    "v0",
+    "v0.dev",
+    "chat",
+    "repository",
+    "import",
+    "codebase",
+    "ai",
+    "cli",
+    "github",
+    "directory"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pstagner/ChatPorter.git"
+  },
+  "homepage": "https://github.com/pstagner/ChatPorter#readme",
+  "bugs": {
+    "url": "https://github.com/pstagner/ChatPorter/issues"
+  },
+  "dependencies": {
+    "commander": "^11.1.0",
+    "chalk": "^5.3.0",
+    "inquirer": "^9.2.15",
+    "open": "^10.1.0",
+    "v0-sdk": "^0.1.0",
+    "dotenv": "^16.3.1",
+    "archiver": "^7.0.1",
+    "glob": "^10.3.10"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}
+