权限与日常使用

工具权限

默认情况下，Crush 在运行工具调用前会请求你的许可。可以放行某些工具而不再提示（谨慎使用），也可以拒绝工具，把它们对智能体完全隐藏：

# crushrc
permissions allow view ls grep edit mcp_context7_get-library-doc
permissions deny bash sourcegraph

要完全跳过所有权限提示，用 --yolo 标志运行 Crush，务必极其小心。禁用来自 MCP 服务器的工具见「MCP、LSP 与 Hooks」。

忽略文件

Crush 默认遵循 .gitignore。你也可以创建 .crushignore（语法同 .gitignore，可放在项目根或子目录），列出想在版本控制里保留、但不希望 Crush 当作上下文的文件和目录。

桌面通知

工具调用需要权限、智能体完成一轮时，Crush 会发桌面通知，但只有在终端窗口未聚焦且终端支持上报焦点状态时才发。option notifications 可选 auto、native、osc、bell、disabled；auto 在本地用原生通知，SSH 下在支持时用 OSC 通知。

日志

日志保存在项目的 ./.crush/logs/crush.log。crush logs 打印最后 1000 行，crush logs --tail 500 指定行数，crush logs --follow 实时跟踪。想要更多日志，用 --debug 启动，或在 crushrc 里 option debug true、option debug-lsp true。

共享工作区

当 Crush 对着共享后端运行（比如两个 TUI 连同一个 crush serve），客户端按解析后的 --cwd 分组为工作区：相同 --cwd 的客户端加入同一个工作区，共享会话列表、消息历史、权限队列、LSP 和 MCP 状态。加入是隐式的；但每次新调用默认开启全新会话，想接续另一个客户端已打开的对话，要在会话选择器里选它。会话有 IsBusy（智能体正在跑一轮）和 AttachedClients（当前查看的客户端数）两个信号。第一个创建工作区的客户端决定进程级标志，--yolo 和 --debug 遵循「先到先得」，之后以不同值到达的客户端不会改变已在运行的工作区。至少有一个客户端保持 SSE 事件流时，工作区才存在。