Усі налаштування

Усі параметри в просторі імен devManager.*.

Редагування:

Ctrl+, → пошук @ext:vaulttec-dev.snakeflow-dev-manager
Або .vscode/settings.json (workspace, окремо для кожного проєкту)

Примітка: Quality Hub реєструє понад 90 провайдерів і сотні ключів devManager.quality.<providerId>.*. Таблиці нижче — репрезентативні приклади за категоріями. Повний актуальний перелік переглядайте в Налаштуваннях IDE: Ctrl+, → пошук devManager.quality. — біля кожного ключа є вбудований опис.

Проєкт

Параметр	Тип	За замовчуванням	Опис
`devManager.project.name`	string	auto	Ідентифікатор проєкту
`devManager.project.dir`	string	auto	Абсолютний шлях до кореня
`devManager.project.packageManager`	enum	`"auto"`	`auto` \| `npm` \| `pnpm` \| `yarn` \| `bun`
`devManager.project.servers`	array	`[]`	Dev-сервери — /uk/features/servers/
`devManager.project.composePath`	string	`""`	Шлях до Compose (порожньо = авто)
`devManager.project.containerActions`	array	auto	Меню контейнерів

Поля запису `devManager.project.servers[]`

Поле	Обов’язкове	За замовч.	Опис
`id`	так	—	Унікальний id (префікс імені терміналу)
`label`	так	—	Назва в меню серверів
`command`	так	—	Shell-команда в іменованому терміналі
`path`	ні	`""`	Робоча директорія відносно кореня проєкту
`port`	ні	`0`	TCP-порт для статусу (`0` = лише термінал)
`startWithAll`	ні	`true`	`false` — не входить у `Ctrl+Alt+S`; запуск з меню status bar

Git і GitHub

Параметр	Тип	За замовчуванням	Опис
`devManager.git.defaultBranch`	string	`"main"`	Fallback назви гілки
`devManager.git.protectedBranches`	string[]	`["main","master","develop","staging","production"]`	Підтвердження перед видаленням
`devManager.git.statusBar.debugLog`	boolean	`false`	Детальні логи оновлення Git status bar (Output channel)
`devManager.prToChat.prompt`	string	`""`	Промпт для PR у чат
`devManager.issueToChat.prompt`	string	`""`	Промпт для Issue у чат
`devManager.github.sprints.enabled`	boolean	`false`	Спринти на базі GitHub Milestones. Див. GitHub Sprints.
`devManager.github.sprints.namingHint`	string	`""`	Підказка імені нового спринту.

SnakeFlow Cloud

Параметр	Тип	За замовчуванням	Опис
`devManager.cloud.apiUrl`	string	`https://snakeflow-api.pro-connect.workers.dev`	REST API (HTTPS). Self-hosted Workers.
`devManager.cloud.dashboardUrl`	string	`https://snakeflow-cloud.pages.dev`	Веб-dashboard.
`devManager.cloud.repoOverride`	string	`""`	Примусово `owner/repo`, якщо remote не GitHub.

Детальніше: Синхронізація налаштувань у хмарі → — команди та приватність.

Team Tracker

Параметр	Тип	За замовчуванням	Опис
`devManager.team.enabled`	boolean	`false`	Увімкнено — облік активних хвилин за UTC-добу та відправка в team API після входу.
`devManager.team.activeAppSource`	string	`"native"`	Джерело активної програми: `native` (за замовчуванням) або `off`. Див. Джерела активності.
`devManager.team.idleWindowMinutes`	number	`5`	Заявлене вікно в Settings (1–15). Collector обмежує ефективне вікно 2 хв (мін. 1). З membership — мінімум серверного `idle_window_minutes`. Без membership — 2 хв. Див. Team Tracker.
`devManager.team.dayGoalMinutes`	number	`360`	Цільові хвилини для progress bar у tooltip статус-бару (за замовч. 6 год). Лише візуалізація. Див. Ціль дня.
`devManager.team.requireTracking`	boolean	`false`	Якщо true — попередження, коли трекінг вимкнено і сесію не запущено.
`devManager.team.idleSleepWindow`	string	`""`	Локальний інтервал `HH:MM-HH:MM`, у якому collector примусово IDLE. Порожньо = вимкнено. Див. Інтервал сну.

