Merge pull request #3 from SynthoraAI-AI-News-Content-Curator/claude/ai-agent-communication-013MuuopTHxcaVazscD5kJn9

Enhance CLI invocations

Author: hoangsonww

SETUP_GUIDE.md

@@ -0,0 +1,359 @@
+# Setup Guide - Installing AI CLI Tools
+
+**IMPORTANT**: Before using the AI Orchestrator, you need to install and authenticate with the CLI tools you want to use.
+
+## 📋 Prerequisites
+
+The AI Orchestrator coordinates these CLI tools:
+- **Claude Code** (command: `claude`)
+- **Codex** (command: `codex`)
+- **Gemini** (command: `gemini`)
+- **GitHub Copilot CLI** (command: `copilot`)
+
+You need **at least one** of these installed to use the orchestrator.
+
+## 🔧 Installing Each CLI Tool
+
+### 1. Claude Code CLI
+
+**Install:**
+```bash
+# Follow Claude Code installation instructions from Anthropic
+# Visit: https://docs.claude.com/claude-code
+```
+
+**Authenticate:**
+```bash
+claude auth login
+```
+
+**Verify:**
+```bash
+claude --version
+# Should show version info
+
+# Test it works
+claude --message "Hello, Claude!"
+```
+
+### 2. Codex CLI
+
+**Install:**
+```bash
+# Install via pip (if available publicly)
+pip install openai-codex
+
+# Or follow OpenAI's installation instructions
+```
+
+**Authenticate:**
+```bash
+# Set your OpenAI API key
+export OPENAI_API_KEY="your-api-key-here"
+
+# Or configure via their auth command
+codex auth login
+```
+
+**Verify:**
+```bash
+codex --version
+
+# Test it works
+echo "Write a hello world function" | codex
+```
+
+### 3. Gemini CLI
+
+**Install:**
+```bash
+# Install Google's Gemini CLI
+# Follow Google's installation instructions
+pip install google-generativeai
+
+# Or use their CLI tool
+```
+
+**Authenticate:**
+```bash
+# Authenticate with your Google account
+gemini auth login
+
+# Or set API key
+export GOOGLE_API_KEY="your-api-key"
+```
+
+**Verify:**
+```bash
+gemini --version
+
+# Test it works
+gemini --prompt "Hello, Gemini!"
+```
+
+### 4. GitHub Copilot CLI
+
+**Install:**
+```bash
+# Install Copilot CLI
+# Follow GitHub's installation instructions
+npm install -g @githubnext/github-copilot-cli
+
+# Or via other methods provided by GitHub
+```
+
+**Authenticate:**
+```bash
+copilot auth login
+# Follow the prompts to authenticate
+```
+
+**Verify:**
+```bash
+copilot --version
+
+# Test it works
+copilot "write a function"
+```
+
+## ✅ Verify All Installations
+
+Run this script to check which tools are available:
+
+```bash
+#!/bin/bash
+
+echo "Checking AI CLI Tools..."
+echo ""
+
+# Claude
+if command -v claude &> /dev/null; then
+    echo "✓ Claude Code CLI: INSTALLED"
+    claude --version 2>&1 | head -1
+else
+    echo "✗ Claude Code CLI: NOT FOUND"
+fi
+echo ""
+
+# Codex
+if command -v codex &> /dev/null; then
+    echo "✓ Codex CLI: INSTALLED"
+    codex --version 2>&1 | head -1
+else
+    echo "✗ Codex CLI: NOT FOUND"
+fi
+echo ""
+
+# Gemini
+if command -v gemini &> /dev/null; then
+    echo "✓ Gemini CLI: INSTALLED"
+    gemini --version 2>&1 | head -1
+else
+    echo "✗ Gemini CLI: NOT FOUND"
+fi
+echo ""
+
+# GitHub Copilot
+if command -v copilot &> /dev/null; then
+    echo "✓ Copilot CLI: INSTALLED"
+    copilot --version 2>&1 | head -1
+else
+    echo "✗ Copilot CLI: NOT FOUND"
+fi
+echo ""
+
+echo "Checking AI Orchestrator..."
+if [ -x "./ai-orchestrator" ]; then
+    echo "✓ AI Orchestrator: READY"
+    ./ai-orchestrator agents
+else
+    echo "✗ AI Orchestrator: Not executable. Run: chmod +x ai-orchestrator"
+fi
+```
+
+Save this as `check-tools.sh`, make it executable, and run it:
+
+```bash
+chmod +x check-tools.sh
+./check-tools.sh
+```
+
+## 🎯 Quick Start After Installation
+
+Once you have at least one tool installed:
+
+### 1. Verify AI Orchestrator sees your tools
+
+```bash
+./ai-orchestrator agents
+```
+
+You should see:
+```
+                         AI Agents
+┏━━━━━━━━━┳━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━┓
+┃ Agent   ┃ Status          ┃ Command    ┃ Role           ┃
+┡━━━━━━━━━╇━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━┩
+│ claude  │ ✓ Available     │ claude     │ refinement     │
+│ codex   │ ✓ Available     │ codex      │ implementation │
+│ gemini  │ ✓ Available     │ gemini     │ review         │
+└─────────┴─────────────────┴────────────┴────────────────┘
+```
+
+### 2. Test with a simple task
+
+```bash
+# One-shot mode
+./ai-orchestrator run "Create a hello world function" --workflow quick
+
+# Interactive mode
+./ai-orchestrator shell
+> Create a hello world function
+```
+
+## 🔍 Troubleshooting
+
+### "Agent not available" error
+
+**Problem:** `Agent 'claude' not available. Command 'claude' not found.`
+
+**Solution:**
+1. Check if the tool is installed: `which claude`
+2. If not installed, install it following the instructions above
+3. Make sure it's in your PATH
+4. Verify authentication: Try running the command directly
+
+### Authentication errors
+
+**Problem:** Tool is installed but fails with auth errors
+
+**Solution:**
+```bash
+# Claude
+claude auth login
+
+# Codex
+export OPENAI_API_KEY="your-key"
+
+# Gemini
+gemini auth login
+
+# Copilot
+gh auth login
+```
+
+### Command not found
+
+**Problem:** `bash: claude: command not found`
+
+**Solution:**
+1. Install the tool (see installation instructions above)
+2. Add to PATH if installed in custom location:
+   ```bash
+   export PATH=$PATH:/path/to/tool
+   ```
+3. Restart your terminal
+
+### Tool installed but orchestrator doesn't see it
+
+**Problem:** `which claude` works but orchestrator says not available
+
+**Solution:**
+1. Check config: `cat config/agents.yaml`
+2. Make sure `enabled: true`
+3. Verify command name matches: `command: "claude"`
+4. Run validation: `./ai-orchestrator validate`
+
+## 📝 Configuration
+
+If a tool uses a different command name on your system, update `config/agents.yaml`:
+
+```yaml
+agents:
+  claude:
+    enabled: true
+    command: "claude"  # ← Change this to match your command
+    role: "refinement"
+```
+
+## 🎓 Next Steps
+
+After installation:
+
+1. **Test individual tools:**
+   ```bash
+   claude --message "Test"
+   echo "Test" | codex
+   gemini --prompt "Test"
+   copilot "Test"
+   ```
+
+2. **Validate configuration:**
+   ```bash
+   ./ai-orchestrator validate
+   ```
+
+3. **Check available agents:**
+   ```bash
+   ./ai-orchestrator agents
+   ```
+
+4. **Try the interactive shell:**
+   ```bash
+   ./ai-orchestrator shell
+   ```
+
+5. **Read the documentation:**
+   - [Interactive Shell Guide](docs/interactive-shell.md)
+   - [Architecture](docs/architecture.md)
+   - [Adding Agents](docs/adding-agents.md)
+
+## ⚠️ Important Notes
+
+1. **You don't need all tools** - The orchestrator works with whatever you have installed
+2. **Authentication required** - Each tool needs to be logged in
+3. **API costs** - Some tools (Codex, Gemini) may incur API costs
+4. **Internet required** - All tools need internet connection
+5. **Test individually first** - Make sure each tool works on its own before using the orchestrator
+
+## 💡 Recommended Setup
+
+For the **best experience**, install all tools:
+
+```bash
+# Install all tools
+claude auth login    # Claude Code
+# Set up Codex
+gemini auth login    # Gemini
+copilot auth login   # Copilot
+
+# Verify all are working
+./ai-orchestrator agents
+
+# Start using!
+./ai-orchestrator shell
+```
+
+But you can start with **just Claude** if that's what you have:
+
+```bash
+# Only Claude installed
+./ai-orchestrator agents
+# Shows: claude ✓ Available
+
+# Use Claude-only workflow
+./ai-orchestrator shell
+> Create a REST API
+# Works with just Claude!
+```
+
+## 🆘 Getting Help
+
+If you run into issues:
+
+1. Check tool installation: `which <tool-name>`
+2. Test tool directly: `<tool-name> --version`
+3. Verify authentication: Run auth command
+4. Check logs: `cat ai-orchestrator.log`
+5. Validate config: `./ai-orchestrator validate`
+6. Run in verbose mode: `./ai-orchestrator run "task" --verbose`

adapters/cli_communicator.py

@@ -348,16 +348,15 @@ class AgentCLIRegistry:
             'supports_workspace': True,
             'output_format': 'text'
         },
-        'gemini-cli': {
-            'command': 'gemini-cli',
+        'gemini': {
+            'command': 'gemini',
             'method': 'arg',
             'prompt_flag': '--prompt',
             'supports_workspace': False,
             'output_format': 'text'
         },
-        'github-copilot-cli': {
-            'command': 'gh',
-            'subcommand': 'copilot',
+        'copilot': {
+            'command': 'copilot',
             'method': 'arg',
             'supports_workspace': False,
             'output_format': 'text'

config/agents.yaml

@@ -13,7 +13,7 @@ agents:
   # Google Gemini - Code review and architecture analysis
   gemini:
     enabled: true
-    command: "gemini-cli"
+    command: "gemini"
     role: "review"
     timeout: 180
     description: "Reviews code for SOLID principles and best practices"
@@ -29,7 +29,7 @@ agents:
   # GitHub Copilot - Additional suggestions (optional)
   copilot:
     enabled: false
-    command: "gh"  # GitHub CLI with copilot extension
+    command: "copilot"
     role: "suggestions"
     timeout: 120
     description: "Provides alternative implementation suggestions"