diff --git a/docs/changelog.mdx b/docs/changelog.mdx
index 13520beb..c0143aa7 100644
--- a/docs/changelog.mdx
+++ b/docs/changelog.mdx
@@ -7,6 +7,19 @@ All notable changes to BrowserOS are documented here. For the full release histo
---
+## v0.37.0
+January 21, 2026
+
+- **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)
+
+
+
+- **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)
+
+
+
+---
+
## v0.36.3
January 15, 2026
diff --git a/docs/docs.json b/docs/docs.json
index 33e04f19..23f2a118 100644
--- a/docs/docs.json
+++ b/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"]
}
]
},
diff --git a/docs/features/workflow/sample-workflow.png b/docs/features/workflow/sample-workflow.png
new file mode 100644
index 00000000..ddf84556
Binary files /dev/null and b/docs/features/workflow/sample-workflow.png differ
diff --git a/docs/features/workflow/workflows-page.png b/docs/features/workflow/workflows-page.png
new file mode 100644
index 00000000..350f77cb
Binary files /dev/null and b/docs/features/workflow/workflows-page.png differ
diff --git a/docs/features/workflows.mdx b/docs/features/workflows.mdx
new file mode 100644
index 00000000..46e691ea
--- /dev/null
+++ b/docs/features/workflows.mdx
@@ -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
+
+
+
+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.
+
+
+
+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.
diff --git a/docs/features/workspace/workspace-research-and-create-example.png b/docs/features/workspace/workspace-research-and-create-example.png
new file mode 100644
index 00000000..e31598a2
Binary files /dev/null and b/docs/features/workspace/workspace-research-and-create-example.png differ
diff --git a/docs/features/workspace/workspace-selector.png b/docs/features/workspace/workspace-selector.png
new file mode 100644
index 00000000..3e86d4be
Binary files /dev/null and b/docs/features/workspace/workspace-selector.png differ
diff --git a/docs/features/workspaces.mdx b/docs/features/workspaces.mdx
new file mode 100644
index 00000000..846cc936
--- /dev/null
+++ b/docs/features/workspaces.mdx
@@ -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
+
+
+
+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
+
+
+
+## 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).