Allowlist програм (regex по назві вікна / app) — це не параметр devManager.*: адмін workspace налаштовує на сервері (вкладка Cloud Team або команда SnakeFlow: Team Tracker — Edit App Allowlist). Детальніше: Team Tracker → — джерела активності, інтервал сну, internal/external, лог.

Docker і CI

Параметр	Тип	За замовчуванням	Опис
`devManager.docker.composeCommand`	string	`"docker compose"`	CLI Compose
`devManager.terminal.shellPath`	string	`""`	Оболонка для керованих терміналів (сервери, Docker, скрипти). Порожнє = авто: login-shell на macOS/Linux (PATH як у Cursor); дефолт IDE на Windows
`devManager.terminal.shellArgs`	string[]	`["-l"]`	Аргументи оболонки керованих терміналів на macOS/Linux (login-shell читає `~/.profile`). На Windows ігнорується
`devManager.ci.workflowsPath`	string	`".github/workflows"`	Шлях до workflow GitHub Actions

AI (Gemini + Dictation)

Параметр	Тип	За замовчуванням	Опис
`devManager.gemini.apiKey`	string	`""`	Ключ Google Gemini для заголовків issues та голосового введення
`devManager.gemini.model`	string	`"gemini-2.5-flash"`	Назва моделі
`devManager.gemini.dictationLanguage`	enum	`"auto"`	Мова для транскрибації голосового введення. `auto` = Gemini визначає автоматично. Варіанти: `uk`, `en`, `de`, `fr`, `es`, `pl`, `it`, `pt`, `nl`, `cs`, `ja`, `zh`, `ko`

Детальніше: Голосове введення →

Логування

Параметр	Тип	За замовчуванням	Опис
`devManager.log.verbose.team`	boolean	`false`	Записувати кожен tick Team Tracker (IDLE/ACTIVE/SKIP) у output channel SnakeFlow.
`devManager.log.verbose.quality`	boolean	`true`	Записувати start/finish кожного провайдера Quality Hub під час повних прогонів.

Agent Quality Loop

File IPC для AI-агентів — запуск повторних прогонів Quality Hub. За замовчуванням файл-тригер і launcher-скрипти trigger-quality лежать у глобальному каталозі — ~/.snakeflow/ipc/<encoded-project>/trigger-run.json (шлях проєкту, де кожен не-алфавітно-цифровий символ замінено на -; враховує $SNAKEFLOW_CONFIG_DIR) — тож у проєкт нічого не пишеться, а .gitignore не змінюється. Старе in-project розташування теж завжди відстежується, тому старіші агенти продовжують працювати.

Параметр	Тип	За замовчуванням	Опис
`devManager.quality.agentLoop.enabled`	boolean	`true`	Стежити за IPC-файлом `trigger-run.json` та запускати Quality Hub для агентів. Вимкнути — зупинити watcher.
`devManager.quality.agentLoop.location`	string	`"global"`	Де лежать IPC-файли: `global` (`~/.snakeflow/ipc/…`, поза репозиторієм) або `project` (у каталозі `dir`, додається до `.gitignore`).
`devManager.quality.agentLoop.dir`	string	`".snakeflow"`	Каталог відносно workspace для IPC-файлів. Діє лише коли `location` = `project`.

AI Usage

Індикатори лімітів підписок Claude Code і Cursor у status bar.

