{"id":29669335,"url":"https://github.com/chubes4/wordsurf","last_synced_at":"2025-07-22T18:33:34.043Z","repository":{"id":303935029,"uuid":"1017012632","full_name":"chubes4/wordsurf","owner":"chubes4","description":"Agentic WordPress content editor with AI-powered tools","archived":false,"fork":false,"pushed_at":"2025-07-20T15:50:28.000Z","size":1057,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-20T17:40:43.759Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chubes4.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"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}},"created_at":"2025-07-09T22:18:29.000Z","updated_at":"2025-07-20T15:50:32.000Z","dependencies_parsed_at":"2025-07-10T16:01:34.532Z","dependency_job_id":"d5981fb9-c8b0-4067-879b-3e1f571f8409","html_url":"https://github.com/chubes4/wordsurf","commit_stats":null,"previous_names":["chubes4/wordsurf"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/chubes4/wordsurf","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chubes4%2Fwordsurf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chubes4%2Fwordsurf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chubes4%2Fwordsurf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chubes4%2Fwordsurf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chubes4","download_url":"https://codeload.github.com/chubes4/wordsurf/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chubes4%2Fwordsurf/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266552272,"owners_count":23947172,"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-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"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-07-22T18:30:54.010Z","updated_at":"2025-07-22T18:33:34.015Z","avatar_url":"https://github.com/chubes4.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Wordsurf - Agentic WordPress Content Editor\n\nA powerful WordPress plugin that integrates AI agents directly into the WordPress editor, enabling intelligent content creation and management through natural language interactions.\n\n## Features\n\n- **AI-Powered Content Assistant**: Chat with an AI agent directly in the WordPress editor\n- **Tool Integration**: The agent can read and analyze WordPress posts using built-in tools\n- **Real-time Streaming**: Experience fluid, real-time conversations with the AI\n- **WordPress Native**: Seamlessly integrated into the WordPress admin interface\n- **Extensible Architecture**: Modular tool system for easy expansion\n\n## Current Capabilities\n\n### Available Tools\n- **read_post**: Read and analyze WordPress post content, including title, content, metadata, and statistics\n\n### Agent Features\n- Natural language interaction with WordPress content\n- Real-time streaming responses\n- Context-aware conversations\n- Tool calling with visual feedback\n\n## Installation\n\n1. **Clone the repository**:\n   ```bash\n   git clone https://github.com/yourusername/wordsurf.git\n   ```\n\n2. **Install dependencies**:\n   ```bash\n   cd wordsurf\n   npm install\n   ```\n\n3. **Build the assets**:\n   ```bash\n   npm run build\n   ```\n\n4. **Upload to WordPress**:\n   - Copy the entire `wordsurf` folder to your WordPress site's `/wp-content/plugins/` directory\n   - Or zip the folder and upload via WordPress admin\n\n5. **Activate the plugin**:\n   - Go to WordPress Admin → Plugins\n   - Find \"Wordsurf\" and click \"Activate\"\n\n6. **Configure OpenAI API**:\n   - Go to WordPress Admin → Settings → Wordsurf\n   - Enter your OpenAI API key\n   - Save settings\n\n## Usage\n\n1. **Open the Editor**: Create or edit any post/page in WordPress\n2. **Access Wordsurf**: Look for the \"Wordsurf\" panel in the editor sidebar\n3. **Start Chatting**: Type your questions or requests in natural language\n4. **Use Tools**: The AI will automatically use tools when needed to help you\n\n### Example Interactions\n\n- \"What's the current content of this post?\"\n- \"Read the post and tell me the main topics\"\n- \"What's the word count of this article?\"\n\n## Development\n\n### Project Structure\n\n```\nwordsurf/\n├── assets/                 # Compiled assets\n├── includes/              # PHP backend\n│   ├── admin/            # Admin interface\n│   ├── agent/            # AI agent core\n│   │   ├── core/         # Agent logic\n│   │   └── tools/        # Tool implementations\n│   └── api/              # API handlers\n├── src/                   # Source files\n│   └── js/               # JavaScript source\n└── wordsurf.php          # Main plugin file\n```\n\n### Building for Development\n\n```bash\n# Watch for changes\nnpm run dev\n\n# Build for production\nnpm run build\n```\n\n### Adding New Tools\n\n1. Create a new tool class in `includes/agent/core/tools/`\n2. Extend the `Wordsurf_BaseTool` class\n3. Implement the required methods\n4. Register the tool in `Wordsurf_Tool_Manager`\n\n## Requirements\n\n- WordPress 5.0+\n- PHP 7.4+\n- Node.js 14+ (for development)\n- OpenAI API key\n\n## License\n\n[Add your license here]\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Submit a pull request\n\n## Support\n\nFor support, please open an issue on GitHub or contact [your contact information].\n\n## Roadmap\n\n- [ ] Add more content tools (update_post, create_post, delete_post)\n- [ ] Taxonomy management tools\n- [ ] Media handling capabilities\n- [ ] SEO optimization tools\n- [ ] Multi-language support\n- [ ] Advanced context management\n- [ ] Custom tool creation interface\n\n## Changelog\n\n### v0.1.0\n- Initial release\n- Basic AI chat interface\n- read_post tool implementation\n- Real-time streaming responses\n- WordPress editor integration ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchubes4%2Fwordsurf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchubes4%2Fwordsurf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchubes4%2Fwordsurf/lists"}