mcp server
opencode-setup
Настройка рабочей среды opencode (Sisyphus): конфиги, MCP-серверы, скиллы, сервис обслуживания. Персональный setup-репозиторий.
Set up
Runs on your computer. Pick your agent and operating system.
This project does not publish an install method we can turn into a config. Follow the README instead.
README
synced Oct 27, 2026OpenCode Setup — автонастройка рабочего места агента
Приватный репозиторий-«самонастройка»: после чистой установки opencode на любом Mac этот репозиторий с одной командой восстанавливает всю рабочую конфигурацию: профиль я (Sisyphus), MCP-серверы, скиллы, обслуживание базы, правила поведения.
Язык общения с пользователем — русский. Всё в этом README — на русском.
Что восстанавливается
| Компонент | Откуда | Что именно |
|---|---|---|
| Правила и профиль агента | config/AGENTS.md | язык, идентичность Sisyphus, профиль пользователя, политика данных |
| Конфиг opencode | config/opencode.jsonc | провайдеры, плагин oh-my-openagent@latest, MCP-серверы |
| Агенты (Sisyphus и др.) | config/oh-my-openagent.json | модели и fallback для 11 агентов + категорий |
| MCP: playwright, memory, filesystem | config/package.json | локальные бинарники (без медленного npx) |
| Скиллы (28 шт) | публичный agent-skills | code-review, frontend-perfection, seo-toolkit и др. |
| Обслуживание базы | maintenance/ | чистка старых чатов (3 дня), WAL, VACUUM, ротация лога — через launchd |
| Прочее | config/tui.json, lsp-install-decisions.json | TUI, решения по LSP-серверам |
Установка с нуля (пошагово)
Шаг 0. Предпосылки (один раз)
- macOS, рабочий терминал (zsh).
- Установить GitHub CLI и Node:
Homebrew, если его нет:brew install gh node/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Шаг 1. Установить opencode
Официальный способ (CLI + desktop):
curl -fsSL https://opencode.ai/install | bash
Desktop-приложение: https://opencode.ai/download (используется как основная среда).
Проверка: opencode --version.
Шаг 2. Авторизация GitHub
gh auth login # аккаунт bestdeejay-design, протокол HTTPS
gh auth status # должно показать Logged in
Доступ к GitHub работает через gh CLI — MCP-сервер github не нужен.
Шаг 3. Клонировать этот репозиторий
mkdir -p ~/Projects
git clone https://github.com/bestdeejay-design/opencode-setup ~/Projects/opencode-setup
Шаг 4. Запустить установку
bash ~/Projects/opencode-setup/setup.sh
Что сделает скрипт (всё с бэкапами существующих файлов):
- разложит конфиги в
~/.config/opencode/; - установит MCP-пакеты (playwright, memory, filesystem) локально в
~/.config/opencode/node_modulesи браузер chromium; - склонирует скиллы из
bestdeejay-design/agent-skills(лежат в~/.config/opencode/skills) и поставит их зависимости; - скопирует сервис обслуживания базы в
~/.local/share/opencode/и зарегистрирует в launchd; - покажет проверки (gh, node, MCP-бинарки);
- доустановит отдельные инструменты:
sqz(сжатие контекста, brew) иserena(навигация по коду, uv).
Шаг 5. Перезапустить OpenCode
MCP-серверы читаются при старте — после перезапуска в чате появится полный арсенал.
Шаг 6. Проверка агентом (рекомендуется)
В новом чате opencode написать:
настрой всё по репозиторию opencode-setup
Агент сам проверит: gh auth status, наличие MCP-бинарков, launchctl list | grep opencode-maintenance,
размер базы ~/.local/share/opencode/opencode.db, целостность (PRAGMA quick_check).
Что получается в итоге (карта рабочего места)
- Чаты живут 3 дня неактивности, потом удаляются автоматически (политика пользователя: всё важное сохраняется в GitHub-доки, чаты — летучие).
- База
~/.local/share/opencode/opencode.dbчистится каждые 6 часов бодрствования- при логине; VACUUM выполняется, когда OpenCode закрыт. Лог работы:
~/.local/share/opencode/maintenance.log.
- при логине; VACUUM выполняется, когда OpenCode закрыт. Лог работы:
- MCP-серверы:
sqz(сжатие контекста),playwright(браузер),memory(граф знаний — пуст, по запросу),filesystem(файлы вне workspace: OneDrive, Projects),context7(доки библиотек),serena,codegraph. - Отключены (по скорости):
github(есть gh),sequential-thinking,filesystemбыл возвращён локально.
Как обновлять
- Скиллы:
git -C ~/Projects/agent-skills pull(или перезапуститьsetup.sh— он переустановит, если папки скиллов нет). - Конфиг: правите файлы в
~/Projects/opencode-setup, коммитите и пушите — репозиторий и есть источник правды:cd ~/Projects/opencode-setup && git add -A && git commit -m "feat: ..." && git push - Порог хранения чатов:
RETENTION_DAYSв~/.local/share/opencode/maintenance.sh.
Полезные ссылки
- Документация opencode: https://opencode.ai/docs
- Скиллы: https://github.com/bestdeejay-design/agent-skills
- Плагин агентов:
oh-my-openagent@latest(Sisyphus и команда агентов) - Проблемы и решения: docs/TROUBLESHOOTING.md