tagteam 0.1.0 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # tagteam
 
-Orchestrate Claude and Codex in collaborative AI sessions. Send a prompt to both agents simultaneously, then let them build on each other's responses in multi-round discussions.
+Orchestrate AI agents in collaborative sessions. Pick any two from Claude, Codex, and Gemini — send a prompt to both simultaneously, then let them build on each other's responses in multi-round discussions.
 
 ## Install
 
@@ -16,9 +16,11 @@ npx tagteam "your prompt here"
 
 ## Prerequisites
 
-- Node.js >= 22
-- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI installed and authenticated
-- [Codex](https://github.com/openai/codex) CLI installed and authenticated
+- Node.js >= 20
+- At least two of the following CLIs installed and authenticated:
+  - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (Anthropic)
+  - [Codex](https://github.com/openai/codex) (OpenAI)
+  - [Gemini CLI](https://github.com/google-gemini/gemini-cli) (Google)
 
 ## Usage
 
@@ -36,9 +38,50 @@ Launches an interactive TUI where you can type prompts and see responses from bo
 tagteam "explain how this codebase handles authentication"
 ```
 
+### Choosing agents
+
+By default, tagteam uses Claude and Codex. Use `--agents` to pick a different pair:
+
+```bash
+tagteam --agents claude,gemini "compare these approaches"
+tagteam --agents codex,gemini "review this code"
+```
+
+You can also set the default pair in your config:
+
+```toml
+agents = ["claude", "gemini"]
+```
+
+### Addressing agents inline
+
+Prefix your prompt with an agent name to send it to just that agent:
+
+```
+gemini what do you think about this approach?
+claude summarize the discussion so far
+```
+
+Name two agents to override the active pair for that prompt (separators: `and`, `/`, `&`, `,`):
+
+```
+gemini and codex review this function
+gemini/claude compare your approaches
+gemini & codex review this function
+```
+
+Add `discuss` to start a multi-round discussion — either word order works:
+
+```
+discuss codex and gemini what's the best caching strategy
+codex and gemini discuss what's the best caching strategy
+```
+
+This works for any agent, not just your active pair. Addressed agents receive the full conversation history for context.
+
 ### Discussion mode
 
-Have Claude and Codex discuss a topic in rounds until they reach consensus:
+Have your agents discuss a topic in rounds until they reach consensus:
 
 ```bash
 tagteam discuss "what's the best approach for caching in this app"
@@ -53,6 +96,12 @@ tagteam continue
 # List recent sessions
 tagteam history
 
+# Delete a specific session
+tagteam history rm <id>
+
+# Delete all sessions
+tagteam history clear
+
 # Resume a specific session by ID
 tagteam resume <id>
 
@@ -65,7 +114,7 @@ tagteam show <id> --markdown
 
 ### Configuration
 
-Configuration is stored in `~/.tagteam/config.toml`.
+Configuration is stored in `~/.tagteam/config.toml` (or `%APPDATA%\tagteam\config.toml` on Windows). Session data is stored in `~/.tagteam/tagteam.db`.
 
 ```bash
 # Interactive config editor
@@ -75,16 +124,30 @@ tagteam config
 tagteam config show
 
 # Set a value
+tagteam config set agents claude,gemini
 tagteam config set claude.model sonnet
 tagteam config set codex.model gpt-5.3-codex
+tagteam config set gemini.model gemini-2.5-pro
 tagteam config set discussion.max_rounds 10
 ```
 
+Default values:
+
+| Key | Default |
+|-----|---------|
+| `agents` | `claude, codex` |
+| `claude.model` | `sonnet` |
+| `codex.model` | `gpt-5.3-codex` |
+| `gemini.model` | `gemini-2.5-pro` |
+| `discussion.max_rounds` | `10` |
+
 ### CLI options
 
 ```bash
+tagteam --agents claude,gemini   # Choose agent pair
 tagteam --claude-model <model>   # Override Claude model
 tagteam --codex-model <model>    # Override Codex model
+tagteam --gemini-model <model>   # Override Gemini model
 ```
 
 ## Interactive commands
@@ -93,9 +156,29 @@ While in a session, type these slash commands:
 
 - `/help` - List available commands
 - `/new` - Start a fresh session
-- `/config` - Open the config editor
+- `/config` - Open the config editor (changes take effect immediately)
+- `/copy` - Copy conversation to clipboard
+- `/exit` - Exit the app
 - `Escape` - Interrupt running agents
 
+## Platform Notes
+
+**macOS** — Works out of the box.
+
+**Linux** — Clipboard support requires `xclip` or `xsel`:
+
+```bash
+sudo apt install xclip   # Debian/Ubuntu
+```
+
+If `better-sqlite3` doesn't have a prebuilt binary for your architecture, you'll need build tools:
+
+```bash
+sudo apt install build-essential python3
+```
+
+**Windows** — Recommended to use [Windows Terminal](https://aka.ms/terminal) for best rendering. If `better-sqlite3` fails to install, ensure you have the [Visual Studio Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/) (C++ workload) installed.
+
 ## License
 
 MIT