{
  "markdown": "# gemini-teams\n\nA comprehensive [Gemini CLI Extension](https://github.com/google/gemini-cli) for multi-agent development using `tmux` panes and persistent coordination.\n\n## Overview\n\n`gemini-teams` transforms Gemini CLI into a team coordinator. It bundles a roster of specialized development agents and a coordination skill that allows you to spawn them into separate interactive tmux panes. These agents collaborate via persistent \"mailbox\" files in a namespaced global directory, enabling parallel, stateful, and distributed workflows.\n\n## Features\n\n- **Agent Roster:** Includes pre-configured specialists like `@codebase-investigator` and `@security-auditor`.\n- **Parallelism:** Run multiple agents simultaneously in your terminal layout.\n- **Persistent Mailboxes:** Asynchronous coordination via `~/.gemini/com.synapticweave.agent_teams/`.\n- **Peer-to-Peer Messaging:** Agents can communicate with each other directly using namespaced bus files.\n- **Tmux Integration:** Native window management and status bar notifications.\n- **Automatic Fallback:** Spawns agents as background processes if tmux is not available.\n\n## Installation\n\n### Method 1: Direct from GitHub (Recommended)\nYou can install the extension directly from the repository:\n\n```bash\ngemini extensions install https://github.com/Synaptic-Weave/gemini-teams\n```\n\n### Method 2: Developer Link\nIf you want to modify the agents or the coordination logic locally:\n\n1.  **Clone the repo:**\n    ```bash\n    git clone https://github.com/Synaptic-Weave/gemini-teams.git\n    cd gemini-teams\n    ```\n2.  **Link the extension:**\n    ```bash\n    gemini extensions link .\n    ```\n\n### Post-Installation\nAfter installing or linking, you **must** reload your active Gemini session to enable the extension's agents and skills:\n```bash\n/skills reload\n```\n\n## Usage\n\n### Slash Commands\n- **/deploy-team [path] [name] [stack] [desc]**: Automates the deployment of the Matrix Team to a project. If arguments are missing, the coordinator will prompt you for them.\n\n### As a Coordinator\n...\n\n### As a Specialist (Inside a Pane)\n- **Report back:** Use the `report_back.sh` script to send findings to the coordinator's mailbox.\n- **Collaborate:** Use `send_message.sh` to talk to other active agents found in `index.md`.\n\n## Project Structure\n\n- `gemini-extension.json`: The extension manifest.\n- `agents/`: Roster of specialized agent definitions (`.md` files).\n- `skills/coordination/`: \n  - `SKILL.md`: The \"procedural glue\" that teaches agents how to collaborate.\n  - `scripts/`: Implementation of spawning, messaging, and reporting logic.\n\n## License\n\n[MIT](LICENSE)\n",
  "bytes": 2616,
  "sha": "14ac059bbb31e2462347b72a842330af9dec82922a77cf824360f9ad6d5eb3e1",
  "repo_slug": "synaptic-weave/gemini-teams",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_synaptic_weave_gemini_teams_85a8a3b3/readme"
}