feat: workspaces docs (#328)

Author: shadowfax92

docs/changelog.mdx

@@ -7,6 +7,19 @@ All notable changes to BrowserOS are documented here. For the full release histo
 
 ---
 
+## v0.37.0
+<sub>January 21, 2026</sub>
+
+- **Workflows** — Build reliable, repeatable browser automations with a visual graph builder. Chat with the workflow agent to define step-by-step automation—ideal for complex tasks where ad-hoc prompts aren't enough. [Read more →](/features/workflows)
+
+<img src="/features/workflow/sample-workflow.png" alt="Workflows visual graph builder showing a data entry automation" />
+
+- **Workspaces** — Give the agent access to a folder on your computer. Combine browser automation with local file operations—research on the web and save reports, scrape data and export to files, all in one task. [Read more →](/features/workspaces)
+
+<img src="/features/workspace/workspace-research-and-create-example.png" alt="Agent researching Hacker News and generating an HTML report" />
+
+---
+
 ## v0.36.3
 <sub>January 15, 2026</sub>
 

docs/docs.json

@@ -12,34 +12,27 @@
     "groups": [
       {
         "group": "Get Started",
-        "pages": [
-          "index",
-          "onboarding",
-          "update",
-          "changelog"
-        ]
+        "pages": ["index", "onboarding", "update", "changelog"]
       },
       {
         "group": "Core Features",
         "pages": [
           "features/bring-your-own-llm",
-          "features/llm-chat-hub",
           "features/scheduled-tasks",
+          "features/workflows",
           "features/use-with-claude-code",
+          "features/workspaces",
+          "features/llm-chat-hub",
           "features/ad-blocking"
         ]
       },
       {
         "group": "Integrations",
-        "pages": [
-          "integrations/n8n"
-        ]
+        "pages": ["integrations/n8n"]
       },
       {
         "group": "Contributing",
-        "pages": [
-          "contributing"
-        ]
+        "pages": ["contributing"]
       }
     ]
   },

docs/features/workflow/sample-workflow.png

@@ -0,0 +1,61 @@
+---
+title: "Workflows"
+description: "Build reliable, repeatable browser automations with a visual graph builder"
+---
+
+Workflows let you turn complex browser tasks into reliable, reusable automations. Instead of hoping the agent figures out the right steps each time, you define the exact sequence—and run it whenever you need.
+
+## When to Use Workflows
+
+Use workflows when:
+- **Reliability matters** — The task needs to work the same way every time
+- **Steps are complex** — Multiple pages, loops, conditionals, or parallel actions
+- **You'll repeat it** — Run the same automation daily, weekly, or on-demand
+
+For quick, one-off tasks, the regular agent works well. For serious automation, build a workflow.
+
+## Creating Your First Workflow
+
+<img src="/features/workflow/workflows-page.png" alt="Access Workflows from the sidebar or create a new workflow" />
+
+1. Open the **Workflows** page from the sidebar
+2. Click **+ New Workflow**
+3. Describe what you want in the chat panel
+
+Try this example—copy and paste it to create a workflow that fills out forms from spreadsheet data:
+
+```
+Navigate to the spreadsheet https://dub.sh/browseros/test-spreadsheet. Get the contact information and fill it out in the form https://dub.sh/browseros/test-form for each entry in the spreadsheet. Feel free to parallelize this, but ensure all entries are filled.
+```
+
+The workflow agent will generate a visual graph representing each step. You can refine the workflow by chatting further—ask it to add steps, handle edge cases, or adjust the logic.
+
+<img src="/features/workflow/sample-workflow.png" alt="Generated workflow graph with parallel execution" />
+
+4. Click **Test Workflow** to run it and verify it works
+5. Click **Save Changes** to keep it for later
+
+## Running Workflows
+
+From the Workflows page, you can:
+- **Run** — Execute the workflow immediately
+- **Edit** — Open the graph builder to refine steps
+- **Delete** — Remove workflows you no longer need
+
+## Example Use Cases
+
+**Data entry automation**
+> Read contacts from a Google Sheet and submit each one to a web form—automatically handling pagination and parallel submissions.
+
+**LinkedIn outreach**
+> Visit each profile from a list, check if they match your criteria, and send a personalized connection request.
+
+**Price monitoring**
+> Check prices across multiple e-commerce sites, extract the data, and compile it into a spreadsheet.
+
+**Bulk unsubscribes**
+> Go through your Gmail, find subscription emails, and click unsubscribe on each one.
+
+## Feedback
+
+Workflows is a new feature. If you'd like to see scheduling support, sharing, or other capabilities, [open a GitHub issue](https://github.com/browseros-ai/BrowserOS/issues) with your request.

docs/features/workflow/workflows-page.png

@@ -0,0 +1,68 @@
+---
+title: "Workspaces"
+description: "Give the agent access to local files for powerful browser + file automations"
+---
+
+Workspaces let the agent read and write files on your computer. Combine browser automation with local file operations—research on the web, then save reports directly to your folder.
+
+## Why Workspaces?
+
+Without a workspace, the agent can only interact with browser tabs. With a workspace, it can:
+
+- **Read files** from your selected folder
+- **Write files** like reports, spreadsheets, or markdown
+- **Run shell commands** within the folder
+
+The real power: do both browser automation AND file operations in a single task.
+
+## Setting Up a Workspace
+
+<img src="/features/workspace/workspace-selector.png" alt="Select a workspace folder for the agent to operate in" />
+
+1. Click the workspace dropdown (next to the prompt input)
+2. Select a recent folder or click **Choose a different folder**
+3. Grant BrowserOS access to that folder when prompted
+
+The agent is sandboxed to your selected folder—it cannot access files outside of it.
+
+To disable file access, select **No workspace** and the agent will work with browser tabs only.
+
+## Try It: Research and Create a Report
+
+With a workspace selected, try this prompt:
+
+```
+Read the top 3 stories on Hacker News, read the comments too, and write an HTML report.
+```
+
+The agent will:
+1. Navigate to Hacker News
+2. Read each top story and its comments
+3. Generate an HTML report summarizing the findings
+4. Save the report to your workspace folder
+
+<img src="/features/workspace/workspace-research-and-create-example.png" alt="Agent researching Hacker News and generating an HTML report" />
+
+## Example Use Cases
+
+**Organize your downloads**
+> Go through my Downloads folder and organize files by type—documents, images, videos, archives.
+
+**Competitive research report**
+> Research key trends about [topic] on Reddit, Twitter, and LinkedIn. Create an HTML report with your findings.
+
+**Web scraping to files**
+> Visit these 10 product pages, extract the name, price, and description, and save the results as a markdown file.
+
+**Content aggregation**
+> Find the top posts from these 5 subreddits today and compile them into a daily digest document.
+
+## Security
+
+- The agent can **only** access the folder you select—no parent directories or other locations
+- You can revoke access anytime by selecting **No workspace**
+- All file operations happen locally on your machine
+
+## Feedback
+
+Workspaces is a new feature. If you have feedback or feature requests, [open a GitHub issue](https://github.com/browseros-ai/BrowserOS/issues).