Skip to main content

Starting Your First Task with brewdata

Now that you've configured your AI provider and model, you're ready to start using brewdata! This guide walks you through your first interaction.

Step 1: Open the brewdata Panel​

Click the brewdata icon in the VS Code Activity Bar (vertical bar on the side of the window) to open the chat interface. If you don't see the icon, verify the extension is installed and enabled.

brewdata icon in VS Code Activity Bar

The brewdata icon in the Activity Bar opens the chat interface.

Step 2: Type Your Task​

Type a clear, concise description of what you want brewdata to do in the chat box at the bottom of the panel. Examples of effective tasks:

  • "What are the available macros in this project?"

No special commands or syntax needed—just use plain English.

Typing a task in the brewdata chat interface

Enter your task in natural language - no special syntax required.

Step 3: Send Your Task​

Press Enter or click the Send icon () to the right of the input box.

Step 4: Review and Approve Actions​

brewdata analyzes your request and proposes specific actions. These may include:

  • Reading files: Shows file contents it needs to access
  • Writing to files: Displays a diff with proposed changes (added lines in green, removed in red)
  • Executing commands: Shows the exact command to run in your terminal
  • Using the Browser: Outlines browser actions (click, type, etc.)
  • Asking questions: Requests clarification when needed to proceed
Reviewing a proposed file creation action

brewdata shows exactly what action it wants to perform and waits for your approval.

Each action requires your explicit approval (unless auto-approval is enabled):

  • Approve: Click the "Approve" button to execute the proposed action
  • Reject: Click the "Reject" button and provide feedback if needed

Step 5: Iterate​

brewdata works iteratively. After each action, it waits for your feedback before proposing the next step. Continue this review-approve cycle until your task is complete.

Final result of a completed task showing the iteration process

After completing the task, brewdata shows the final result and awaits your next instruction.

Conclusion​

You've now completed your first task with brewdata! Through this process, you've learned:

  • How to interact with brewdata using natural language
  • The approval-based workflow that keeps you in control
  • The iterative approach brewdata uses to solve problems step-by-step

This iterative, approval-based workflow is at the core of how brewdata works—letting AI handle the tedious parts of coding while you maintain complete oversight. Now that you understand the basics, you're ready to tackle more complex tasks, explore different modes for specialized workflows, or try the auto-approval feature to speed up repetitive tasks.

Is this documentation incorrect or incomplete? Report an issue