No description
  • TypeScript 69.3%
  • JavaScript 30.7%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Andrey Limachko 01f5f27f34
feat(mcp): connect SilverBullet notes server
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>
2026-11-12 23:25:05 +00:00
.opencode feat(skills): update openspec skills for store selection and path-aware JSON 2026-07-03 16:10:37 +04:00
agents feat(agents): add planner agent profile 2026-11-12 18:50:37 +00:00
archive chore: archive unused agents, commands, and office skills 2026-04-04 14:02:55 +04:00
certs feat(providers): add ALT AI gateway provider 2026-11-12 18:50:35 +00:00
commands chore(commands): remove obsolete opsx workflow commands 2026-11-06 02:02:28 +00:00
openspec docs(openspec): update skills path to ~/.agents/skills in skill-synthesis spec 2026-07-25 02:40:57 +04:00
plugins chore(config): remove claude-mem integration 2026-11-09 23:47:44 +00:00
snippet feat(snippets): add AGENTS.md update snippets 2026-11-09 22:43:45 +00:00
.gitignore feat(config): add skill access deny policies 2026-11-07 00:08:23 +00:00
.markdownlint.json chore(config): add markdownlint config and tmp directory permissions 2026-06-01 17:05:46 +04:00
cli.json feat(cli): add CLI v2 user settings 2026-11-04 05:14:33 +04:00
LICENSE docs: add README.md and LICENSE 2026-04-04 17:11:05 +04:00
opencode-mem.jsonc refactor(config): replace Honcho with opencode-mem, clean up plugins 2026-07-21 00:18:33 +04:00
opencode.env refactor(config): replace Honcho with opencode-mem, clean up plugins 2026-07-21 00:18:33 +04:00
opencode.json feat(mcp): connect SilverBullet notes server 2026-11-12 23:25:05 +00:00
PROJECT_REVIEW.md docs: add project review checklist 2026-07-16 22:50:17 +04:00
README.md feat(mcp): connect SilverBullet notes server 2026-11-12 23:25:05 +00:00
TODO.md refactor(config): replace Honcho with opencode-mem, clean up plugins 2026-07-21 00:18:33 +04:00

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)
mail 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