Self-improving AI Employees for everyone
Python ai-agentsai-employeeai-employeesassistantautonomous-agentsco-employeescompanygrok-botinstinctloop-agentsmuseown-your-datapersonalself-hosted
docs: clarify AI employee OS vision and separate reader guides
trohitgaf458c5ec680
diff --git a/CLAUDE.md b/CLAUDE.mdindex 488828e8..12edf38f 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -1,7 +1,7 @@# OpenCompany - Claude Documentation## Project Overview-This is a React Flow-based workflow automation platform implementing n8n-inspired architectural patterns. The project has undergone a comprehensive refactoring to implement modern INodeProperties interface system with full TypeScript compliance and code cleanup.+OpenCompany is an open-source operating system for self-improving AI employees. Employees use browsers, apps, tools, integrations, and the computer to complete work. Home lets people describe a job, review its setup, hire an employee, and work with it through chat and a shared Workspace. Hiring assembles a lead and specialist agents automatically. The React Flow editor in Dev mode exposes the underlying workflows, tools, context, memory, and skills for technical customization. Public documentation should preserve the employee OS vision, explain it in plain language, and keep development and infrastructure details in a separate technical section.## Documentation Referencediff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex e610512d..fc1baa56 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -1,6 +1,8 @@# Contributing to OpenCompany-Welcome! This guide is a contributor's map to the codebase. It tells you *where things live* and *where to start reading* when you want to add a feature. For the full architecture tour, use the [DeepWiki badge](https://deepwiki.com/zeenie-ai/OpenCompany) on the README or browse [docs-internal/](docs-internal/).+OpenCompany is an open-source operating system for AI employees that use browsers, apps, tools, integrations, and the computer to complete work. The workflow editor and execution engine power those employees behind the scenes. For installation and everyday use, start with the [README's guide for everyone](README.md#for-everyone).++This guide is a contributor's map to the codebase. It tells you *where things live* and *where to start reading* when you want to add a feature. For the full architecture tour, use [DeepWiki](https://deepwiki.com/zeenie-ai/OpenCompany) or browse [docs-internal/](docs-internal/).## Contribution Workflowdiff --git a/README.md b/README.mdindex 159946a5..2cac34a4 100644--- a/README.md+++ b/README.md@@ -9,67 +9,87 @@**Self-improving AI employees, running on your own computer.**-OpenCompany is an open-source operating system for AI employees. You hire an employee for a job, a Builder, a Grower, a Chief of Staff, connect it to your email, calendar, messages, code, and the rest of your tools, and press Start. It works in the background, on your machine, for as long as you want. And it gets better at the job the longer it works.+OpenCompany is an open-source operating system for AI employees. It gives employees browsers, apps, tools, integrations, and access to your computer to complete work. Hire them to build and ship software, grow your business, answer customers, run operations, or research a topic.-An AI employee is not one chatbot. It is a small team: a lead who understands the job, and a few specialist agents who each do one part of it well. The lead hands out the work, checks the results, and reports back to you. You build the team by dragging the pieces onto a canvas and connecting them. No code.+Describe a job in plain words and connect the tools it needs. Each employee has a workspace, a routine, skills, and memory. A lead coordinates specialist AI agents to carry out the job, review their work, and bring you the result. You choose their access and ground rules, watch them work, and coach them as they gain experience and new abilities.-Bring your own API keys, or run models locally for free. No subscription. No usage limits.+**[Get started](#for-everyone)** · **[For technical readers](#for-technical-readers)** · **[Documentation](https://docs.opencompany.sh)** · **[Discord](https://discord.gg/c9pCJ7d8Ce)**-**[Read the docs →](https://docs.opencompany.sh)**+## For everyone-## Quick Start+### What could you hire an employee to do?-Download the app for your computer and install it (these links always point at the [latest release](https://github.com/zeenie-ai/OpenCompany/releases/latest)):+Hire employees for roles like these, then adapt their instructions and tools to your work.-- **Windows**: [OpenCompany-windows-x64.exe](https://github.com/zeenie-ai/OpenCompany/releases/latest/download/OpenCompany-windows-x64.exe)-- **macOS, Apple Silicon**: [OpenCompany-macos-arm64.dmg](https://github.com/zeenie-ai/OpenCompany/releases/latest/download/OpenCompany-macos-arm64.dmg)-- **Linux**: [OpenCompany-linux-x86_64.AppImage](https://github.com/zeenie-ai/OpenCompany/releases/latest/download/OpenCompany-linux-x86_64.AppImage), or [OpenCompany-linux-amd64.deb](https://github.com/zeenie-ai/OpenCompany/releases/latest/download/OpenCompany-linux-amd64.deb) on Debian and Ubuntu+| Employee | Example job |+| --- | --- |+| **Builder** | Build software, write and run code, work on pull requests, and use deployment tools. |+| **Grower** | Research the market, create content, publish to connected channels, and manage community conversations. |+| **Chief of Staff** | Manage email, calendars, documents, and tasks, and bring you a daily briefing. |+| **Front Desk** | Answer customer questions, help with booking requests, and bring you cases that need your attention. |+| **Researcher** | Browse the web, read documents, investigate a topic, and organize the findings. |+| **Treasurer** | Track payment events and help manage payment operations through connected services. |-Nothing else to install. On first launch the app sets itself up (a one-time download, a minute or two) and opens Home. Describe a job to hire your first employee; if no AI provider is connected yet, Home asks you to connect one, or you can add it yourself in Settings > Connectors. Switch to Dev mode for the workflow editor, where three example employees are listed in the workflow sidebar; open one to see how it is put together.+These are roles you can configure. Home also offers four starter jobs: **Receptionist**, **Inbox assistant**, **Social media helper**, and **Daily briefer**. Pick one or describe your own. What an employee can do depends on the apps, tools, AI model, and instructions you give it.-The builds are not code-signed yet, so macOS asks you to allow the app under System Settings > Privacy & Security, and Windows SmartScreen needs "More info > Run anyway".+### Get started-<details>-<summary><b>Terminal install (servers and headless machines)</b></summary>+Download and install the desktop app from the [latest release](https://github.com/zeenie-ai/OpenCompany/releases/latest):-```bash-curl -fsSL https://opencompany.sh/install.sh | bash # macOS / Linux-iwr -useb https://opencompany.sh/install.ps1 | iex # Windows PowerShell-company start-```+| Your computer | Download |+| --- | --- |+| Windows | [Windows installer](https://github.com/zeenie-ai/OpenCompany/releases/latest/download/OpenCompany-windows-x64.exe) |+| macOS, Apple Silicon | [Mac installer](https://github.com/zeenie-ai/OpenCompany/releases/latest/download/OpenCompany-macos-arm64.dmg) |+| Linux | [AppImage](https://github.com/zeenie-ai/OpenCompany/releases/latest/download/OpenCompany-linux-x86_64.AppImage) or [Debian / Ubuntu package](https://github.com/zeenie-ai/OpenCompany/releases/latest/download/OpenCompany-linux-amd64.deb) |-The script installs bun, Python and uv when they are missing, then the `@zeenie-ai/opencompany` package. Open http://localhost:5678. Data lives in `~/.opencompany`, shared with the desktop app. See [SETUP.md](docs-internal/SETUP.md).+The app downloads its supporting software on first launch, then opens Home.-</details>+1. **Connect an AI model.** Follow the prompt in Home or open **Settings > Connectors**. Use an AI provider account or connect a model running on your computer.+2. **Describe the job.** For example: “Read my new emails, draft short replies in my style, and ask me before sending.”+3. **Review the setup.** Check the employee's instructions, apps, routine, and ground rules. Ask for changes and connect any required apps.+4. **Hire.** OpenCompany creates the employee and its team. Work starts once the required connections are ready; its page tells you if something is missing.+5. **Work together.** Chat with the employee, follow its progress, review drafts, and open its Workspace to see reports and files.-<details>-<summary><b>Docker (self-hosting)</b></summary>+You can hire and manage employees from Home without writing code. **Dev mode** opens the visual editor for people who want to customize how a team is put together.-```bash-git clone https://github.com/zeenie-ai/OpenCompany.git-cd OpenCompany-docker compose up -d --build-```+The builds are not code-signed yet. If your computer blocks the installer, macOS provides **System Settings > Privacy & Security**, and Windows SmartScreen provides **More info > Run anyway**.-Builds the image from source and starts one container, with all data in the `opencompany-selfhost_data` volume. Open http://localhost:5678 and register the owner account. The port is published on this machine only. See [docker.md](docs-internal/docker.md).+### How an employee works-</details>+[](docs/diagrams/how-it-works.svg)-<details>-<summary><b>Run from source (contributors)</b></summary>+An employee takes a job through the steps needed to complete it: browsing websites, using connected apps, working with files, running code, and coordinating specialists. It can work when a message arrives, at a scheduled time, or when you ask it to. Its lead assigns work and reviews submissions. You can see progress, results, and requests for help on the employee's page.-```bash-git clone https://github.com/zeenie-ai/OpenCompany.git-cd OpenCompany-bun run build-bun run dev-```+**You set the ground rules.** New hires ask before sending by default. Supported send actions appear as drafts for approval; browser use is restricted to reading while Ask first is on. You can review app-access requests, change access, and stop or resume the employee from Home. Keep the app running and your computer awake for background work.++**You can watch and help.** The Workspace shows work on a canvas, in a browser, or on an Android screen. Take over the browser to sign in or help, then hand control back. The optional Android workspace currently runs on Windows x64; see the [mobile guide](docs/mobile-workspace.md).++### How employees get better at their jobs++- **Memory:** With memory enabled, employees can save useful facts, preferences, and decisions for later work.+- **Coaching:** Give feedback in chat and refine the employee's instructions as you see results.+- **Skills:** A skill is a written playbook, such as how to answer customers or prepare your weekly report. **Settings > Skills** manages the library used by new hires; existing employees can be given skills through chat.+- **New abilities:** Ask an employee to add a tool or skill within its access rules. Use **Apply** to activate saved changes for future work; the change takes effect once its current work finishes.++This is how employees improve: saved knowledge, clearer instructions, and better tools. OpenCompany does not retrain the underlying AI model.++### Browsers, apps, tools, and your computer++Employees combine the capabilities a job needs:-Needs bun 1.4+ and Python 3.12. See [SETUP.md](docs-internal/SETUP.md), [SCRIPTS.md](docs-internal/SCRIPTS.md) and [CONTRIBUTING.md](CONTRIBUTING.md).+- **Browser:** Research websites and work in web apps, with a live browser view where you can watch and take over when needed.+- **Apps and integrations:** Work with email, calendars, documents, spreadsheets, messaging, payments, and development services. Connections include Google Workspace, Microsoft 365, WhatsApp, Telegram, Discord, X, Stripe, GitHub, Vercel, Cloudflare, and Google Cloud.+- **Computer and tools:** Read and write files, write and run code, use the terminal, manage running programs, search the web, and work with a knowledge base. Speech and translation tools support work across languages.-</details>+Connect the services a job needs in **Settings > Connectors**, then choose which apps and tools the employee can use to get the work done.-## See it in action+### Your computer, your choice of AI++The desktop app keeps employee data and encrypted local credentials on your computer. Work sent to a cloud AI provider or a connected service is processed by that service. You can also connect local AI through Ollama or LM Studio.++OpenCompany is open source. Bring your own AI provider keys or use a local model; provider and connected-service charges and limits still apply. A local model uses your computer's hardware.++### See it in action**Hiring your first employee, end to end ↓**@@ -83,71 +103,76 @@ https://github.com/user-attachments/assets/035a2293-0837-4969-8b9d-8d680e023b89https://github.com/user-attachments/assets/3d25e9a3-f7b9-4760-8b9a-6de1e5a19cad-## How It Works+## For technical readers-[](https://raw.githubusercontent.com/zeenie-ai/OpenCompany/main/docs/diagrams/how-it-works.svg)+### Run from source-1. **Hire.** Describe the job in plain words on the Home screen, or start from a ready-made bundle in Settings > Plugins. OpenCompany drafts the new employee's setup (the apps it uses, when it works, what it checks with you first); adjust it and press Hire. Or switch to Dev mode and drop an AI Employee onto the canvas.-2. **Build the team.** In Dev mode, connect a few specialist agents to it and give each one the tools for its part of the job: email, browser, code, messaging, payments, and so on.-3. **Start.** The team runs in the background and wakes up when something happens: a new email, a customer message, a scheduled time. If you ask it to, it shows you each reply to approve before it goes out.-4. **Review.** Watch it work from its card on Home or on the canvas, open its Workspace to see the things it has made, read what it remembers, and change how it does things by editing its skills in plain text.+Requires **Bun 1.4+** and **Python 3.12**. The build command installs dependencies and prepares the application.++```bash+git clone https://github.com/zeenie-ai/OpenCompany.git+cd OpenCompany+bun install+bun run build+bun run dev+```-[](https://raw.githubusercontent.com/zeenie-ai/OpenCompany/main/docs/diagrams/default-workflows.svg)+See [Setup](docs-internal/SETUP.md), the [scripts reference](docs-internal/SCRIPTS.md), and [CONTRIBUTING.md](CONTRIBUTING.md) for development and validation commands.-## The Employees+### Install on a server-Each of these is a team you can assemble from the pieces in the box. Rename them, swap the specialists, or invent your own.+For macOS or Linux:-**Builder** — builds and ships things.-Writes and runs code, keeps dev servers alive, opens pull requests, deploys, and manages your cloud. The team: a lead, a coder, and a release specialist with GitHub, Vercel, Cloudflare, and Google Cloud.+```bash+curl -fsSL https://opencompany.sh/install.sh | bash+company start+```-**Grower** — grows the company.-Publishes to your channels, keeps your community alive, and watches the market. The team: a lead, a publisher for X, WhatsApp channels, Telegram, and Discord, and an analyst with social-media data and web search. Runs on a schedule so the cadence holds without you.+For Windows PowerShell:-**Chief of Staff** — runs your day.-Reads and answers mail, keeps the calendar, files, sheets, tasks, and contacts in order, and hands you a summary each morning. The team: a lead and workspace specialists for Google Workspace and Microsoft 365. Wakes on every new email.+```powershell+iwr -useb https://opencompany.sh/install.ps1 | iex+company start+```-**Front Desk** — answers customers.-Replies on WhatsApp, WhatsApp Business, Telegram, and Discord, in the customer's language and in voice if you like, and escalates what it cannot resolve. The team: a lead, a support specialist, and a language specialist.+The installer provisions Bun, Python, and uv when missing, then installs `@zeenie-ai/opencompany`. Open the URL printed by the CLI (the default app URL is http://localhost:5678). Data defaults to `~/.opencompany`, shared with the desktop app; source development uses the repository's `.opencompany` directory. See [Setup](docs-internal/SETUP.md) for configuration and [.env.template](.env.template) for environment variables.-**Researcher** — finds things out.-Browses, searches, scrapes, reads documents and images, and files what it learned into a knowledge base the whole company can ask. The team: a lead, a scout with a browser and search, and a librarian who indexes.+### Self-host with Docker-**Treasurer** — handles payments.-Runs payment operations through Stripe and reacts the moment a payment event happens. The team: a lead and a payments specialist.+```bash+git clone https://github.com/zeenie-ai/OpenCompany.git+cd OpenCompany+docker compose up -d --build+```-## How They Get Better+Compose builds one container from source, persists state in the `opencompany-selfhost_data` volume, and publishes the app on the host's loopback interface. Open the default app URL above and register the owner account. See the [Docker guide](docs-internal/docker.md) for configuration, optional browser dependencies, and authentication.-- **They remember.** An employee keeps facts, preferences, and decisions in a memory you can open and edit.-- **They pick up where they left off.** Every new message, task, or scheduled run continues the same conversation instead of starting from zero. When the conversation gets long, the employee writes itself a summary and carries on from it.-- **They add tools when they need them.** Ask an employee on its Talk page to take on something new, and it can add a tool or learn a skill from your library, within the rules you hired it with (nothing that sends or spends while it asks you first). A new tool works in that conversation right away; press Apply on its page to make an addition part of all its work.-- **They check their own work.** The lead reviews every result from the team and sends it back if it is not right, before it ever reaches you.-- **You coach them.** Skills are short plain-text playbooks. Edit one and the employee follows it on its next turn. Settings > Skills keeps your library of them, and every new hire starts with the ones you have switched on.+### How the employee OS is built-Nothing here is a black box. What an employee learns lives in its memory, its notes, its skills, and the pieces on its canvas, and you can read or change all of it. OpenCompany never retrains a model.+OpenCompany's employee OS brings together the runtime, workspaces, browser access, app integrations, tools, memory, and skills employees need to complete jobs. The React interface offers Home for hiring and daily work, plus a React Flow editor for configuring teams. The Python backend represents an employee as a workflow containing a lead, specialist agents, tools, conversation context, memory, and skills. Home's hiring flow creates this structure for you.-## What Is in the Box+- **Delegation:** The lead assigns tasks to connected teammates. Task records track assignment, submission, review, and completion. See [employee teams](docs-internal/employee_teams.md) and [agent delegation](docs-internal/agent_delegation.md).+- **Context and memory:** Stored conversations preserve working context; a separate memory tool holds facts an agent chooses to save. Team members have their own context and memory. See [agent context](docs-internal/agent_context_flow.md) and [compaction](docs-internal/memory_compaction.md).+- **Execution:** Temporal supports durable background work, event handling, and schedules. Stop allows admitted work to finish; Resume releases pending work. See [Temporal architecture](docs-internal/TEMPORAL_ARCHITECTURE.md) and [Stop / Resume semantics](docs-internal/temporal-workflow-control.md).+- **Models:** Native provider adapters support cloud services and local models, with named OpenAI-compatible endpoints for other servers. See the [LLM SDK](docs-internal/native_llm_sdk.md).+- **Extensions:** Backend node plugins declare their schemas and behavior; the interface renders their configuration. See the [plugin recipe](server/nodes/README.md) and [plugin system](docs-internal/plugin_system.md).-- **Connections** to Gmail, Google Calendar, Drive, Sheets, Tasks, Contacts, Microsoft 365, any email account, WhatsApp, WhatsApp Business, Telegram, Discord, X, Stripe, GitHub, Vercel, Cloudflare, Google Cloud, your Android phone, a browser, web search, scrapers, and a knowledge base: 140+ tools in all.-- **Models** from OpenAI, Anthropic, Google, xAI, DeepSeek, Kimi, Mistral, Groq, Cerebras, Sarvam, and OpenRouter, or run local models for free with Ollama, LM Studio, or any OpenAI-compatible server such as llama.cpp or vLLM.-- **A Browser AI Agent and live browser workspace** in Home and Dev mode: give it a task beside the browser or through employee chat, watch it work, take control to sign in or help, then hand control back. It uses your installed Chrome, Edge or Chromium in a dedicated OpenCompany profile and preserves existing Browser nodes. Direct tasks have their own recent history and Cancel control. [Browser runtime](docs-internal/browser.md) | [Workspace interface](docs-internal/browser_workspace.md).-- **1Password credential bindings** for supported API keys and configured website logins. Local access uses desktop authorization; distributed deployments use scoped service accounts. Website passwords are filled privately while browser observations are paused. MFA and multi-step login use human takeover. [Credential setup and compatibility](docs-internal/onepassword_credentials.md).-- **Speech and translation**, so employees can listen, talk, and work in other languages.-- **A local Android phone workspace** on Windows x64: set up a persistent emulator, watch it live, use it yourself, or let an AI agent use the **Android** tool. Optional setup requires SDK license acceptance; iOS is not yet supported. [Setup, controls and troubleshooting](docs/mobile-workspace.md).-- **Built-in skills** that ship ready to use, and a place to drop your own.-- **Built to keep running.** Employees survive restarts and catch up on missed schedules. For newly started Temporal generations, Stop lets current work finish, retains its result, and Resume continues with the next pending action. Home, chat and canvas use the same control. [Stop and Resume behavior](docs-internal/temporal-workflow-control.md). Local credentials remain encrypted on your machine. Multi-machine Browser deployments require PostgreSQL, shared storage, external Temporal and 1Password bindings; an unavailable browser keeps its owner and waits for recovery. [Deployment, migration and release checks](docs-internal/browser_agent_deployment.md).-- **A canvas you will want to look at**, in a light, dark or mid-century Atomic theme.+The editor includes three example workflows: **AI Assistant**, **AI Employee**, and **Claude Assistant**. They are examples to inspect and customize, separate from Home's starter jobs. [View their structure](docs/diagrams/default-workflows.svg).-## For Developers+### Technical documentation-Adding a tool, a model provider, a skill, or an integration is one plugin folder on the backend; the interface renders it automatically.+| If you want to… | Start here |+| --- | --- |+| Understand the codebase or contribute | [CONTRIBUTING.md](CONTRIBUTING.md) |+| Extend tools, triggers, or integrations | [Node plugins](server/nodes/README.md) |+| Run the browser and configure its workspace | [Browser runtime](docs-internal/browser.md), [workspace interface](docs-internal/browser_workspace.md) |+| Set up 1Password bindings | [Credential setup and compatibility](docs-internal/onepassword_credentials.md) |+| Deploy browser workers across machines | [Deployment requirements and recovery](docs-internal/browser_agent_deployment.md) |+| Work on the desktop application | [Desktop architecture](docs-internal/desktop_app.md) |+| Explore architecture and source-backed diagrams | [Internal docs](docs-internal/), [diagram index](docs/diagrams/README.md) |+| Use repository guidance for AI-assisted contributions | [CLAUDE.md](CLAUDE.md) |-- **[CONTRIBUTING.md](CONTRIBUTING.md)** — codebase map, architecture diagrams, contribution recipes-- **[server/nodes/README.md](server/nodes/README.md)** — 5-minute plugin recipe-- **[docs-internal/](docs-internal/)** — architecture deep dives-- **[CLAUDE.md](CLAUDE.md)** — project memory for AI-assisted contributions-- **Hosted docs:** https://docs.opencompany.sh/-- **DeepWiki:** https://deepwiki.com/zeenie-ai/OpenCompany+Further reading: [hosted documentation](https://docs.opencompany.sh/) · [DeepWiki](https://deepwiki.com/zeenie-ai/OpenCompany).## Contributingdiff --git a/docs/diagrams/README.md b/docs/diagrams/README.mdindex 9660c2b5..4e687514 100644--- a/docs/diagrams/README.md+++ b/docs/diagrams/README.md@@ -5,7 +5,9 @@ One set, dark theme, all SVG. This folder is the only copy; nothing under**Overview diagrams** (linked from the README and CONTRIBUTING):-- `how-it-works.svg`, `default-workflows.svg` (README)+- `how-it-works.svg` (README's guide for everyone: connect AI, describe a job,+ review the setup, hire, and coach)+- `default-workflows.svg` (README's technical section: example workflow structures)- `system-overview.svg`, `execution-flow.svg`, `ai-agent-routing.svg`, `node-anatomy.svg` (CONTRIBUTING)**Architecture and product-panel diagrams** (indexed in CONTRIBUTING under@@ -17,7 +19,8 @@ One set, dark theme, all SVG. This folder is the only copy; nothing under`workspace-files`, `runtime-observability-dock`. Each file's `<desc>` liststhe source files it was drawn from.-Facts on every diagram were checked against the code in September 2026.+The architecture diagrams were checked against the code in September 2026;+`how-it-works.svg` was updated for Home's employee-hiring experience in October 2026.Counts come from the live registries (`len(NODE_METADATA)`,`len(CREDENTIAL_REGISTRY)`, `config/llm_defaults.json`), and ports arenamed by their `.env.template` variables rather than numbers.diff --git a/docs/diagrams/how-it-works.svg b/docs/diagrams/how-it-works.svgindex 7cb7799b..589c9a36 100644--- a/docs/diagrams/how-it-works.svg+++ b/docs/diagrams/how-it-works.svg@@ -1,4 +1,6 @@-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1800 540" width="100%" preserveAspectRatio="xMidYMid meet" font-family="ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Monaco, Consolas, monospace">+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1800 540" width="100%" preserveAspectRatio="xMidYMid meet" role="img" aria-labelledby="title description" font-family="ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Monaco, Consolas, monospace">+ <title id="title">OpenCompany: an operating system for AI employees</title>+ <desc id="description">AI employees use browsers, apps, tools, integrations, and the computer to complete work. Connect an AI model, describe a job, review the setup, hire an employee, and coach it as it works. Sources: client/src/features/home/hire/HireView.tsx, client/src/features/home/genui/HireDraftPanel.tsx, client/src/features/home/employee/EmployeeChat.tsx, server/services/employees/hire.py, server/services/employees/team_recipe.py, server/services/employees/policy.py.</desc><!-- Palette: OpenCompany dark-theme tokens (client/src/themes/dark.css surfaces/fg + light.css Dracula accents) --><defs><marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="8" markerHeight="8" orient="auto-start-reverse">@@ -26,78 +28,73 @@<!-- Header --><text class="title" x="900" y="46" text-anchor="middle">How OpenCompany Works</text>- <text class="sub" x="900" y="74" text-anchor="middle">Hire AI employees, connect them to your apps, run everything on your own computer.</text>+ <text class="sub" x="900" y="74" text-anchor="middle">An operating system for AI employees to work with browsers, apps, tools, and your computer.</text>- <!-- Step 1: Pick your blocks -->+ <!-- Step 1: Connect AI --><rect class="panel p-purple" x="43" y="110" width="266" height="140" rx="10"/><circle class="accent-purple" cx="176" cy="142" r="15"/><text x="176" y="148" text-anchor="middle" font-size="16" font-weight="700" fill="#0d0f13">1</text>- <text class="h2" x="176" y="172" text-anchor="middle">Pick your blocks</text>- <text class="sub" x="176" y="196" text-anchor="middle">Drag nodes from the palette -</text>- <text class="sub" x="176" y="214" text-anchor="middle">140+ blocks: AI Employee, Chat,</text>- <text class="sub" x="176" y="232" text-anchor="middle">Telegram, Gmail, and more</text>+ <text class="h2" x="176" y="172" text-anchor="middle">Connect AI</text>+ <text class="sub" x="176" y="196" text-anchor="middle">Connect your AI provider</text>+ <text class="sub" x="176" y="214" text-anchor="middle">or a model running</text>+ <text class="sub" x="176" y="232" text-anchor="middle">on your computer</text><!-- Arrow 1 -> 2 -->- <text class="label" x="357" y="173" text-anchor="middle">drag</text><path class="conn" d="M 313 185 L 399 185" marker-end="url(#arrow)"/>- <!-- Step 2: Connect them -->+ <!-- Step 2: Describe the job --><rect class="panel p-purple" x="405" y="110" width="266" height="140" rx="10"/><circle class="accent-purple" cx="538" cy="142" r="15"/><text x="538" y="148" text-anchor="middle" font-size="16" font-weight="700" fill="#0d0f13">2</text>- <text class="h2" x="538" y="172" text-anchor="middle">Connect them</text>- <text class="sub" x="538" y="196" text-anchor="middle">Wire trigger → AI Agent → reply.</text>- <text class="sub" x="538" y="214" text-anchor="middle">Attach Context, Memory,</text>- <text class="sub" x="538" y="232" text-anchor="middle">Skills and Tools to the agent</text>+ <text class="h2" x="538" y="172" text-anchor="middle">Describe the job</text>+ <text class="sub" x="538" y="196" text-anchor="middle">Tell Home what you need:</text>+ <text class="sub" x="538" y="214" text-anchor="middle">answer customers, draft replies,</text>+ <text class="sub" x="538" y="232" text-anchor="middle">research, or build something</text><!-- Arrow 2 -> 3 -->- <text class="label" x="719" y="173" text-anchor="middle">wire</text><path class="conn" d="M 675 185 L 761 185" marker-end="url(#arrow)"/>- <!-- Step 3: Add your keys -->+ <!-- Step 3: Review the setup --><rect class="panel p-purple" x="767" y="110" width="266" height="140" rx="10"/><circle class="accent-purple" cx="900" cy="142" r="15"/><text x="900" y="148" text-anchor="middle" font-size="16" font-weight="700" fill="#0d0f13">3</text>- <text class="h2" x="900" y="172" text-anchor="middle">Add your keys</text>- <text class="sub" x="900" y="196" text-anchor="middle">Click the key icon, paste a</text>- <text class="sub" x="900" y="214" text-anchor="middle">provider key, pick a model</text>- <text class="sub" x="900" y="232" text-anchor="middle">(or run one locally, free)</text>+ <text class="h2" x="900" y="172" text-anchor="middle">Review the setup</text>+ <text class="sub" x="900" y="196" text-anchor="middle">Choose its apps and routine.</text>+ <text class="sub" x="900" y="214" text-anchor="middle">Set instructions and ground rules.</text>+ <text class="sub" x="900" y="232" text-anchor="middle">Connect the accounts it needs.</text><!-- Arrow 3 -> 4 -->- <text class="label" x="1081" y="173" text-anchor="middle">configure</text><path class="conn" d="M 1037 185 L 1123 185" marker-end="url(#arrow)"/>- <!-- Step 4: Test it, then start it -->+ <!-- Step 4: Hire your employee --><rect class="panel p-purple" x="1129" y="110" width="266" height="140" rx="10"/><circle class="accent-purple" cx="1262" cy="142" r="15"/><text x="1262" y="148" text-anchor="middle" font-size="16" font-weight="700" fill="#0d0f13">4</text>- <text class="h2" x="1262" y="172" text-anchor="middle">Test it, then start it</text>- <text class="sub" x="1262" y="196" text-anchor="middle">Run tests one node in place.</text>- <text class="sub" x="1262" y="214" text-anchor="middle">Start deploys the whole workflow</text>- <text class="sub" x="1262" y="232" text-anchor="middle">(the button becomes Pause)</text>- <text class="label" x="1262" y="272" text-anchor="middle">runs on a schedule, on an event, or in real time</text>+ <text class="h2" x="1262" y="172" text-anchor="middle">Hire your employee</text>+ <text class="sub" x="1262" y="196" text-anchor="middle">Its team is built for you.</text>+ <text class="sub" x="1262" y="214" text-anchor="middle">Once connected, it can work</text>+ <text class="sub" x="1262" y="232" text-anchor="middle">on messages or a schedule.</text><!-- Arrow 4 -> 5 -->- <text class="label" x="1443" y="173" text-anchor="middle">Run or Start</text><path class="conn" d="M 1399 185 L 1485 185" marker-end="url(#arrow)"/>- <!-- Step 5: Watch it work -->+ <!-- Step 5: Review and coach --><rect class="panel p-purple" x="1491" y="110" width="266" height="140" rx="10"/><circle class="accent-purple" cx="1624" cy="142" r="15"/><text x="1624" y="148" text-anchor="middle" font-size="16" font-weight="700" fill="#0d0f13">5</text>- <text class="h2" x="1624" y="172" text-anchor="middle">Watch it work</text>- <text class="sub" x="1624" y="196" text-anchor="middle">Answers appear in the Chat /</text>- <text class="sub" x="1624" y="214" text-anchor="middle">Console panel at the bottom</text>- <text class="sub" x="1624" y="232" text-anchor="middle">of the screen</text>+ <text class="h2" x="1624" y="172" text-anchor="middle">Review and coach</text>+ <text class="sub" x="1624" y="196" text-anchor="middle">Chat, review drafts, and</text>+ <text class="sub" x="1624" y="214" text-anchor="middle">open work in the Workspace.</text>+ <text class="sub" x="1624" y="232" text-anchor="middle">Give feedback and refine skills.</text><!-- Value band 1: integrations --><rect class="panel p-green" x="43" y="304" width="1714" height="78" rx="10"/>- <text class="h1" x="900" y="336" text-anchor="middle">Connect the apps you already use</text>- <text class="sub" x="900" y="364" text-anchor="middle">Gmail · Calendar · Drive · Sheets · Microsoft 365 · Telegram · WhatsApp · Discord · X · Stripe · GitHub · Vercel · Cloudflare · Google Cloud · AWS · browser · web search · Python · JavaScript + more</text>+ <text class="h1" x="900" y="336" text-anchor="middle">Give employees the tools to complete work</text>+ <text class="sub" x="900" y="364" text-anchor="middle">Browsers · apps · integrations · files · code · terminal · search · messaging · calendars · payments</text><!-- Value band 2: local-first --><rect class="panel p-cyan" x="43" y="407" width="1714" height="92" rx="10"/>- <text class="h1" x="900" y="437" text-anchor="middle">Everything runs on your computer</text>- <text class="sub" x="900" y="463" text-anchor="middle">Your API keys, your data, your conversations - never sent to OpenCompany servers.</text>- <text class="sub" x="900" y="485" text-anchor="middle">Free local AI via Ollama, LM Studio, or any OpenAI-compatible server such as llama.cpp.</text>+ <text class="h1" x="900" y="437" text-anchor="middle">Run on your own computer. Choose your AI.</text>+ <text class="sub" x="900" y="463" text-anchor="middle">The desktop app keeps employee data locally. Cloud AI and connected apps process the work you send them.</text>+ <text class="sub" x="900" y="485" text-anchor="middle">Use your provider keys or a local model. Provider and connected-service charges and limits apply.</text></svg>