Руководство пользователя SOBA
Полное руководство пользователя SOBA Agent — установка, CLI/TUI, Project Memory, MCP, сессии, безопасность, tools, skills и темы.
SOBA Agent — CLI-агент кодинга с фокусом на proactive context management, самомодифицируемую архитектуру (skills) и гибридный визуальный слой для фронтенд-разработки.
Быстрый старт
- Быстрый старт — установка, конфигурация, все режимы CLI/TUI, инструменты, разрешения, очередь, persistent-сессии, Context Capsules, proactive compaction и полный lifecycle skills за 10 минут.
Пошаговое руководство
- Проект шаг за шагом: профессиональный workflow — end-to-end сценарий работы с агентом: постановка задачи, реализация, тесты, review gate, capsules и 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-команды, прямая оболочка ! / !!, очередь, горячие клавиши |
| Инструменты агента | Built-in tools, Project Memory tools, MCP tools, direct shell и trust boundary |
| Сессии | Формат 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, promote, revision history |
| Звуковые уведомления | Sound config, CLI-флаги, env и практические режимы |
| Темы | Цветовые режимы TUI (dark, light, forest), семантические токены, создание пользовательских тем |
Сборка
- 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.