- TypeScript 69.3%
- JavaScript 30.7%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Notes are reachable from any agent; the endpoint authenticates through OAuth, so no token is stored in the config. Generated-by: DeepSeek V4.1 Flash 1017 (DeepSeek) Signed-off-by: Andrey Limachko <liannnix@altlinux.org> |
||
| .opencode | ||
| agents | ||
| archive | ||
| certs | ||
| commands | ||
| openspec | ||
| plugins | ||
| snippet | ||
| .gitignore | ||
| .markdownlint.json | ||
| cli.json | ||
| LICENSE | ||
| opencode-mem.jsonc | ||
| opencode.env | ||
| opencode.json | ||
| PROJECT_REVIEW.md | ||
| README.md | ||
| TODO.md | ||
opencode-conf
Глобальная конфигурация
OpenCode — AI-ассистента для разработки.
Dotfiles-репозиторий, предназначенный для размещения в
~/.config/opencode.
Назначение
Репозиторий хранит:
- Конфигурацию моделей и MCP-серверов (
opencode.json) - Глобальные инструкции для AI-агента (
AGENTS.md) - Навыки (skills) — загружаемые инструкции для специализированных задач (git, почта, Redmine, веб-поиск и др.)
- Slash-команды — пользовательские команды для быстрых workflow
- Плагин интеграции с tuios: состояние агента в панели, Inbox подтверждений
- Локальный плагин quota-limits: лимиты Kimi/GLM и баланс DeepSeek в TUI и веб-интерфейсе
- OpenSpec — систему управления изменениями через proposals, specs и tasks
- Архив неактивных компонентов
Структура
~/.config/opencode/
├── opencode.json # Конфиг: модели, агенты, MCP-серверы, плагины
├── AGENTS.md # Глобальные инструкции для AI-агента
├── .gitignore # Исключения (node_modules, .db, secrets)
├── LICENSE # GPLv3+
├── plugins/
│ ├── tuios-agent-state.js # Интеграция с tuios: состояние агента, Inbox
│ ├── tuios-agent-state/ # Точки входа V1 (server) и V2 (tui)
│ └── quota-limits/ # Лимиты Kimi/GLM и баланс DeepSeek (TUI + Web)
├── agents/ # Глобальные агенты OpenCode V2
│ └── OC-Admin.md # Управление OpenCode и его сессиями
├── commands/ # Slash-команды
│ ├── commit-agent.md # Коммит через subagent (commit-craft)
│ ├── opsx-propose-commit.md # OpenSpec propose + commit
│ ├── opsx-apply-wt.md # OpenSpec apply в worktree
│ └── opsx-archive-commit.md # OpenSpec archive + commit
├── skills/ # Навыки (загружаемые инструкции)
│ ├── commit-craft/ # Атомарные коммиты (fast/auto/interactive)
│ │ └── references/ # atomic-splitting, partial-staging, commit-message
│ ├── git-core/ # Базовые git-правила
│ │ └── references/ # conventions, garbage-patterns, rename-detection
│ ├── worktree-craft/ # Управление git worktree
│ ├── himalaya/ # Работа с почтой (IMAP/SMTP)
│ ├── redmine/ # Redmine через rah CLI
│ ├── web-search/ # Веб-поиск с валидацией источников
│ └── learn/ # Обучение из опыта сессий
├── .opencode/ # Проектные навыки OpenSpec
│ └── skills/
│ ├── openspec-apply-change/
│ ├── openspec-archive-change/
│ ├── openspec-bulk-archive-change/
│ ├── openspec-explore/
│ ├── openspec-propose/
│ ├── openspec-sync-specs/
│ └── openspec-verify-change/
├── openspec/ # Система управления изменениями
│ ├── changes/ # Активные и архивные changes
│ │ └── archive/ # Завершённые changes (9 архивов)
│ └── specs/ # Основные спецификации (13 specs)
└── archive/ # Неактивные компоненты
├── agents/ # 11 архивных агентов
├── commands/ # 5 архивных команд
└── skills/ # 1 архивный навык
Быстрый старт
git clone https://altlinux.space/liannnix/opencode-conf ~/.config/opencode
Для работы MCP-серверов нужны переменные окружения (API-ключи,
пути к бинарникам). См. opencode.json → секция mcp.
Зависимости для плагинов:
bun install # или npm install
Агенты
| Агент | Модель | Назначение |
|---|---|---|
| build | deepseek-v4-flash (default) | Основной кодинг |
| plan | deepseek-v4-flash (default) | Планирование задач |
| general | deepseek-v4-flash (default) | Общие задачи |
| explore | deepseek-v4-flash | Быстрое исследование кодовой базы |
| commiter | deepseek-v4-flash (subagent) | Атомарные коммиты через commit-craft |
| flash | deepseek-v4-flash | Быстрые ответы |
| web | deepseek-v4-flash | Веб-поиск через web-search skill |
| OC-Admin | наследуется (primary) | Управление OpenCode и его сессиями |
Запуск отдельной сессии с администратором OpenCode:
opencode run --agent OC-Admin "Покажи активные сессии"
MCP-серверы
Глобальный конфиг держит все MCP в native V2 (mcp.servers); legacy
mcp.<name> больше не используется. Office-набор из 14 серверов
перенесён из проектного конфига
~/dev/basealt/office/.opencode/opencode.json (сам проектный конфиг
остаётся legacy и не менялся); они доступны всем агентам в любом
каталоге, а не только внутри office. Локальные бинарники собираются
из того же репозитория (каталог mcp/): без него local-серверы не
стартуют.
Office MCP (native V2, mcp.servers)
| Сервер | Тип | Назначение |
|---|---|---|
| alt-rdb | local | База пакетов ALT: версии, связи, CVE |
| bugzilla | remote | Баги bugzilla.altlinux.org |
| forgejo | local | Forgejo altlinux.space: issues, PR, review |
| gitoskop | remote | Git-репозитории пакетов git.altlinux.org |
| hedgedoc | local | Заметки HedgeDoc (hdoc.lian.su) |
| local | Почта: IMAP/SMTP и Sieve (Yandex) | |
| redmine | local | Redmine my.basealt.space, --toolset=full |
| mediawiki-altlinux | local | Публичная вики www.altlinux.org |
| mediawiki-intranet | local | Внутренняя вики intranet.altlinux.ru |
| nextcloud-calendar | local | Календари Nextcloud (CalDAV) |
| nextcloud-contacts | local | Контакты Nextcloud (CardDAV) |
| mattermost | local | Mattermost mm.srt.basealt.ru |
| telegram | remote | Telegram MCP в кластере |
| matrix | local | Matrix через matrix-mcp |
Все 14 включены: в native V2 включённый сервер не имеет disabled.
Локальные бинарники лежат в {env:HOME}/dev/basealt/office/mcp/....
Подстановка {env:HOME} нужна потому, что ~ в command не
раскрывается, а относительные пути вне каталога office не разрешаются.
matrix дополнительно задаёт cwd={env:HOME}/dev/basealt/office:
wrapper scripts/matrix-mcp-run.sh читает .env относительно текущего
каталога.
Remote-серверы bugzilla, deepwiki, gitoskop и telegram задают
oauth: false: bugzilla аутентифицируется статическим header
X-Bugzilla-Api-Key, остальные не требуют авторизации. Так V2 не
начинает лишний OAuth flow.
Переменные окружения (значения хранятся вне git, в ~/.api_keys.env):
ALTLINUX_SPACE_KEY- forgejo, уходит какFORGEJO_ACCESS_TOKEN;BUGZILLA_API_KEY- bugzilla (без ключа доступно только чтение);MAIL_YANDEX_USER,MAIL_YANDEX_PASSWORD- mail, уходят какMAIL_USERиMAIL_PASSWORD;TIMEZONE---timezoneдля mail иNEXTCLOUD_TIMEZONEкалендаря;REDMINE_API_KEY- redmine (REDMINE_URLне обязателен: при заданном--redmine-base-urlфлаг имеет приоритет);MW_INTRANET_USERNAME,MW_INTRANET_PASSWORD- mediawiki-intranet;NEXTCLOUD_URL,NEXTCLOUD_USER,NEXTCLOUD_APP_PASSWORD- оба Nextcloud-сервера;MATTERMOST_TOKEN- mattermost (MATTERMOST_URLзадан в конфиге);MATRIX_ACCESS_TOKEN- только для первичного создания~/.config/matrix-mcp/config.json; сам сервер читает конфиг.
alt-rdb, mediawiki-altlinux и gitoskop credential не нужны.
Прочие MCP
Эти серверы также переведены на native V2 и не входят в office-набор.
| Сервер | Состояние |
|---|---|
| atuin | включён |
| context7 | включён |
| deepwiki | включён |
| opengist | включён |
| playwright | включён |
| silverbullet | OAuth, включён |
| netbox | disabled: true |
| tuios | disabled: true |
| paperless | disabled: true |
| paperless-rag | disabled: true |
CONTEXT7_API_KEY нужен context7, NETBOX_MCP_TOKEN - netbox,
PAPERLESS_MCP_TOKEN и PAPERLESS_RAG_MCP_TOKEN - Paperless. Токен
opengist читается из файла secrets/opengist-token через {file:...}.
SilverBullet (sb.lian.su)
Remote MCP к своему SilverBullet, endpoint https://sb.lian.su/.mcp
(Streamable HTTP). Работает только в multi-space режиме и только при
включённом флаге mcp в /data/server.json (Dashboard -> Admin ->
APIs -> MCP -> Enable MCP; действует без рестарта пода, SB_MCP=0 в
окружении пода выключает MCP целиком и перекрывает Dashboard).
MCP появился в upstream после релиза 2.12.1, поэтому образ собирается
из main (см. images/silverbullet/ в giran-orchestra): тег
main.<sha7>. В 2.12.1 из релиза нет ни маршрута /.mcp, ни раздела
APIs в Admin.
Авторизация - OAuth 2.1 с динамической регистрацией клиента
(/.auth/register, токен - /.auth/mcp/token); API-ключи endpoint не
принимает, поэтому headers не задаются. Первый вход:
opencode mcp auth silverbullet
Нужен браузер, доступный до callback-порта CLI: вход под аккаунтом
Kanidm и согласие на выбранные пространства. Если браузер до
127.0.0.1:<порт> не достаёт (OpenChamber в поде), адрес вида
http://127.0.0.1:<порт>/callback?code=...&state=... копируется из
строки браузера после согласия и запрашивается локально (curl '<адрес>'): CLI слушает тот же порт на машине с opencode и завершает
обмен кода на токен. Гранты видны и отзываются
в Dashboard (Connected apps), локальный токен сбрасывается через
opencode mcp logout silverbullet. Инструменты сервера: help,
read, write, edit, search, плюс lua и screenshot при
включённом Runtime API.
Code Mode и проверка
Code Mode включён для всех серверов (codemode: false нигде не задан):
tools обнаруживаются через search по требованию, полные JSON-схемы
постоянно не загружаются.
opencode mcp list в этом окружении иногда показывает пустой список -
известная аномалия, один её вывод ничего не доказывает. Рабочие способы:
opencode api get /api/mcp # статусы для домашнего каталога
или /mcps в TUI. Для произвольной локации нужен запрос
location[directory], а CLI --param его пока не передаёт: используйте
curl к локальному сервису (порт - opencode service status, пароль -
поле password в service.json).
В ответе API у каждого сервера виден статус connected, disabled
или failed.
Ограничения
uvx-серверы (hedgedoc,mattermost,matrix) не закреплены по версии: обновление пакета меняет код сервера без изменения конфига.- Matrix:
~/.config/matrix-mcp/config.jsonсоздан из access token, E2EE-ключи не импортировались. Старые сообщения в зашифрованных комнатах могут отдаватьdecryption_error«missing room key»; импорт ключей -matrix-mcp e2ee import-keys. - Tools всех 14 серверов доступны любому агенту: permission-изоляция для office-сценария не настраивалась.
- Server instructions и строки Code Mode добавляют постоянный контекст (порядка 2k токенов); без Code Mode полные схемы 440 tools заняли бы десятки тысяч токенов.
Навыки
| Навык | Зависимости | Назначение |
|---|---|---|
| commit-craft | git-core | Атомарные коммиты (3 режима) |
| git-core | — | Базовые git-правила |
| worktree-craft | git-core, commit-craft | Управление git worktree |
| himalaya | himalaya CLI | Работа с почтой (IMAP/SMTP) |
| redmine | rah CLI | Redmine (задачи, wiki, проекты) |
| web-search | web-search-prime, web-reader | Веб-поиск с валидацией |
| learn | — | Обучение из опыта сессий |
OpenSpec
Система управления изменениями через proposals, specs и tasks.
Навыки находятся в .opencode/skills/, данные — в openspec/.
Workflow:
/opsx-propose-commit <name> → propose + commit
/opsx-apply-wt <name> → реализовать в worktree
/opsx-archive-commit <name> → архивировать + commit
9 архивированных changes, 13 основных specs, 3 активных changes.
Плагины
- engram.ts — интеграция с Engram: session tracking, memory injection, proactive save. Сохраняет наблюдения между сессиями в SQLite через локальный HTTP-сервер.
- @franlol/opencode-md-table-formatter — автоформатирование Markdown-таблиц.
- opencode-subagent-statusline — статус субагентов.
- quota-limits — локальный плагин OpenCode V2: окна лимитов Kimi Coding Plan
(CN/Global) и Z.ai GLM Coding Plan, баланс DeepSeek API. В TUI показывает
sidebar, footer и команду
/limits; в Web/Desktop - ComposerPill, панель с подробностями и/limits. Подробности:plugins/quota-limits/README.md. - quota-limits — локальный V2-плагин для Kimi Coding Plan (CN и Global),
Z.ai GLM Coding Plan и баланса DeepSeek API. TUI: sidebar, footer и
/limits; Web/Desktop: ComposerPill, панель с подробностями и/limits. Ключи берутся из env или сохранённых логинов OpenCode, секреты в RPC не передаются. Подробности и сборка:plugins/quota-limits/README.md.
Лицензия
GNU General Public License v3.0 или позднее.
Copyright (c) Andrey Limachko liannnix@altlinux.org