终端交互界面

运行 opencode 会以当前目录打开 TUI；也可以指定项目：

opencode /path/to/project

进入后直接输入问题或任务。复杂改动可以先讨论计划，再确定实施范围；智能体类型与权限见智能体。

引用项目文件与参考内容

在消息里输入 @ 会在工作目录中模糊查找文件，选中文件后其内容会自动加入对话。提示应同时指出你希望检查的行为或改动目标，避免只附文件却没有明确问题。

配置过的 references 也会出现在补全中：@alias 添加参考根目录上下文，@alias/ 用于补全其中的文件。别名需先存在，不能将任意字符串视为已经连接的外部资源。

Intro 还支持把图片拖入终端添加到提示。引用代码、说明现有模式或附上目标设计，可以帮助代理理解任务。

直接执行 shell 命令

在消息开头使用 !：

!ls -la

该命令会执行，输出以工具结果加入对话。这与让模型解释一段 shell 文本不同，执行前应确认命令和工作目录。

会话操作

用 /new 开启新会话，用 /sessions 列出并切换历史会话，长会话可用 /compact 压缩。/details 切换工具执行详情。

需要撤销时，/undo 移除最近的用户消息、后续回复及相关文件变更；/redo 恢复已撤销的内容。文件恢复依赖 Git，因此项目必须是 Git 仓库。完整命令及默认快捷键见TUI 命令参考。

用外部编辑器写消息

/editor 打开外部编辑器撰写消息，/export 导出当前对话为 Markdown 并在编辑器打开，两者读取 EDITOR。

Linux/macOS 的 VS Code 示例：

export EDITOR="code --wait"

PowerShell 对应：

$env:EDITOR = "code --wait"

CMD 可使用 set EDITOR=code --wait。需要等待编辑完成的 GUI 编辑器应添加其阻塞参数；示例的 --wait 用于让进程等待关闭。永久设置按自己的 shell 配置文件或系统环境变量管理。

显示偏好

使用 ctrl+p 打开命令面板，搜索 username 或 hide username 可切换消息中用户名显示；此设置跨重启保留。主题、光标、滚动和通知由独立的TUI 配置控制。