qwen-collab
v0.1.4
Published
Linux terminal multiplexer for Qwen Code - multiple AI agent sessions in tmux
Maintainers
Readme
Qwen Collab - Linux Terminal Multiplexer for Qwen Code
Qwen Collab — это инструмент для работы с несколькими сессиями Qwen Code в мини-терминалах на базе tmux. Форк идеи Collaborator, адаптированный для Linux и Qwen Code.
Возможности
- 🖥️ Мини-терминалы: Запуск нескольких сессий Qwen Code в отдельных tmux-панелях
- 🔄 Персистентность: Сессии сохраняются после закрытия и могут быть восстановлены
- 🐧 Linux-native: Работает на любом Linux дистрибутиве с tmux
- 🤖 Qwen Code: Интеграция с открытым AI-агентом Qwen Code
Требования
- Node.js 20+
- tmux 3.0+
- Установленный Qwen Code
Установка
1. Установка зависимостей
# Установка Node.js (если не установлен)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
# Установка tmux
sudo apt-get install -y tmux2. Установка Qwen Code
# Установка Qwen Code через npm
npm install -g @qwen-code/qwen-code@latest
# Или через скрипт установки
bash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)"3. Установка Qwen Collab
# Клонирование репозитория
git clone https://github.com/MisterReds/qwen-collab.git
cd qwen-collab
# Установка зависимостей
npm install
# Сборка
npm run build
# Создание алиаса
echo 'alias qwen-collab="node $(pwd)/dist/cli.js"' >> ~/.bashrc
source ~/.bashrcИли через установщик:
curl -fsSL https://raw.githubusercontent.com/MisterReds/qwen-collab/main/install.sh | bashИспользование
Быстрый старт
# Запуск с одной сессией Qwen Code
qwen-collab start
# Запуск с несколькими сессиями (горизонтальное разделение)
qwen-collab start --sessions 3
# Запуск с вертикальным разделением
qwen-collab start --sessions 2 --layout vertical
# Запуск в существующей рабочей директории
qwen-collab start --cwd /path/to/projectУправление сессиями
# Список активных сессий
qwen-collab list
# Подключение к существующей сессии
qwen-collab attach <session-id>
# Создание новой сессии Qwen Code
qwen-collab new [session-name]
# Закрытие сессии
qwen-collab kill <session-id>
# Закрытие всех сессий
qwen-collab kill-allГорячие клавиши в tmux
| Клавиши | Действие |
|---------|----------|
| Ctrl+b % | Разделить вертикально |
| Ctrl+b " | Разделить горизонтально |
| Ctrl+b <стрелки> | Переключение между панелями |
| Ctrl+b d | Отсоединиться от сессии |
| Ctrl+b x | Закрыть панель |
| Ctrl+b s | Список сессий |
| Ctrl+b $ | Переименовать сессию |
Архитектура
┌─────────────────────────────────────────────────────────┐
│ Qwen Collab CLI │
├─────────────────────────────────────────────────────────┤
│ Session Manager │ Layout Engine │ Config Manager │
└─────────┬─────────┴─────────┬─────────┴─────────┬───────┘
│ │ │
▼ ▼ ▼
┌───────────┐ ┌───────────┐ ┌───────────┐
│ tmux │ │ tmux │ │ tmux │
│ session │ │ session │ │ session │
│ #1 │ │ #2 │ │ #3 │
├───────────┤ ├───────────┤ ├───────────┤
│ Qwen Code │ │ Qwen Code │ │ Qwen Code │
└───────────┘ └───────────┘ └───────────┘Конфигурация
Конфигурационный файл: ~/.qwen-collab/config.json
{
"defaultSessions": 1,
"defaultLayout": "horizontal",
"qwenCodePath": "qwen",
"tmux": {
"prefix": "C-b",
"baseIndex": 1,
"paneBaseIndex": 1
},
"theme": {
"paneBorder": "green",
"paneBorder_style": "thick"
}
}Отличия от Collaborator
| Функция | Collaborator | Qwen Collab | |---------|-------------|-------------| | Платформа | macOS | Linux | | UI | Electron (GUI) | TUI (tmux) | | AI Агент | Cloud Code | Qwen Code | | Установка | .app bundle | npm / CLI | | Canvas | Бесконечный | tmux панели |
Лицензия
FSL-1.1-ALv2 (как оригинальный Collaborator)
Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
