CLI Agent Summoner is a unified Python interface designed as a Skill for the Claude Code Agent. It allows the agent to orchestrate multiple CLI-based AI agents (like Claude Code itself and Gemini CLI) through a single "Summoning Circle".
Instead of juggling different command-line arguments, session ID files, and log formats for each tool, this tool provides a standardized way to:
- Summon different AI backends (
--backend claude,--backend gemini) with a consistent API. - Maintain persistent, human-readable sessions (
.mdfiles) with automatic context resumption. - Inject persona/role templates (
--role detective) to instantly switch the agent's behavior. - Organize conversations into project-specific logs (
agent_sessions/).
It basically turns your terminal into a commander's console for an army of AI agents.
- 🎭 Role Templates: Define
detective.txt,coder.txt,editor.txtand switch personas instantly. - 💾 Semantic Session Management: Sessions are stored as Markdown files. The Agent ID is embedded in the file method, allowing you to read the logs naturally while the tool manages the context connection.
- 🔌 Pluggable Backends: Easily extensible architecture. Comes with
claudeandgeminisupport out of the box. - 🛡️ Safety Protocols: Includes "Trust No One" warnings to remind users to verify AI file operations.
- Python 3.10+
- Claude Code CLI (for
--backend claude) - Gemini CLI (for
--backend gemini) - Linux/macOS environment (recommended)
git clone https://github.com/your-username/cli-agent-summoner.git
cd cli-agent-summoner
chmod +x scripts/unified_agent.py# Talk to Claude
python3 scripts/unified_agent.py "Refactor this code" --backend claude --session-profile refactor_project
# Talk to Gemini
python3 scripts/unified_agent.py "Write a blog post about rust" --backend gemini --session-profile blog_draft- Place a text file in
assets/role_templates/(e.g.,magical_girl.txt). - Summon with
--role:
python3 scripts/unified_agent.py "Help me fix this bug!" --backend claude --role magical_girlscripts/: Core logic and backend adapters.assets/role_templates/: Where your agent personas live.agent_sessions/: (Created on run) Where your conversation logs are stored.
MIT License
CLI Agent Summoner は、Claude Code Agentのためのスキルとして設計された、統合Pythonインターフェースです。これにより、エージェントは単一の「召喚陣」を通じて、複数のCLIベースのAIエージェント（Claude Code自体やGemini CLIなど）を指揮することができます。
ツールごとに異なるコマンドライン引数、セッションIDファイル、ログ形式をジャグリングする代わりに、このツールは以下のための標準化された方法を提供します：
- 召喚（Summon）: 一貫したAPIで、異なるAIバックエンド（
--backend claude,--backend gemini）を呼び出す。 - 維持（Maintain）: 自動的な文脈再開（Resume）機能を備えた、永続的で人間が読めるセッション（
.mdファイル）を維持する。 - 注入（Inject）: ペルソナ/役割テンプレート（
--role detective）を注入し、エージェントの振る舞いを即座に切り替える。 - 整理（Organize）: 会話をプロジェクト固有のログ（
agent_sessions/）に整理する。
基本的には、あなたのターミナルを「AIエージェント軍団のための司令官コンソール」に変えるものです。
- 🎭 ロールテンプレート:
detective.txt,coder.txt,editor.txtなどを定義し、ペルソナを即座に切り替えます。 - 💾 意味論的セッション管理: セッションはMarkdownファイルとして保存されます。エージェントIDはファイルメソッド内に埋め込まれており、ツールが文脈接続を管理している間、人間はログを自然に読むことができます。
- 🔌 プラグ可能（Pluggable）なバックエンド: 簡単に拡張可能なアーキテクチャです。
claudeとgeminiのサポートが標準で付属しています。 - 🛡️ 安全プロトコル: ユーザーにAIのファイル操作を検証するよう促す「Trust No One（誰も信用するな）」警告を含みます。
- Python 3.10以上
- Claude Code CLI (
--backend claude用) - Gemini CLI (
--backend gemini用) - Linux/macOS 環境（推奨）
git clone https://github.com/your-username/cli-agent-summoner.git
cd cli-agent-summoner
chmod +x scripts/unified_agent.py# Claudeと話す
python3 scripts/unified_agent.py "Refactor this code" --backend claude --session-profile refactor_project
# Geminiと話す
python3 scripts/unified_agent.py "Write a blog post about rust" --backend gemini --session-profile blog_draft- テキストファイルを
assets/role_templates/に配置します（例：magical_girl.txt）。 --roleを指定して召喚します：
python3 scripts/unified_agent.py "Help me fix this bug!" --backend claude --role magical_girlscripts/: コアロジックとバックエンドアダプター。assets/role_templates/: エージェントのペルソナが住む場所。agent_sessions/: （実行時に作成）会話ログが保存される場所。
MIT License