{"id":50505163,"url":"https://github.com/ezeslucky/velix","last_synced_at":"2026-06-02T15:03:40.295Z","repository":{"id":359370008,"uuid":"1242041898","full_name":"ezeslucky/velix","owner":"ezeslucky","description":"The Modern Code Editor for AI Agents","archived":false,"fork":false,"pushed_at":"2026-05-31T03:08:33.000Z","size":72971,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"veli","last_synced_at":"2026-05-31T05:07:33.570Z","etag":null,"topics":["agentic-ai","ai-agents","claude-code","cli","codex","cursor","mcp","opencode","terminal","vibe-coding"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ezeslucky.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["ezeslucky"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2026-05-18T04:39:11.000Z","updated_at":"2026-05-31T03:08:38.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ezeslucky/velix","commit_stats":null,"previous_names":["ezeslucky/velix"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/ezeslucky/velix","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezeslucky%2Fvelix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezeslucky%2Fvelix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezeslucky%2Fvelix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezeslucky%2Fvelix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ezeslucky","download_url":"https://codeload.github.com/ezeslucky/velix/tar.gz/refs/heads/veli","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezeslucky%2Fvelix/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33827068,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-02T02:00:07.132Z","response_time":109,"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":["agentic-ai","ai-agents","claude-code","cli","codex","cursor","mcp","opencode","terminal","vibe-coding"],"created_at":"2026-06-02T15:03:37.288Z","updated_at":"2026-06-02T15:03:40.268Z","avatar_url":"https://github.com/ezeslucky.png","language":"TypeScript","funding_links":["https://github.com/sponsors/ezeslucky"],"categories":[],"sub_categories":[],"readme":"# Velix — Orchestrate AI Coding Agents in Parallel\n\nRun Claude Code, Codex, Gemini CLI, Cursor Agent, and more across isolated git worktrees — with built-in review, terminal, and editor workflows.\n\n\u003e Ship faster with parallel AI development.\n\n![Velix Dashboard](./docs/images/dashboard.png)\n\n---\n\n## Why Velix?\n\nMost AI coding tools are designed around a single-agent workflow.\n\nVelix is built for developers who want to run multiple AI coding agents simultaneously without losing control of their repository.\n\nWith Velix you can:\n\n* Run many coding agents in parallel\n* Isolate every task using git worktrees\n* Compare outputs safely\n* Review changes quickly\n* Switch context instantly\n* Keep your main repository clean\n\n---\n\n## Features\n\n| Feature                      | Description                                             |\n| :--------------------------- | :------------------------------------------------------ |\n| **Parallel Agent Execution** | Run 10+ coding agents simultaneously                    |\n| **Git Worktree Isolation**   | Every task gets its own isolated branch and workspace   |\n| **Built-in Diff Viewer**     | Review and edit AI-generated changes quickly            |\n| **Agent Monitoring**         | Track task progress in real time                        |\n| **Workspace Presets**        | Automate setup, installs, and environment configuration |\n| **IDE Integration**          | Open any workspace instantly in your editor             |\n| **Universal Compatibility**  | Works with any CLI-based coding agent                   |\n| **Quick Context Switching**  | Move between tasks without losing focus                 |\n\n---\n\n## Demo\n\nhttps://youtube.com/demo-link\n\n---\n\n## Supported Agents\n\nVelix works with any CLI-based coding agent.\n\n| Agent            | Status                |\n| :--------------- | :-------------------- |\n| Claude Code      | ✅ Fully Supported     |\n| OpenAI Codex CLI | ✅ Fully Supported     |\n| Gemini CLI       | ✅ Fully Supported     |\n| Cursor Agent     | ✅ Fully Supported     |\n| GitHub Copilot   | ✅ Fully Supported     |\n| Amp Code         | ✅ Fully Supported     |\n| OpenCode         | ✅ Fully Supported     |\n| Pi               | ✅ Fully Supported     |\n| Any CLI Agent    | ✅ Works Automatically |\n\n\u003e If it runs in a terminal, it runs on Velix.\n\n---\n\n## Quick Start\n\n### Clone the Repository\n\n```bash\ngit clone https://github.com/ezeslucky/velix.git\ncd velix\n```\n\n### Install Dependencies\n\n```bash\nbun install\n```\n\n### Configure Environment\n\n```bash\ncp .env.example .env\n```\n\nOptional quick local setup:\n\n```bash\necho 'SKIP_ENV_VALIDATION=1' \u003e\u003e .env\n```\n\n### Run Development Server\n\n```bash\nbun run dev\n```\n\n### Build Desktop App\n\n```bash\nbun run build\nopen apps/desktop/release\n```\n\n---\n\n## Requirements\n\n| Requirement   | Details                            |\n| :------------ | :--------------------------------- |\n| OS            | macOS (Windows/Linux experimental) |\n| Runtime       | Bun v1.0+                          |\n| Git           | Git 2.20+                          |\n| GitHub CLI    | gh                                 |\n| Reverse Proxy | Caddy                              |\n\n---\n\n## Caddy Setup\n\nVelix uses Caddy for secure local streaming support.\n\n### Install Caddy\n\n```bash\nbrew install caddy\n```\n\n### Configure\n\n```bash\ncp Caddyfile.example Caddyfile\n```\n\n### Trust Local Certificates\n\n```bash\ncaddy trust\n```\n\nWithout this, Chromium may reject secure localhost connections.\n\n---\n\n## Workspace Automation\n\nVelix supports automatic workspace setup and teardown workflows.\n\nExample configuration:\n\n```json\n{\n  \"setup\": [\"./.velix/setup.sh\"],\n  \"teardown\": [\"./.velix/teardown.sh\"]\n}\n```\n\n### Example Setup Script\n\n```bash\n#!/bin/bash\n\n# Copy environment variables\ncp ../.env .env\n\n# Install dependencies\nbun install\n\necho \"Workspace ready!\"\n```\n\nAvailable environment variables:\n\n* `VELIX_WORKSPACE_NAME`\n* `VELIX_ROOT_PATH`\n\n---\n\n## Use Cases\n\n* Run feature development in parallel\n* Compare Claude vs Codex outputs\n* Generate tests while building features\n* Refactor safely in isolated environments\n* Review AI-generated diffs before merging\n* Run experimental changes without affecting main code\n\n---\n\n## Architecture\n\n```text\nUser\n  ↓\nVelix\n  ↓\nGit Worktree\n  ↓\nAI Coding Agent\n  ↓\nDiff Review + Merge\n```\n\n---\n\n## Project Structure\n\n```text\napps/\n  desktop/\n  web/\n\npackages/\n  ui/\n  core/\n  shared/\n```\n\n---\n\n## Tech Stack\n\n* Electron\n* React\n* TailwindCSS\n* Bun\n* Turborepo\n* Vite\n* Biome\n* Drizzle ORM\n* Neon\n* tRPC\n\n---\n\n## Mastra Dependencies\n\nThis repository uses the upstream `mastracode` and `@mastra/*` packages directly.\n\nAvoid custom tarball overrides unless there is a repository-specific blocker.\n\n---\n\n## Roadmap\n\n* [ ] Windows support\n* [ ] Linux support\n* [ ] Team collaboration\n* [ ] Cloud sync\n* [ ] Multi-repository orchestration\n* [ ] Agent templates\n* [ ] Built-in terminal multiplexing\n* [ ] Remote workspace execution\n\n---\n\n## Private by Default\n\n* Full source available under Elastic License 2.0 (ELv2)\n* Explicit integrations only\n* Local-first workflow\n* Your repositories stay under your control\n\n---\n\n## Contributing\n\nContributions are welcome.\n\n### Development Workflow\n\n```bash\ngit checkout -b feature/amazing-feature\ngit commit -m \"Add amazing feature\"\ngit push origin feature/amazing-feature\n```\n\nThen open a Pull Request.\n\nYou can also open GitHub Issues for bugs, ideas, or feature requests.\n\n---\n\n\n## Community\n\n* Twitter — Follow for updates and announcements\n* GitHub Discussions — Ask questions and share ideas\n* GitHub Issues — Report bugs and request features\n\n---\n\n## License\n\nVelix is source-available under the Elastic License 2.0 (ELv2).\n\nYou may use, modify, and self-host Velix, but you may not offer it as a competing hosted service.\n\nSee `LICENSE.md` for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fezeslucky%2Fvelix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fezeslucky%2Fvelix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fezeslucky%2Fvelix/lists"}