Run your first task

1. Choose a project

Select a local project folder. The app registers that folder for its Files and Editor surfaces and supplies it as the directory context for OpenCode tools.

2. Review the task controls

Before sending a task, confirm the selected:

• project;
• agent;
• provider and model;
• reasoning variant, when the model offers one.

3. Give a concrete request

Describe the outcome, important constraints, and how you want the result verified. For example:

Explain why the settings tests fail. Inspect the implementation and report the cause, but do not change files yet.

The agent can ask questions or request permission when an operation requires a decision. Read the proposed action and its scope before approving it.

4. Follow progress

You can switch projects or sessions while a task is running. OpenCode remains the source of truth for session messages, permissions, tool calls, and task state.

5. Inspect the result

Use the Files, Editor, Changes, terminal, and Git surfaces to review work. A successful chat response is not a substitute for checking the requested artifact or validation result.

Separate diagnosis from implementation

If you only want an explanation, say so. If you want a change, ask for implementation and the verification you expect.