Stigmergy CLI - Multi-Agents Cross-AI CLI Tools Collaboration System [LOCKED VERSION - FOR BACKUP PURPOSES]
npm install stigmergyEnglish: A comprehensive system for seamless collaboration between multiple AI CLI tools. Enables intelligent task routing, cross-CLI communication, and unified skill management.
中文: 多AI命令行工具协作系统,实现智能任务路由、跨CLI通信和统一技能管理。
SEO Keywords: AI CLI, multi-agent collaboration, Claude CLI, Gemini CLI, Qwen CLI, stigmergy, stigmergy gateway, cross-AI orchestration, AI tool manager, command line AI, AI assistant CLI, multi-model AI, AI agents, remote CLI orchestration, AI gateway, chat-to-CLI


- 🤖 Multi-AI CLI Support: Claude, Gemini, Qwen, iFlow, Qoder, CodeBuddy, Copilot, Codex, Kode
- 🎯 Intelligent Task Routing: Automatically selects the best AI tool for your task
- 🧠 ResumeSession Integration: Cross-CLI session recovery and memory sharing (v1.2.1)
- 🔗 Hook System: Seamless integration with all AI CLI tools
- 📦 Agent Skills Manager: Install and manage skills from any GitHub repository
- 🌍 JavaScript-First: No Python dependencies, pure Node.js implementation
- ⚡ Smart Routing: Auto-choose the best tool based on task analysis
- 🌐 12-Language Support: English, Chinese, Japanese, German, French, Spanish, Italian, Russian, Korean, Turkish, Portuguese, Arabic
- 🔄 Cross-CLI Skill Sharing: Skills installed once work across all AI tools
- 🌐 Stigmergy Gateway: Remote CLI orchestration via Feishu, Telegram, Slack, Discord - control AI agents from anywhere
---
Stigmergy Gateway is Stigmergy's remote orchestration feature that lets you control AI CLI tools from chat platforms like Feishu, Telegram, Slack, and Discord. Manage your entire AI team from anywhere!
Stigmergy Gateway transforms Stigmergy into a powerful remote AI orchestration system:
- 📱 Chat-to-CLI Bridge: Send messages on Feishu/Telegram/Slack/Discord → Execute AI CLI commands
- 🌍 Remote Control: Manage AI agents from your phone or web chat
- 👥 Team Collaboration: Share AI capabilities across your team via familiar chat tools
- 🔄 Cross-Platform: Unified interface for 11+ AI CLI tools
| Platform | Status | Use Case |
| ----------------- | -------- | ----------------------------- |
| Feishu (飞书) | ✅ Ready | Team collaboration in China |
| Telegram | ✅ Ready | Global users, bot integration |
| Slack | ✅ Ready | Enterprise teams |
| Discord | ✅ Ready | Developer communities |
``bashStart Gateway with Feishu integration
stigmergy gateway --feishu --port 3000
$3
#### Send Commands via Feishu
`
User: @AI-Stigmergy write a Python REST API
Stigmergy Bot: ✅ Executing with Claude CLI...
[Claude] Created: api.py with REST endpoints
`#### Multi-Agent Task via Telegram
`
User: /concurrent analyze this codebase and generate docs
Stigmergy Bot: 🎯 Routing to Claude, Gemini, Qwen...
[Claude] Analysis complete
[Gemini] Docs generated
[Qwen] Summary: 3 files analyzed
`$3
`bash
Initialize gateway configuration
stigmergy gateway init --feishuCheck gateway status
stigmergy gateway statusStop gateway server
stigmergy gateway stopStart with all platforms
stigmergy gateway --feishu --telegram --slack --discord --tunnel
`$3
When Gateway is running, access:
| Endpoint | Method | Description |
| -------------------- | ------ | ------------------------------- |
|
/status | GET | Server status and platform info |
| /webhook/:platform | POST | Receive messages from platforms |
| /execute | POST | Execute CLI commands remotely |$3
- Token Validation: All incoming webhooks validated
- Command Whitelist: Configurable command restrictions
- Audit Logging: All commands logged for review
- Rate Limiting: Prevent abuse with request limits
$3
`
┌─────────────────────────────────────────────────────────────┐
│ Stigmergy Gateway │
├─────────────────────────────────────────────────────────────┤
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Feishu │ │ Telegram │ │ Slack │ │ Discord │ │
│ └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘ │
│ │ │ │ │ │
│ └────────────┴────────────┴────────────┘ │
│ │ │
│ ┌───────▼───────┐ │
│ │ Message │ │
│ │ Parser │ │
│ └───────┬───────┘ │
│ │ │
│ ┌───────▼───────┐ │
│ │ Command │ │
│ │ Router │ │
│ └───────┬───────┘ │
│ │ │
│ ┌───────────────┼───────────────┐ │
│ │ │ │ │
│ ┌─────▼─────┐ ┌─────▼─────┐ ┌─────▼─────┐ │
│ │ Claude │ │ Gemini │ │ Qwen │ │
│ └───────────┘ └───────────┘ └───────────┘ │
│ ... │
└─────────────────────────────────────────────────────────────┘
`$3
1. Remote Team Management: Control AI agents from chat while commuting
2. Multi-Channel Notifications: AI results delivered to Slack/Discord
3. Voice-to-CLI: Use voice input via Telegram bots
4. API Integration: Build custom workflows with webhook endpoints
5. CI/CD Pipeline: Trigger AI tasks from chat commands
- 🌐 Stigmergy Gateway: Remote CLI orchestration via Feishu, Telegram, Slack, Discord - control AI agents from anywhere
---
📥 Installation
$3
- Node.js: >= 16.0.0 (Download)
- npm: Comes with Node.js
$3
#### Install from npm (Latest Beta)
`bash
Install globally
npm install -g stigmergy@betaOr install specific version
npm install -g stigmergy@1.3.76-beta.0
`#### Windows (PowerShell as Administrator)
`powershell
Method 1: Right-click PowerShell and "Run as Administrator"
npm install -g stigmergy@betaMethod 2: Start PowerShell as Administrator from command line
Start-Process PowerShell -Verb RunAs -ArgumentList "npm install -g stigmergy@beta"
`#### macOS/Linux
`bash
sudo npm install -g stigmergy@beta
`$3
`bash
stigmergy --version
Output: 1.3.54-beta.0
stigmergy --help
`---
🚀 Quick Start Guide
$3
`bash
One-command complete setup
stigmergy setup
`This command will:
- ✅ Scan for available AI CLI tools
- ✅ Deploy integration hooks to all found tools
- ✅ Install built-in skills (ResumeSession)
- ✅ Initialize project configuration
$3
If you prefer manual control:
`bash
Scan for available AI CLI tools
stigmergy scanInstall CLI tools (optional - if you want Stigmergy to install them)
stigmergy installDeploy hooks to enable cross-CLI communication
stigmergy deploy hooksInitialize project for session recovery
stigmergy initStart Stigmergy Gateway for remote orchestration
stigmergy gateway --feishu --port 3000
`$3
`bash
Check status of all AI CLI tools
stigmergy statusExpected output:
✓ Claude CLI: installed
✓ Gemini CLI: not installed
✓ Qwen CLI: installed
...
`---
💡 Basic Usage
$3
`bash
Use specific AI tool
stigmergy claude "write a Python function to calculate fibonacci"
stigmergy gemini "translate this text to Japanese"
stigmergy qwen "analyze this code for security issues"
stigmergy kode "use digital marxist agent to analyze worker alienation"Remote orchestration via Stigmergy Gateway
stigmergy gateway --feishu --tunnel # Control AI from Feishu
stigmergy gateway --telegram --port 3000 # Control AI from Telegram
`$3
`bash
Let Stigmergy choose the best tool automatically
stigmergy call "create a modern React component with TypeScript"
stigmergy call "analyze this database schema"
stigmergy call "write a bash script for file backup"
`$3
`bash
Chinese
stigmergy call "请用 kode 帮我分析这个代码"Japanese
stigmergy call "kodeを使ってこのコードを分析してください"German
stigmergy call "analysiere diesen Code mit Kode"And 8 more languages...
`---
📦 Agent Skills Management
Stigmergy includes a powerful skill manager compatible with all agent skill repositories (Vercel, Anthropic, etc.).
$3
`bash
Vercel AI Skills
stigmergy skill install vercel-labs/agent-skillsAnthropic Claude Skills
stigmergy skill install anthropics/skillsAny GitHub repository
stigmergy skill install owner/repoWith specific path or branch
stigmergy skill install owner/repo@main/skills/pdf
`$3
`bash
List all installed skills
stigmergy skill listRead skill content (for AI agents)
stigmergy skill read pdfRemove a skill
stigmergy skill remove pdfValidate skill format
stigmergy skill validate ./my-skill/SKILL.mdSync skills to AGENTS.md
stigmergy skill sync
`$3
#### In Claude Code
`javascript
// Read skill content
Bash("stigmergy skill read algorithmic-art")// Use skill
claude> Use the algorithmic-art skill to create generative art
`#### Cross-CLI Skill Sharing
Skills installed with Stigmergy are automatically available across all AI CLI tools:
`bash
Install once in Claude
stigmergy skill install vercel-labs/agent-skillsUse in any CLI
claude> stigmergy skill read pdfqwen> "使用 Claude 的 PDF 技能处理这个文档"
gemini> "analyze this PDF using claude's pdf skill"
`$3
Stigmergy intelligently parses 7+ GitHub URL formats:
-
owner/repo - Shorthand
- https://github.com/owner/repo - Full repository URL
- https://github.com/owner/repo/blob/branch/path - Blob URL
- https://raw.githubusercontent.com/... - Raw URL
- owner/repo/path/to/file - With path
- owner/repo@branch/path - With branch
- And more...---
🆕 What's New in v1.3.76-beta.0
$3
- 🎯 Project Status Board: Persistent state management for cross-session collaboration
- 📊 Interactive Mode Integration: Status-driven collaboration with automatic context injection
- 🔄 Hierarchical Status Boards: Support for single and multi-board modes
- 🌳 Directory Isolation: Each project directory has independent status board
- 🧠 ResumeSession v1.2.1: Advanced session recovery with cross-CLI memory
- 📦 Unified Skill Manager: Compatible with all agent skill repositories
$3
- 🛠️ Automated installation and configuration management
- 📊 Enhanced status checking and reporting
- 🔗 Improved hook deployment system
- 🧪 Better test coverage and reliability
- 🌐 Multi-Language Patterns: Improved support for 12 languages
---
📚 Advanced Usage
$3
Stigmergy's interactive mode features a Project Status Board that enables cross-session collaboration through persistent shared state. Different CLI sessions automatically collaborate based on the project status, with automatic context injection.
`bash
Start interactive session
stigmergy interactive
or use the alias
stigmergy i
`Once in interactive mode, you can use these commands:
#### Interactive Commands
`bash
View project status board
> status
Shows: tasks, findings, decisions, collaboration history
Show cross-CLI context
> context
Displays context from all CLI tools
Switch to specific CLI
> use qwen
> use claude
> use iflow
> use geminiExecute task with automatic context injection
> your task hereExit interactive mode
> exit
`#### Key Features
📊 Project Status Board
- Each project directory has its own independent status board
- Stored in
.stigmergy/status/PROJECT_STATUS.md
- Tracks tasks, findings, decisions, and collaboration history
- Automatically updates as you work🔄 Cross-Session Collaboration
- Different sessions read/write to the same status board
- Automatic context injection from previous work
- Shared memory across CLI tools and sessions
🌳 Directory Isolation
- Each project directory = independent status board
- Working in
/projectA won't affect /projectB
- Subdirectories can have independent boards (optional)Example Session:
`bash
$ stigmergy interactive========================================
Stigmergy Interactive Mode
========================================
Session ID: session-abc123
Use 'status' to view project state
Use 'help' for available commands
View current status
> status
========================================
项目全局状态看板
========================================📋 任务统计:
待处理: 5
进行中: 2
已完成: 10
💡 发现: 8条
🎯 决策: 3条
🤝 协作记录: 25条
========================================
Switch to qwen CLI
> use qwen
[qwen] Switched to qwen CLIWork on a task (context auto-injected)
> design user authentication system
[qwen] Executing task...
[qwen] Context: 8 findings, 3 decisions loaded
[qwen] Response received in 2.3sRecord finding manually
> finding: Using JWT for stateless authentication
✓ Finding recorded to status boardMake decision
> decision: Use PostgreSQL as primary database
✓ Decision recorded to status boardExit
> exit
[POOL] Shutting down persistent CLI processes...
✓ Session saved to status board
`#### Single vs Multi-Board Mode
Single Board Mode (Default)
- Best for small projects (< 10 modules)
- One status board for entire project
- Simple, unified perspective
`bash
cd my-small-project/
stigmergy i
> All work recorded to: .stigmergy/status/PROJECT_STATUS.md
`Multi-Board Mode (Optional)
- Best for large projects or microservices
- Each subdirectory has independent board
- Enables parallel team development
`bash
cd my-large-project/
stigmergy i
> board init multi
> board create backend ./backend
> board create frontend ./frontendcd backend/
stigmergy i
> use qwen
qwen> design database schema
✓ Recorded to: backend/.stigmergy/status/PROJECT_STATUS.md
`Directory Isolation Guaranteed:
`
projectA/.stigmergy/status/PROJECT_STATUS.md ← Project A's board
projectB/.stigmergy/status/PROJECT_STATUS.md ← Project B's board
Complete isolation, no mixing
`$3
`bash
List recent sessions
stigmergy resume --limit 10Resume specific session
stigmergy resume --session-id abc123Simple resume
stigmergy resume
`$3
`bash
Setup project
stigmergy setupInitialize in current directory
stigmergy initDeploy hooks only
stigmergy deploy hooksDeploy skills integration
stigmergy deploy skills
`---
🔧 Configuration
$3
Stigmergy searches for skills in the following locations (priority order):
1.
~/.stigmergy/skills/ - Stigmergy unified storage
2. ./.agent/skills/ - Project universal skills
3. ~/.agent/skills/ - Global universal skills
4. ./.claude/skills/ - Project Claude skills
5. ~/.claude/skills/ - Global Claude skills$3
`bash
Enable debug mode
export DEBUG=trueForce auto-install during npm install
export STIGMERGY_AUTO_INSTALL=true
`---
🐛 Troubleshooting
$3
Windows:
`powershell
npm install -g stigmergy@beta --force
`macOS/Linux:
`bash
sudo npm install -g stigmergy@beta --unsafe-perm=true --allow-root
`$3
`bash
Check which tools are installed
stigmergy scanInstall specific tool
stigmergy install claudeOr manually install AI CLI tools first:
npm install -g @anthropic-ai/claude-code
npm install -g @google/gemini-cli
etc.
`$3
`bash
Redeploy hooks
stigmergy deploy hooks --forceCheck hook status
stigmergy status
`$3
`bash
Gateway not starting
stigmergy gateway --feishu --verboseCheck port availability
netstat -ano | findstr :3000Verify ngrok tunnel
stigmergy gateway --feishu --tunnel --verbose
`$3
`bash
Validate skill format
stigmergy skill validate ./my-skill/SKILL.mdReinstall skill
stigmergy skill install owner/repo --forceCheck skill list
stigmergy skill list
`---
📖 Documentation
- Main Documentation - Complete system documentation
- Publishing Guide - How to publish to npm
- Package Size Analysis - Optimization details
- Agent Skills Comparison - Why not use add-skill
---
🤝 Contributing
Contributions are welcome! This project is a collaboration between multiple AI systems:
- Claude (Anthropic)
- Qwen (Alibaba)
- iFlow (Intelligent Workflow)
- QoderCLI
- GLM4.5 (Zhipu AI)
- Gemini (Google)
- And other AI systems
$3
`bash
Clone repository
git clone https://github.com/ptreezh/stigmergy-CLI-Multi-Agents.gitInstall dependencies
npm installBuild TypeScript orchestration layer
npm run build:orchestrationRun tests
npm testLint code
npm run lint
``---
MIT License - see LICENSE for details
---
If you find this project useful, please consider giving it a ⭐ on GitHub!
---
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- npm: npm Package
---
Made with ❤️ by the Stigmergy CLI Team and AI collaborators
_Version: 1.3.54-beta.0 | Published: 2026-01-17_