{"id":28725724,"url":"https://github.com/devflowinc/uzi","last_synced_at":"2025-06-24T07:10:37.269Z","repository":{"id":296047468,"uuid":"990985890","full_name":"devflowinc/uzi","owner":"devflowinc","description":"CLI for running large numbers of coding agents in parallel with git worktrees","archived":false,"fork":false,"pushed_at":"2025-06-04T16:26:48.000Z","size":66596,"stargazers_count":346,"open_issues_count":6,"forks_count":8,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-06-22T05:17:06.845Z","etag":null,"topics":["agentic-ai","ai","codegen","go","golang","llm","llm-inference","parallelization"],"latest_commit_sha":null,"homepage":"https://uzi.sh","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devflowinc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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-05-27T00:39:39.000Z","updated_at":"2025-06-22T01:12:41.000Z","dependencies_parsed_at":"2025-05-29T16:33:53.491Z","dependency_job_id":null,"html_url":"https://github.com/devflowinc/uzi","commit_stats":null,"previous_names":["devflowinc/uzi"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/devflowinc/uzi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devflowinc%2Fuzi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devflowinc%2Fuzi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devflowinc%2Fuzi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devflowinc%2Fuzi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devflowinc","download_url":"https://codeload.github.com/devflowinc/uzi/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devflowinc%2Fuzi/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261624969,"owners_count":23186121,"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","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","codegen","go","golang","llm","llm-inference","parallelization"],"created_at":"2025-06-15T12:01:45.918Z","updated_at":"2025-06-24T07:10:37.247Z","avatar_url":"https://github.com/devflowinc.png","language":"Go","readme":"\u003ca href=\"https://www.uzi.sh\"\u003e\n  \u003cimg src=\"https://trieve.b-cdn.net/www.uzi.sh_.png\"\u003e\n\u003c/a\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca\n    href=\"https://cdn.trieve.ai/uzi-whitepaper.pdf\"\n    target=\"_blank\"\n    rel=\"noopener noreferrer\"\n    \u003eWhitepaper\n  \u003c/a\u003e\n\u003c/p\u003e\n\n## Installation\n\n```bash\ngo install github.com/devflowinc/uzi@latest\n```\n\nMake sure that your GOBIN is in your PATH.\n\n```sh\nexport PATH=\"$PATH:$HOME/go/bin\"\n```\n\n## Features\n\n- 🤖 Run multiple AI coding agents in parallel\n- 🌳 Automatic Git worktree management for isolated development\n- 🖥️ Tmux session management for each agent\n- 🚀 Automatic development server setup with port management\n- 📊 Real-time monitoring of agent status and code changes\n- 🔄 Automatic handling of agent prompts and confirmations\n- 🎯 Easy checkpoint and merge of agent changes\n\n## Prerequisites\n\n- **Git**: For version control and worktree management\n- **Tmux**: For terminal session management\n- **Go**: For installing\n- **Your AI tool of choice**: Such as `claude`, `codex`, etc.\n\n## Configuration\n\n### uzi.yaml\n\nCreate a `uzi.yaml` file in your project root to configure Uzi:\n\n```yaml\ndevCommand: cd astrobits \u0026\u0026 yarn \u0026\u0026 yarn dev --port $PORT\nportRange: 3000-3010\n```\n\n#### Configuration Options\n\n- **`devCommand`**: The command to start your development server. Use `$PORT` as a placeholder for the port number.\n  - Example for Next.js: `npm install \u0026\u0026 npm run dev -- --port $PORT`\n  - Example for Vite: `npm install \u0026\u0026 npm run dev -- --port $PORT`\n  - Example for Django: `pip install -r requirements.txt \u0026\u0026 python manage.py runserver 0.0.0.0:$PORT`\n- **`portRange`**: The range of ports Uzi can use for development servers (format: `start-end`)\n\n**Important**: The `devCommand` should include all necessary setup steps (like `npm install`, `pip install`, etc.) as each agent runs in an isolated worktree with its own dependencies.\n\n## Basic Workflow\n\n1. **Start agents with a task:**\n\n   ```bash\n   uzi prompt --agents claude:3,codex:2 \"Implement a REST API for user management with authentication\"\n   ```\n\n2. **Run uzi auto**\n\n   uzi auto automatically presses Enter to confirm all tool calls\n\n   ```\n   uzi auto\n   ```\n\n3. **Monitor agent progress:**\n\n   ```bash\n   uzi ls -w  # Watch mode\n   ```\n\n4. **Send additional instructions:**\n\n   ```bash\n   uzi broadcast \"Make sure to add input validation\"\n   ```\n\n5. **Merge completed work:**\n   ```bash\n   uzi checkpoint funny-elephant \"feat: add user management API\"\n   ```\n\n## Commands\n\n### `uzi prompt` (alias: `uzi p`)\n\nCreates new agent sessions with the specified prompt.\n\n```bash\nuzi prompt --agents claude:2,codex:1 \"Build a todo app with React\"\n```\n\n**Options:**\n\n- `--agents`: Specify agents and counts in format `agent:count[,agent:count...]`\n  - Use `random` as agent name for random agent names\n  - Example: `--agents claude:2,random:3`\n\n### `uzi ls` (alias: `uzi l`)\n\nLists all active agent sessions with their status.\n\n```bash\nuzi ls       # List active sessions\nuzi ls -w    # Watch mode - refreshes every second\n```\n\n```\nAGENT    MODEL  STATUS    DIFF  ADDR                     PROMPT\nbrian    codex  ready  +0/-0  http://localhost:3003  make a component that looks similar to @astrobits/src/components/Button/ that creates a Tooltip in the same style. Ensure that you include a reference to it and examples on the main page.\ngregory  codex  ready  +0/-0  http://localhost:3001  make a component that `\n```\n\n### `uzi auto` (alias: `uzi a`)\n\nMonitors all agent sessions and automatically handles prompts.\n\n```bash\nuzi auto\n```\n\n**Features:**\n\n- Auto-presses Enter for trust prompts\n- Handles continuation confirmations\n- Runs in the background until interrupted (Ctrl+C)\n\n### `uzi kill` (alias: `uzi k`)\n\nTerminates agent sessions and cleans up resources.\n\n```bash\nuzi kill agent-name    # Kill specific agent\nuzi kill all          # Kill all agents\n```\n\n### `uzi run` (alias: `uzi r`)\n\nExecutes a command in all active agent sessions.\n\n```bash\nuzi run \"git status\"              # Run in all agents\nuzi run --delete \"npm test\"       # Run and delete the window after\n```\n\n**Options:**\n\n- `--delete`: Remove the tmux window after running the command\n\n### `uzi broadcast` (alias: `uzi b`)\n\nSends a message to all active agent sessions.\n\n```bash\nuzi broadcast \"Please add error handling to all API calls\"\n```\n\n### `uzi checkpoint` (alias: `uzi c`)\n\nMakes a commit and rebases changes from an agent's worktree into your current branch.\n\n```bash\nuzi checkpoint agent-name \"feat: implement user authentication\"\n```\n\n### `uzi reset`\n\nRemoves all Uzi data and configuration.\n\n```bash\nuzi reset\n```\n\n**Warning**: This deletes all data in `~/.local/share/uzi`\n\n### Advanced Usage\n\n**Running different AI tools:**\n\n```bash\nuzi prompt --agents=claude:2,aider:2,cursor:1 \"Refactor the authentication system\"\n```\n\n**Using random agent names:**\n\n```bash\nuzi prompt --agents=random:5 \"Fix all TypeScript errors\"\n```\n\n**Running tests across all agents:**\n\n```bash\nuzi run \"npm test\"\n```\n","funding_links":[],"categories":["Go"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevflowinc%2Fuzi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevflowinc%2Fuzi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevflowinc%2Fuzi/lists"}