Параметр	Тип	За замовчуванням	Опис
`devManager.aiUsage.enabled`	boolean	`true`	Головний перемикач індикаторів AI usage у status bar.
`devManager.aiUsage.claude.enabled`	boolean	`true`	Індикатор Claude Code (OAuth-токен з `~/.claude/.credentials.json`).
`devManager.aiUsage.cursor.enabled`	boolean	`true`	Індикатор Cursor (лише всередині Cursor).
`devManager.aiUsage.claude.refreshIntervalSec`	number	`600`	Інтервал опитування Anthropic (сек, мін. 60).
`devManager.aiUsage.cursor.refreshIntervalSec`	number	`300`	Інтервал оновлення Cursor usage (сек, мін. 60).
`devManager.aiUsage.cursor.sessionToken`	string	`""`	Ручний fallback session token Cursor, якщо auto-extraction через `sqlite3` недоступна. User settings.
`devManager.aiUsage.segments`	number	`10`	Кількість сегментів у progress bar status bar (4–20).

Quality Hub — загальне

Параметр	Тип	За замовчуванням	Опис
`devManager.quality.customChecks`	array	`[]`	Кастомні перевірки
`devManager.quality.skipDirs`	string[]	`[]`	Додаткові назви папок (не glob), що додаються до вбудованих виключень
`devManager.quality.skipFiles`	string[]	`[]`	Відносні шляхи від кореня проєкту (слеші `/`), шаблони на кшталт `.vsix` або `*/file.ext` — для багатьох built-in і агрегації Semgrep
`devManager.quality.timeout`	number	`30`	Макс. час перевірки (хв)
`devManager.quality.maxBuffer`	number	`50`	Макс. stdout (МБ)
`devManager.quality.chatReport`	enum	`"onFail"`	`auto` \| `onFail` \| `manual` \| `never` — коли відкривати чат зі звітом після прогону
`devManager.quality.chatPrompt`	string	`""`	Текст на початку звіту в чат

Quality Hub — вбудовані перевірки

Замість <check> — назва перевірки. Спільне:

Параметр	Тип	За замовчуванням
`devManager.quality.builtin.<check>.enabled`	boolean	`true`

Приклади порогів:

"devManager.quality.builtin.lineCount.warnLines": 300,
"devManager.quality.builtin.lineCount.failLines": 500,

"devManager.quality.builtin.functionLength.warnLines": 40,
"devManager.quality.builtin.functionLength.failLines": 80,

"devManager.quality.builtin.complexity.warnScore": 10,
"devManager.quality.builtin.complexity.failScore": 20,

"devManager.quality.builtin.fileSize.warnKb": 50,
"devManager.quality.builtin.fileSize.failKb": 200,

"devManager.quality.builtin.importDepth.warnDepth": 4,
"devManager.quality.builtin.importDepth.failDepth": 6,

"devManager.quality.builtin.dependencyCount.warnAt": 50,
"devManager.quality.builtin.dependencyCount.failAt": 100,

"devManager.quality.builtin.parameterCount.warnAt": 4,
"devManager.quality.builtin.parameterCount.failAt": 7,

"devManager.quality.builtin.jscpd.threshold": 5,
"devManager.quality.builtin.jscpd.minLines": 5,

"devManager.quality.builtin.trivy.failOnSeverity": "HIGH",
"devManager.quality.builtin.trivy.warnOnSeverity": "MEDIUM",
"devManager.quality.builtin.trivy.path": "trivy",

"devManager.quality.builtin.golangciLint.warnAt": 5,
"devManager.quality.builtin.golangciLint.failAt": 20,
"devManager.quality.builtin.golangciLint.path": "golangci-lint",

"devManager.quality.builtin.bandit.path": "bandit",
"devManager.quality.builtin.bearer.path": "bearer",

"devManager.quality.builtin.returnTypes.warnAt": 10,
"devManager.quality.builtin.returnTypes.failAt": 50,

"devManager.quality.builtin.noManualMigrations.enabled": true,
"devManager.quality.builtin.noManualMigrations.severity": "error",
"devManager.quality.builtin.noManualMigrations.adapters": ["drizzle", "prisma", "atlas"],
"devManager.quality.builtin.noManualMigrations.checkRemoved": true,
"devManager.quality.builtin.noManualMigrations.gitLookback": 50,

