快速开始
快速启动 SOBA Agent v0.4.1：安装、provider、TUI、session、direct shell、Project Memory、MCP 和 skills。
本指南从一次干净安装开始，带你完成 SOBA v0.4.1 的最小可用工作流：检查 provider、启动 TUI、执行任务、 保存项目记忆，并按需连接 MCP tools 和 skills。
1. 安装并检查
使用 npm：
npm install -g soba-agent使用 Bun：
bun add -g soba-agent检查 CLI：
soba --version
soba --help如果从源码运行：
git clone <repo-url> soba-agent
cd soba-agent
bun install
bun run build
bun run src/cli.ts --version2. 配置 provider
查看 providers：
soba provider list执行最小 one-shot 检查：
soba --no-session --max-agent-iterations 1 "Answer with one word: ok"添加本地 OpenAI-compatible provider：
soba provider add ollama \
--base-url http://localhost:11434/v1 \
--model llama3.1="Llama 3.1",8192,2048 \
--set-active本地模型建议先用较小的 context 和输出上限。8192,2048 对笔记本会友好很多；只有在模型和硬件都稳定时，再慢慢调大。
完整说明见 Provider 与模型。
3. 启动 TUI
soba -i --lang zh --theme graphite常用起始命令：
/session
/budget
/permissions ask
/auto-compact on一次性仓库可以使用 repo-scoped permissions：
/permissions reporepo 只会跳过当前仓库内 dangerous 操作的确认。只有当你要在当前 session 中信任所有 dangerous 操作
（包括外部命令）时，才使用 /permissions full。
4. 执行第一个任务
示例 prompt：
Inspect this project.
Read package.json and the src/tests layout first.
Then propose a short plan.
If edits are needed, keep them inside the plan and run a targeted test.
Do not create a git commit.使用 direct shell ! 快速执行你自己的命令：
!git status --short
!git diff --stat
!bun test如果不想把输出放进 transcript，用 !!：
!!bun run build如果需要 agent 分析命令输出，请用普通消息要求它运行命令，这样它会通过 bash tool 获取输出。
5. 继续 session
soba -i
soba -c -i
soba -r
soba -s <SESSION_ID> "Continue the task"一次性问题可以不保存 session：
soba --no-session "One-off question"6. 使用 Project Memory、MCP 和 skills
Project Memory 把长期项目事实保存在 .soba/memory/：
Update Project Memory with architecture, conventions, known errors, and dependencies.
Do not store secrets.MCP servers 通过 .soba/mcp.json 配置：
/mcp status
/mcp start <server>
/mcp auth status <server>在 TUI 中查看和激活 skills：
/skill list
/skill:commit-message Suggest a conventional commit message for staged changes.下一步：CLI reference、界面与命令、MCP servers 和 Skills。