{"id":28741032,"url":"https://github.com/evmts/agent","last_synced_at":"2025-09-21T00:58:29.696Z","repository":{"id":298995478,"uuid":"1001781937","full_name":"evmts/agent","owner":"evmts","description":"Plue - Swift and Zig multi-agent coding assistant","archived":false,"fork":false,"pushed_at":"2025-07-27T02:07:45.000Z","size":6320,"stargazers_count":38,"open_issues_count":8,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-27T02:15:09.761Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Swift","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/evmts.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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-06-14T02:42:15.000Z","updated_at":"2025-07-26T17:18:34.000Z","dependencies_parsed_at":"2025-06-14T03:33:42.559Z","dependency_job_id":"c7aa2242-ffcc-40e7-ae26-8a5282492baf","html_url":"https://github.com/evmts/agent","commit_stats":null,"previous_names":["evmts/agent"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/evmts/agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evmts%2Fagent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evmts%2Fagent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evmts%2Fagent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evmts%2Fagent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/evmts","download_url":"https://codeload.github.com/evmts/agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evmts%2Fagent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276179897,"owners_count":25598571,"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-09-20T02:00:10.207Z","response_time":63,"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-06-16T07:09:55.408Z","updated_at":"2025-09-21T00:58:29.684Z","avatar_url":"https://github.com/evmts.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Plue (under development)\n\n**A multi-agent coding assistant built with Swift and Zig**\n\nPlue is a native macOS application that provides an intelligent coding assistant interface with multiple interaction modes. It combines a modern Swift UI with high-performance Zig backend libraries to deliver a responsive and powerful development tool.\n\n**Note:** This project currently only builds on macOS due to its native macOS UI components and frameworks.\n\n## Features\n\n- **🎯 Vim-style Prompt Interface** - Efficient text input with vim keybindings\n- **💬 Modern Chat Interface** - Conversational AI interaction\n- **🖥️ Terminal Integration** - Built-in terminal functionality  \n- **🌐 Farcaster Integration** - Social coding features\n- **🔧 Agent Workflows** - Git worktree management and Dagger container integration\n- **⚡ High Performance** - Zig backend for optimal performance\n- **📂 Command Line Interface** - Open Plue from terminal like VSCode (`plue /path/to/project`)\n- **🍎 Native macOS** - Built specifically for macOS with native frameworks\n\n![telegram-cloud-photo-size-1-5073602166656183931-y](https://github.com/user-attachments/assets/94233eed-b09f-4ed0-a598-8de8c40e7ac4)\n![telegram-cloud-photo-size-1-5073602166656183927-y](https://github.com/user-attachments/assets/c073cd54-9405-4317-a65f-a221275df641)\n![telegram-cloud-photo-size-1-5073602166656183928-y](https://github.com/user-attachments/assets/abe3e80f-7dab-4fc4-b5b2-a9004ceeea4d)\n![telegram-cloud-photo-size-1-5073602166656183929-y](https://github.com/user-attachments/assets/4df08d5c-ff12-424f-8bc7-2716935fd73a)\n![telegram-cloud-photo-size-1-5073602166656183931-y](https://github.com/user-attachments/assets/97990a57-7ed8-46e3-8efd-90ebdd0c5ad2)\n![telegram-cloud-photo-size-1-5073602166656183932-y](https://github.com/user-attachments/assets/b0989a5c-5c12-4a21-ad8d-27c727013b3c)\n\n## Architecture\n\nPlue uses a hybrid architecture:\n\n- **Swift Frontend** - Native macOS UI using SwiftUI, providing smooth user experience\n- **Zig Backend** - High-performance core libraries written in Zig for:\n  - Business logic and state management\n  - Farcaster protocol implementation\n  - Core processing logic\n- **Unified Build System** - Zig build system orchestrates both Zig and Swift compilation\n\n### Build System\n\nPlue uses the **Zig build system** as the primary build orchestrator, which wraps and manages both:\n- Zig library compilation\n- Swift Package Manager (SPM) for the Swift application\n\nThe build process:\n1. **Stage 1**: Build Zig libraries\n2. **Stage 2**: Build Swift application using SPM, linking against Zig libraries\n\n## Requirements\n\n- **macOS 13.0+** (Ventura or later)\n- **Zig 0.14.1** (or later)\n- **Swift 5.8+** (included with Xcode)\n\n## Quick Start\n\n### 1. Install Zig\n\nDownload and install Zig from [https://ziglang.org/download/](https://ziglang.org/download/)\n\n**macOS (using Homebrew):**\n```bash\nbrew install zig\n```\n\n### 2. Clone the Repository\n\n```bash\ngit clone \u003crepository-url\u003e\ncd plue\n```\n\n### 3. Build and Run\n\n```bash\n# Build the complete project\nzig build\n\n# Run the app\nzig build run\n\n# Or run the Swift executable directly\n.build/release/plue\n```\n\n### 4. Install Command Line Interface (Optional)\n\nInstall the `plue` command globally for VSCode-like CLI usage:\n\n```bash\n# Install the CLI command globally\n./scripts/install.sh\n\n# Now you can use plue from anywhere\nplue                       # Open in current directory  \nplue ~/my-project         # Open in specific directory\nplue .                    # Open in current directory (explicit)\n```\n\nExample CLI usage:\n```bash\ncd ~/code/my-awesome-project\nplue                      # Opens Plue in this directory\n\n# Or open directly in any project\nplue ~/code/another-project\n```\n\n## Development\n\n### Build Commands\n\n```bash\n# Build the complete project (Zig libraries + Swift application)\nzig build\n\n# Build and run the application\nzig build run\n\n# Run tests\nzig build test\n```\n\n### Build Commands\n\n| Command | Description |\n|---------|-------------|\n| `zig build` | Build complete project (Zig + Swift) |\n| `zig build run` | Build and run the application |\n| `zig build test` | Run unit tests |\n\n## Project Structure\n\n```\nplue/\n├── Sources/plue/           # Swift application source\n│   ├── App.swift          # Main application entry\n│   ├── ContentView.swift  # Primary UI view\n│   ├── VimPromptView.swift # Vim-style interface\n│   ├── ModernChatView.swift # Chat interface  \n│   ├── TerminalView.swift  # Terminal component\n│   └── ...\n├── src/                   # Zig backend libraries\n│   ├── libplue.zig       # Core Swift interop library\n│   ├── farcaster.zig     # Farcaster protocol implementation\n│   └── ...\n├── build.zig             # Zig build configuration\n├── Package.swift         # Swift package configuration\n└── .github/workflows/    # CI/CD configuration\n```\n\n## Development Environment\n\nRequired tools:\n\n- **Xcode** - For Swift compiler and macOS SDKs\n- **Zig** - Zig compiler and build system (0.14.1 or later)\n- **macOS Frameworks** - Foundation, AppKit, WebKit, Security (included with Xcode)\n\n## Building\n\n### Local Development\n\n```bash\n# Build complete project\nzig build\n\n# Run the application\nzig build run\n\n# Run tests\nzig build test\n```\n\n### Manual Build Steps (if needed)\n\nIf you need to build components separately:\n\n```bash\n# Build Zig libraries only\nzig build-lib -dynamic -OReleaseFast src/libplue.zig -femit-bin=zig-out/lib/libplue.dylib\n\n# Build Swift application\nswift build --configuration release -Xlinker -Lzig-out/lib\n```\n\n## Contributing\n\n1. **Clone the repository** and ensure you have Zig and Xcode installed\n2. **Make your changes** to Swift or Zig code\n3. **Test your changes**: `zig build test`\n4. **Build and verify**: `zig build run`\n5. **Submit a pull request**\n\n## CI/CD\n\nThe project uses GitHub Actions for:\n\n- **Automated builds** on every push and PR\n- **Test execution** to ensure code quality\n- **Dependency updates** via Dependabot\n\n## License\n\n[Add your license here]\n\n## Support\n\n[Add support information here]\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevmts%2Fagent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevmts%2Fagent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevmts%2Fagent/lists"}