agentic-box/owlex

agentic-box profile

Latest recorded source activity: January 10, 2026 at 20:56

SkillsMP catalog refreshed: October 17, 2026 at 00:09

skills collected: 4

GitHub stars: 139
GitHub forks: 16

Repository README

Repository README source: README.md

Read the source README

Expand full README

# Owlex [![Version](https://img.shields.io/github/v/release/agentic-mcp-tools/owlex)](https://github.com/agentic-mcp-tools/owlex/releases) [![License](https://img.shields.io/badge/license-MIT-green)](LICENSE) [![Python](https://img.shields.io/badge/python-3.10+-blue)](https://python.org) [![MCP](https://img.shields.io/badge/MCP-compatible-purple)](https://modelcontextprotocol.io) **Get a second opinion without leaving Claude Code.** Different AI models have different strengths and blind spots. Owlex lets you query Codex, Gemini, OpenCode, ClaudeOR, and AiChat directly from Claude Code - and optionally run a structured deliberation where they review each other's answers before Claude synthesizes a final response. ![Council demo](media/owlex_demo.gif) ## How the Council Works 1. **Round 1** - Your question goes to each agent independently. They answer without seeing each other. 2. **Round 2** - Each agent sees all Round 1 answers and can revise their position. 3. **Synthesis** - Claude reviews everything and outputs a structured answer. Use it for architecture decisions, debugging tricky issues, or when you want more confidence than a single model provides. Not for every question - for the ones that matter. ### Data Flow ![Council data flow](media/council_flow.gif) ## Installation ```bash uv tool install git+https://github.com/agentic-mcp-tools/owlex.git ``` Add to `.mcp.json`: ```json { "mcpServers": { "owlex": { "command": "owlex-server" } } } ``` ## Usage ### Council Deliberation ``` council_ask prompt="Should I use a monorepo or multiple repos for 5 microservices?" ``` Options: - `claude_opinion` - Share your initial thinking with agents - `deliberate` - Enable Round 2 revision (default: true) - `critique` - Agents critique each other instead of revise - `roles` - Assign specialist roles (dict or list) - `team` - Use a predefined team preset - `timeout` - Timeout per agent in seconds (default: 300) ### Specialist Roles Agents can operate with specialist perspectives that shape their analysis: | Role | Description | |------|-------------| | `security` | Security analyst - vulnerabilities, auth, data protection | | `perf` | Performance optimizer - efficiency, caching, scalability | | `skeptic` | Devil's advocate - challenge assumptions, find edge cases | | `architect` | System architect - design patterns, modularity, APIs | | `maintainer` | Code maintainer - readability, testing, tech debt | | `dx` | Developer experience - ergonomics, documentation, errors | | `testing` | Testing specialist - coverage, strategies, edge cases | | `neutral` | No role injection (default) | **Assign roles explicitly:** ``` council_ask prompt="Review this auth flow" roles={"codex": "security", "gemini": "perf"} ``` **Auto-assign from list (in agent order: codex, gemini, opencode, claudeor, aichat):** ``` council_ask prompt="Review this code" roles=["security", "skeptic", "maintainer"] ``` ### Team Presets Predefined role combinations for common scenarios: | Team | Codex | Gemini | OpenCode | ClaudeOR | AiChat | |------|-------|--------|----------|----------|--------| | `security_audit` | security | skeptic | architect | dx | testing | | `code_review` | maintainer | perf | testing | dx | security | | `architecture_review` | architect | perf | maintainer | dx | skeptic | | `devil_advocate` | skeptic | skeptic | skeptic | skeptic | skeptic | | `balanced` | security | perf | maintainer | dx | testing | | `optimal` | maintainer | architect | dx | skeptic | perf | ``` council_ask prompt="Is this design secure?" team="security_audit" ``` ### Individual Agent Sessions | Tool | Description | |------|-------------| | `start_codex_session` | New Codex session | | `resume_codex_session` | Resume with session ID or `--last` | | `start_gemini_session` | New Gemini session | | `resume_gemini_session` | Resume with index or `latest` | | `start_opencode_session` | New OpenCode session | | `resume_opencode_session` | Resume with session ID or `--continue` | | `start_claudeor_session` | New Claude via OpenRouter session | | `resume_claudeor_session` | Resume with session ID or `--continue` | | `start_aichat_session` | New AiChat session | | `resume_aichat_session` | Resume with session name | ### Claude Code Skills Non-blocking slash commands for quick agent invocation: | Skill | Description | |-------|-------------| | `/codex` | Ask Codex a question | | `/gemini` | Ask Gemini a question | | `/council` | Run council deliberation | | `/critique` | Run council in critique mode | ### Async Task Management Council runs in the background. Start a query, keep working, check results later. | Tool | Description | |------|-------------| | `wait_for_task` | Block until task completes | | `get_task_result` | Check result without blocking | | `list_tasks` | List tasks with status filter | | `cancel_task` | Kill running task | ## Configuration | Variable | Default | Description | |----------|---------|-------------| | `COUNCIL_EXCLUDE_AGENTS` | `` | Skip agents (e.g., `opencode,gemini,claudeor`) | | `COUNCIL_DEFAULT_TEAM` | `` | Default team when none specified (empty = neutral) | | `COUNCIL_CLAUDE_OPINION` | `false` | Claude shares its opinion with agents by default | | `OWLEX_DEFAULT_TIMEOUT` | `300` | Timeout in seconds | | `CODEX_BYPASS_APPROVALS` | `false` | Bypass sandbox (use with caution) | | `GEMINI_YOLO_MODE` | `false` | Auto-approve Gemini actions | | `OPENCODE_AGENT` | `plan` | `plan` (read-only) or `build` | | `OPENROUTER_API_KEY` | `` | OpenRouter API key (enables ClaudeOR agent) | | `CLAUDEOR_MODEL` | `` | OpenRouter model for ClaudeOR (e.g., `deepseek/deepseek-v3.2`) | | `AICHAT_MODEL` | `` | Model for AiChat (e.g., `openrouter:minimax/minimax-m2.5`) | ## Cost Notes - **Codex** and **Gemini** use your existing subscriptions (Claude Max, Google AI Pro, etc.) - **OpenCode** and **AiChat** use API tokens (provider-dependent) - Exclude agents with `COUNCIL_EXCLUDE_AGENTS` to control costs - Use council for important decisions, not every question ## When to Use Each Agent | Agent | Strengths | |-------|-----------| | **Codex (gpt5.2-codex)** | Deep reasoning, code review, bug finding | | **Gemini** | 1M context window, multimodal, large codebases | | **OpenCode** | Alternative perspective, configurable models | | **ClaudeOR** | Claude Code + OpenRouter (DeepSeek, GPT-4o, etc.) | | **AiChat** | Multi-provider (20+ backends), bring-your-own-model flexibility | | **Claude** | Complex multi-step implementation, synthesis |

Loading the repository README…

Skills in this repository

Computer Occupations, All Other

1 occupation categories · 100% classified

skill

occupation

description

updated

codex

Computer Occupations, All Other

Start an OpenAI Codex CLI session for deep reasoning and code analysis

2026-01-10

council

Computer Occupations, All Other

Consult the AI council (Codex + Gemini + OpenCode) for multi-perspective answers

2026-01-10

critique

Computer Occupations, All Other

Council critique mode - agents find bugs and flaws in each other's answers

2026-01-10

gemini

Computer Occupations, All Other

Start a Google Gemini CLI session with 1M context for large codebase analysis

2026-01-10

Showing 4 of 4 collected skills.

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/agentic-box/owlex.