"devManager.quality.builtin.prismaMigrateStatus.realtime": true,

"devManager.quality.builtin.squawk.dataRisk": "warn",
"devManager.quality.builtin.squawk.requireDownMigration": false,

"devManager.quality.builtin.migrationsCiGate.enabled": true,

"devManager.quality.semgrep.config": "auto"

Назви вбудованих перевірок:

lineCount · functionLength · complexity · fileSize · longLines · importDepth · directoryDepth · dependencyCount · todoCount · commentedCode · duplicateFiles · testRatio · mixedIndent · encoding · secretLeaks · gitleaks · debugLeaks · gitignoreCheck · magicNumbers · parameterCount · barrelFiles · couplingMetrics · componentInventory · heavyImports · anyCoverage · jsdocCoverage · lcovCoverage · actionsAudit · emptyTests · jscpd · knip · dependencyCruiser · pkgAudit · outdatedDeps · licenseCheck · hadolint · shellcheck · golangciLint · bearer · stryker · trivy · bandit · semgrep · act · envConsistency · lockfileSync · nodeVersionConsistency · readmeCheck · changelogCheck · codeownersCheck · tscCheck · asyncAwaitMisuse · errorHandling · returnTypes · reactHookRules · a11yCheck · yamllint · spectral · checkov · sqlfluff · markdownlint · attw · publint · lockfileLint · npmProvenance · syncpack · manypkg · scorecard · typeCoverage · commitlint · noFocusedTests · noManualMigrations · migrationsCiGate · stylelint · prettierCheck · sizeLimit · lighthouseCi · oasdiff · graphqlInspector · bufBreaking · dockle · grype · dive · hardenRunnerAudit · sbom · sentrySourcemaps · trojanSource · rlsCheck · pgtapPresence · sqruff · vale · alex · lychee · promptfoo · dotenvLinter

Профіль якості — devManager.quality.profile (strict | balanced | vibe, за замовчуванням strict) керує тим, які перевірки типово запускаються. strict — максимальний набір (усі ввімкнені, warning трактується як fail). balanced — той самий набір увімкнень, але warning лишається warning. vibe — за замовчуванням лише «сильні» CLI-інструменти. Параметри enabled у конкретного провайдера завжди мають пріоритет. Див. також devManager.quality.warnAsFail — накладання «підвищення» warning до fail.

Realtime Quality

Додаткові у редакторі повторні прогоні для провайдерів із realtime-хуками.

Параметр	Тип	За замовчуванням	Опис
`devManager.realtime.enabled`	boolean	`false`	Головний вимикач.
`devManager.realtime.onType.enabled`	boolean	`true`	Повтор після введення тексту.
`devManager.realtime.onSave.enabled`	boolean	`true`	Повтор після збереження.
`devManager.realtime.statusBar.enabled`	boolean	`true`	Лічильники Lint / Types / Secrets у status bar.

No Manual Migrations, Prisma Migrate Status (watch) і подібні перевірки можуть оновлювати діагностику при змінах файлів схеми/міграцій, якщо ввімкнено і перевірку, і realtime. Див. No Manual Migrations →.

Область дії перевірки: Hub / Реалтайм

Кожен провайдер якості має два незалежні рубильники. Їх можна комбінувати довільно — наприклад, залишити перевірку у Quality Hub, але вимкнути live-підкреслення.

Рубильник	Ключ налаштування	За замовч.	Ефект
Hub (Quality Hub, `Ctrl+Alt+F`)	`devManager.quality.builtin.<id>.enabled`	`true`	Включає / виключає перевірку з пакетного запуску
Реалтайм (live-діагностика)	`devManager.quality.builtin.<id>.realtime`	`true`	Вмикає підкреслення при наборі / збереженні

Примітка: вбудований pre-commit git gate у SnakeFlow прибрано. Для блокування комітів використовуйте власний менеджер git-hooks (Husky, lefthook тощо) або CI. Див. Кастомні перевірки →.

Workflows

