Руководство пользователя SOBA
Руководство пользователя SOBA Agent — local-first агент с proof receipts, Project Memory provenance, MCP, sessions, tools, skills и bounded permissions.
SOBA Agent — local-first инженерный агент, который помнит проект, работает в ограниченных tool loops, проверяет результат и оставляет receipts. Текущая линия 0.6.x — стабилизационная перед 0.7.0: фокус на proof receipts, memory provenance, permission receipts, skill eval/bench/trace и надёжной установке через npm/Bun.
Быстрый старт
- Быстрый старт — установка, конфигурация, все режимы CLI/TUI, инструменты, разрешения, очередь, persistent-сессии, Context Capsules, proactive compaction и полный lifecycle skills за 10 минут.
Пошаговое руководство
- Проект шаг за шагом: v0.6 workflow — end-to-end сценарий работы с агентом: first-run init, постановка задачи, evidence summary, diff review, MCP reload, sessions и handoff.
- Remote MCP: пошаговый гайд — подключение hosted Streamable HTTP MCP server,
env-backed auth, проверка
/mcp statusи типовые ошибки.
Справочные руководства
| Раздел | Содержание |
|---|---|
| CLI reference | Режимы запуска, top-level flags, soba provider subcommands |
| Конфигурация | Файл ~/.soba/config.json, CLI-флаги, переменные окружения, приоритет настроек |
| Провайдеры и модели | 4 встроенных провайдера (DeepSeek, Moonshot Kimi, Alibaba Qwen, OpenRouter), динамический discovery моделей, кастомные провайдеры через soba provider, диагностика |
| Интерфейс и команды | TUI, slash-команды, прямая оболочка ! / !!, очередь, горячие клавиши |
| Proof receipts | .soba/evidence/*.soba-proof.json, soba prove, soba verify, soba explain-claim, permission receipts и release-ready finish |
| Инструменты агента | Built-in tools, Project Memory tools, MCP tools, direct shell и trust boundary |
| ACP и Zed | soba acp, ACP v1 server, sessions, permissions, tool updates, evidence metadata и ограничения |
| Сессии | Формат JSONL, продолжение, rewind, ветвление, навигация по дереву |
| Project Memory | .soba/memory/, knowledge files, memory capsules, entity graph, read_project_memory / write_project_memory |
| Compaction и Context Capsules | Proactive compaction, триггеры, метрики, ручной compact, портативные капсулы |
| Portable Capsules | Создание, экспорт и загрузка .capsule.md handoff-файлов между сессиями, агентами и проектами |
| MCP-серверы | Подключение project-local stdio и remote Streamable HTTP MCP tools через .soba/mcp.json, auth, trustMode и /mcp commands |
| Безопасность | Разрешения, trust-уровни, project trust, PermissionMode |
| Skills | Bundled-, user-, project-скилы, создание, edit, eval, bench, trace, promote, revision history |
| Звуковые уведомления | Sound config, CLI-флаги, env и практические режимы |
| Темы | Цветовые режимы TUI (dark, light, forest), семантические токены, создание пользовательских тем |
| Changelog | История версий, собранная из git-тегов и commit subjects |
Сборка
- GitHub — исходный код, issues и releases живут в avacadorun-dev/soba-agent.
- GitHub Releases — tagged releases собирают standalone-бинарники для macOS/Linux и прикладывают их к релизу вместе
с SHA256SUMS. Основной способ установки для пользователей:
npm install -g soba-agentилиbun add -g soba-agent.