{"id":31576105,"url":"https://github.com/nventive/promptitude","last_synced_at":"2025-10-05T17:17:03.411Z","repository":{"id":314462261,"uuid":"1055621743","full_name":"nventive/Promptitude","owner":"nventive","description":"IDE Extension to automatically sync AI coding assistants configuration and prompt files stored remotely to your IDE. ","archived":false,"fork":false,"pushed_at":"2025-09-26T05:42:01.000Z","size":165,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-30T23:52:01.955Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nventive.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-12T14:38:38.000Z","updated_at":"2025-09-29T12:28:00.000Z","dependencies_parsed_at":"2025-09-12T16:59:15.299Z","dependency_job_id":"7687694d-565f-4103-af22-f2c1150722d2","html_url":"https://github.com/nventive/Promptitude","commit_stats":null,"previous_names":["nventive/promptvault"],"tags_count":0,"template":false,"template_full_name":"nventive/Template","purl":"pkg:github/nventive/Promptitude","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nventive%2FPromptitude","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nventive%2FPromptitude/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nventive%2FPromptitude/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nventive%2FPromptitude/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nventive","download_url":"https://codeload.github.com/nventive/Promptitude/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nventive%2FPromptitude/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278486308,"owners_count":25994945,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-05T02:00:06.059Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-05T17:16:47.532Z","updated_at":"2025-10-05T17:17:03.405Z","avatar_url":"https://github.com/nventive.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Promptitude IDE Extension\n\n\u003e Automatically sync GitHub Copilot prompts from multiple Git repositories to your local VS Code environment.\n\n## 🎯 Overview\n\nThe Prompts Sync Extension automatically synchronizes the latest GitHub Copilot prompts, instructions, and templates from one or more Git repositories to your local VS Code user prompts directory. This ensures you always have access to the most up-to-date, peer-reviewed prompts across all your projects from multiple sources.\n\n## ✨ Features\n\n- **🔄 Automatic Sync**: Configurable sync frequency (daily by default)\n- **📦 Multiple Repositories**: Support for syncing from multiple Git repositories simultaneously\n- **🌍 Cross-Platform**: Works on macOS, Windows, and Linux\n- **⚙️ Configurable**: Customizable sync frequency and target directory\n- **🔐 Secure**: Uses your existing GitHub authentication from VS Code\n- **📦 Read-Only**: Safe pull-only synchronization (no risk of overwriting repositories)\n- **🎨 User-Friendly**: Simple setup with minimal configuration required\n- **📊 Status Indicators**: Clear feedback on sync status and last update time\n- **🛡️ Error Handling**: Graceful handling of repository conflicts and partial failures\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- VS Code 1.70.0 or higher\n- GitHub authentication configured in VS Code\n- Access to a git repository with prompts and configuration files\n\n### Installation\n\n1. Download the latest `promptitude-extension.vsix` file from the releases\n2. Open VS Code\n3. Press `Ctrl+Shift+P` (or `Cmd+Shift+P` on macOS) to open the command palette\n4. Type \"Extensions: Install from VSIX\" and select it\n5. Browse and select the downloaded `.vsix` file\n6. Restart VS Code when prompted\n\n### First-Time Setup\n\n1. Open VS Code Settings (`Ctrl+,` or `Cmd+,`)\n2. Search for \"Promptitude\"\n3. Configure your preferences (optional - defaults work for most users)\n4. The extension will automatically perform an initial sync\n\n## ⚙️ Configuration\n\n### Extension Settings\n\n| Setting                         | Description                      | Default                                                              | Type    |\n| ------------------------------- | -------------------------------- | -------------------------------------------------------------------- | ------- |\n| `promptitude.enabled`           | Enable/disable automatic syncing | `true`                                                               | boolean |\n| `promptitude.frequency`         | Sync frequency                   | `\"daily\"`                                                            | string  |\n| `promptitude.customPath`        | Custom prompts directory path    | `\"\"`                                                                 | string  |\n| `promptitude.repositories`      | Repositories with optional branch (use `url` or `url|branch`) | `[]`                                                                 | array   |\n| `promptitude.syncOnStartup`     | Sync when VS Code starts         | `true`                                                               | boolean |\n| `promptitude.showNotifications` | Show sync status notifications   | `true`                                                               | boolean |\n| `promptitude.syncChatmode`      | Sync chatmode prompts            | `true`                                                               | boolean |\n| `promptitude.syncInstructions`  | Sync instructions prompts        | `false`                                                              | boolean |\n| `promptitude.syncPrompt`        | Sync prompt files                | `true`                                                               | boolean |\n\n### Sync Frequency Options\n\n- `\"startup\"` - Only sync when VS Code starts\n- `\"hourly\"` - Sync every hour\n- `\"daily\"` - Sync once per day (default)\n- `\"weekly\"` - Sync once per week\n- `\"manual\"` - Only sync when manually triggered\n\n### Default Prompts Directory Paths\n\nThe extension automatically detects the correct prompts directory for your operating system:\n\n- **macOS**: `~/Library/Application Support/Code/User/prompts`\n- **Windows**: `%APPDATA%\\Code\\User\\prompts`\n- **Linux**: `~/.config/Code/User/prompts`\n\nYou can override this by setting a custom path in `promptitude.customPath`.\n\n### Multiple Repository Configuration\n\nThe extension supports syncing from multiple Git repositories simultaneously. This is useful for organizations that maintain prompt collections across multiple repositories or for users who want to combine prompts from different sources.\n\n#### Setting up Multiple Repositories (with optional per-repo branch)\n\n1. **Using VS Code Settings UI**:\n   - Open Settings (`Ctrl+,` or `Cmd+,`)\n    - Search for \"promptitude.repositories\"\n    - Click \"Add Item\" to add each repository using one of the following formats:\n       - `https://github.com/your-org/prompts` (defaults to branch `main`)\n       - `https://github.com/your-org/prompts|develop` (explicit branch)\n\n2. **Using JSON Configuration**:\n   ```json\n    {\n       \"promptitude.repositories\": [\n          \"https://github.com/your-org/prompts\",\n          \"https://github.com/your-org/prompts|develop\",\n          \"https://github.com/another-org/shared-prompts|release\"\n       ]\n    }\n   ```\n\n#### Error Handling\n\nWhen syncing multiple repositories:\n\n- **Partial Success**: If some repositories sync successfully while others fail, the extension shows a partial success notification with details\n- **Complete Failure**: If all repositories fail, an error notification is shown\n- **Individual Errors**: Repository-specific errors are logged and reported separately\n\n## 🎮 Usage\n\n### Automatic Sync\n\nOnce configured, the extension works automatically based on your sync frequency setting. You'll see notifications (if enabled) when sync operations complete.\n\n### Manual Sync\n\nYou can manually trigger a sync at any time:\n\n1. Open the command palette (`Ctrl+Shift+P` or `Cmd+Shift+P`)\n2. Type \"Prompts Sync: Sync Now\"\n3. Press Enter\n\n### Status Bar\n\nThe extension adds a status bar item showing:\n\n- Sync status (✅ synced, 🔄 syncing, ❌ error)\n- Last sync time\n- Click to manually trigger sync\n\n### View Sync Status\n\nCheck detailed sync information:\n\n1. Open the command palette\n2. Type \"Prompts Sync: Show Status\"\n3. View sync history, errors, and configuration details\n\n## 📁 Synced Content\n\nThe extension syncs all prompt files from the repository subdirectories into a flattened structure:\n\n```\nprompts/chatmode/*.md       → User/prompts/\nprompts/instructions/*.md   → User/prompts/\nprompts/prompt/*.md         → User/prompts/\n```\n\nAll files are placed directly in the `User/prompts/` directory, removing any subfolder structure for easier access and organization.\n\n## 🔧 Troubleshooting\n\n### Common Issues\n\n#### Sync Fails with Authentication Error\n\n**Problem**: Extension can't access the GitHub repository\n\n**Solutions**:\n\n1. Ensure you're signed into GitHub in VS Code (`View \u003e Command Palette \u003e GitHub: Sign In`)\n2. Verify you have access to the repository\n3. Check your internet connection\n\n#### Prompts Directory Not Found\n\n**Problem**: Extension can't find or create the prompts directory\n\n**Solutions**:\n\n1. Ensure VS Code has write permissions to the user directory\n2. Manually create the prompts directory if it doesn't exist\n3. Set a custom path in extension settings\n\n#### Sync Takes Too Long\n\n**Problem**: Sync operation seems stuck\n\n**Solutions**:\n\n1. Check your internet connection\n2. Try manual sync to see detailed error messages\n3. Restart VS Code and try again\n\n### Debug Mode\n\nEnable debug logging:\n\n1. Open VS Code Settings\n2. Search for \"promptitude.debug\"\n3. Enable debug mode\n4. Check the \"Prompts Sync\" output channel for detailed logs\n\n## 🔒 Security \u0026 Privacy\n\n- **Read-Only Access**: The extension only pulls content from the repository\n- **No Data Collection**: No usage data or personal information is collected\n- **GitHub Authentication**: Uses VS Code's built-in GitHub authentication\n- **Local Storage**: All prompts are stored locally on your machine\n- **No Network Requests**: Only communicates with GitHub for repository access\n\n## 🛠️ Development\n\n### Building from Source\n\n```bash\n# Clone the repository\ngit clone \u003curl\u003e\n\n# Install dependencies\nnpm install\n\n# Build the extension\nnpm run compile\n\n# Package the extension\nnpm run package\n```\n\n### Project Structure\n\n```\ntools/vscode-extension/\n├── src/\n│   ├── extension.ts          # Main extension entry point\n│   ├── syncManager.ts        # Sync logic and GitHub integration\n│   ├── configManager.ts      # Configuration management\n│   ├── statusBarManager.ts   # Status bar integration\n│   └── utils/\n│       ├── fileSystem.ts     # File system operations\n│       ├── github.ts         # GitHub API wrapper\n│       └── notifications.ts  # User notifications\n├── package.json              # Extension manifest\n├── tsconfig.json            # TypeScript configuration\n├── webpack.config.js        # Build configuration\n└── README.md               # This file\n```\n\n### Scripts\n\n- `npm run compile` - Build the extension\n- `npm run watch` - Build in watch mode\n- `npm run package` - Create VSIX package\n- `npm run test` - Run tests\n- `npm run lint` - Run ESLint\n\n\n## 🤝 Contributing\n\nWe welcome contributions to improve the extension! Please see our [Contribution Guide](../../docs/contribution-guide.md) for details.\n\n### Reporting Issues\n\n1. Check existing issues in the repository\n2. Create a new issue with:\n   - Extension version\n   - VS Code version\n   - Operating system\n   - Detailed description of the problem\n   - Steps to reproduce\n\n### Feature Requests\n\n1. Open an issue with the \"enhancement\" label\n2. Describe the desired functionality\n3. Explain the use case and benefits\n\n## 📋 Changelog\n\nFor the complete release history, detailed changes, and migration notes, please refer to the project's changelog:\n\n[See CHANGELOG.md](./CHANGELOG.md)\n\n## 📄 License\n\nApache 2.0\n\n## 📞 Support\n\nFor support and questions:\n\n- Check the [troubleshooting section](#-troubleshooting) above\n- Report an issue.\n\n\n---\n\n**Made with ❤️ by the Logient-nventive Team**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnventive%2Fpromptitude","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnventive%2Fpromptitude","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnventive%2Fpromptitude/lists"}