AI-керовані сценарії (власні багатокрокові прогони з бічної панелі).

Параметр	Тип	За замовчуванням	Опис
`devManager.workflows.aiProvider`	string	`"claude"`	AI backend для кроків workflow (`claude` або `gemini`)
`devManager.workflows.anthropicApiKey`	string	`""`	Ключ Anthropic для кроків AI у workflow
`devManager.workflows.claudeModel`	string	`"sonnet"`	Модель Claude для AI-кроків (підтягується з API)
`devManager.workflows.claudePath`	string	`""`	Шлях до бінарника `claude` CLI (порожньо = auto)
`devManager.workflows.timeoutMinutes`	number	`60`	Макс. тривалість одного прогону workflow (хв; `0` = без обмеження)
`devManager.workflows.maxCostUsd`	number	`5`	Макс. витрати на AI (USD) за прогон до зупинки
`devManager.workflows.watchdogSeconds`	number	`90`	Секунд тиші, після яких крок вважається завислим
`devManager.workflows.useApiKey`	boolean	`false`	Автентифікація HTTP-запитів workflow за API-ключем проєкту
`devManager.workflows.custom`	array	`[]`	Власні визначення workflow

Wake Lock

Блокує сон ОС під час активності в редакторі та за потреби під час Quality Hub. Не залежить від обліку хвилин у Team Tracker →. Детально: Wake Lock →.

Параметр	Тип	За замовчуванням	Опис
`devManager.wakeLock.enabled`	boolean	`true`	Головний перемикач. `false` — і трекер активності в статус-барі, і авто Quality Hub не отримують лок.
`devManager.wakeLock.autoActivate`	boolean	`true`	Автоматично тримати wake lock на час повного прогону Quality Hub (`acquire('Quality Hub')`), незалежно від перемикача в статус-барі.
`devManager.wakeLock.keepDisplayAwake`	boolean	`true`	Тримати дисплей увімкненим (`ES_DISPLAY_REQUIRED` у Windows; на частині Linux дисплей може все одно гаснути).
`devManager.wakeLock.idleThresholdSeconds`	number	`120`	При перемикачі ON — секунд без сигналів активності перед звільненням активнісного лока (довгограючі task самі по собі не «якорять» лок).
`devManager.wakeLock.readyTimeoutMs`	number	`0`	Очікування готовності helper (`0` = дефолт платформи).
`devManager.wakeLock.startRetries`	number	`2`	Повторні спроби запуску helper.
`devManager.wakeLock.maxHoldHours`	number	`4`	Якщо `refCount` лишається більше нуля безперервно стільки годин — попередження в лог і notification (`0` = вимкнено). Без примусового release.
`devManager.wakeLock.persistLog`	boolean	`false`	Дублювати рядки каналу Wake Lock у `<workspace>/.vscode/snakeflow-wakelock.log` або `<workspace>/.cursor/snakeflow-wakelock.log` (ротація 1 МБ). Потрібна відкрита папка workspace.

Команди: SnakeFlow: Wake Lock — Toggle / SnakeFlow: Wake Lock — Diagnose (довідник команд →).

Контекст агента

Керування контекстом для AI-агента та стандартні промпти для чату.

Параметр	Тип	За замовчуванням	Опис
`devManager.agentContext.structureSync.enabled`	boolean	`true`	Автогенерація знімка структури проєкту для AI-контексту
`devManager.agentContext.structureSync.autoSync`	boolean	`false`	Авто-оновлення блоку в `AGENTS.md` (вимкнено за замовч., щоб не блокувати `git pull`).
`devManager.prToChat.prompt`	string	`""`	Промпт на початку при відправці diff PR у чат AI
`devManager.issueToChat.prompt`	string	`""`	Промпт на початку при відправці GitHub issue у чат AI

Див. також

Wake Lock → — сигнали активності, Quality Hub, діагностика
Team Tracker → — двофакторна активність, інтервал сну, ActivityWatch, internal vs external
Довідник команд палітри →
Встановлення CLI →