Master OpenCode's Plan and Build modes, reference files with @, drag images into the TUI, undo and redo changes, and share conversations with your team.
OpenCode separates thinking from acting. Plan mode lets the agent reason through implementation without touching any files. Build mode lets it actually make changes. You switch between them with the Tab key.
The mode indicator appears in the lower-right corner of the TUI.
Before asking OpenCode to implement anything significant, switch to Plan mode:
<Tab>
Now describe the feature in natural language. Talk to OpenCode like you're briefing a junior developer — give context, goals, and any constraints.
Give feedback before committing to any changes:
Once you're satisfied with the plan, press Tab again to enter Build mode:
<Tab>
Then tell it to proceed:
Sounds good. Go ahead and make the changes.
OpenCode implements all the planned changes, reading and writing files as needed.
Use the @ key to fuzzy-search and reference specific files in your project:
The @ fuzzy finder searches file names and paths across your entire project. You can reference multiple files in a single message.
OpenCode's TUI accepts images dragged directly from your file manager or browser. The agent scans the image and adds it to the prompt context:
This works for UI mockups, screenshots of error messages, diagrams, and any visual reference you want the agent to consider.
If OpenCode makes changes that aren't what you wanted, /undo reverts them and re-shows your original prompt for you to refine:
Run /undo multiple times to revert multiple rounds of changes. /redo re-applies the last undone change.
Share the current conversation with a teammate or for async review:
The link gives your teammate a read-only view of the full conversation including all code changes. Sharing is opt-in — nothing is public by default.
OpenCode is also a great codebase explainer. If you're working in an unfamiliar area:
Plan mode lets you review and iterate on implementation strategy before any code is written. Build mode executes. @ references bring specific files into context. Images dropped into the TUI become visual references. /undo and /redo give you a safe edit history. /share creates a link for async collaboration. The next module covers AGENTS.md conventions, MCP servers, themes, and advanced configuration.