WorkflowsMay 12, 2026·2 min read

CoWork OS — Local-First Agent Workspace

CoWork OS is a local-first agent workspace for code, docs, web pages, and automations, with an Electron UI and built-in support for many MCP connectors.

AI Open Source
AI Open Source · Community
Agent ready

This asset can be read and installed directly by agents

TokRepo exposes a universal CLI command, install contract, metadata JSON, adapter-aware plan, and raw content links so agents can judge fit, risk, and next actions.

Needs Confirmation · 62/100Policy: confirm
Agent surface
Any MCP/CLI agent
Kind
Cli
Install
Manual
Trust
Trust: Established
Entrypoint
git clone https://github.com/CoWork-OS/CoWork-OS && cd CoWork-OS && npm run setup && npm run dev
Universal CLI install command
npx tokrepo install ed99140d-3c1d-5649-bb8b-52f01464fbd7
install contractmetadata JSONadapter planraw content
Intro

CoWork OS is a local-first agent workspace for code, docs, web pages, and automations, with an Electron UI and built-in support for many MCP connectors.

  • Best for: People who want one local app for agentic coding + docs + browser work
  • Works with: Node.js + npm; Electron; optional provider keys (Claude/OpenAI/Gemini/OpenRouter) and MCP connectors (per docs)
  • Setup time: 20–60 minutes

Practical Notes

  • GitHub: 291 stars · 18 forks; pushed 2026-05-12 (verified via GitHub API).
  • Docs docs/getting-started.md uses npm run setup then npm run dev to launch the Electron app + hot reload.
  • README advertises dozens of provider options and many MCP connectors for a single “agent workspace” surface.

Main

Adoption tips:

  1. Start with one workspace and define conventions (branching, lint, CI) so the agent’s edits stay consistent.
  2. Enable only a small set of connectors first; too many tools makes planning noisy and harder to audit.
  3. Use explicit approvals for any action that sends messages, writes to production, or spends money.
  4. Capture “what worked” as repeatable shortcuts and keep them versioned like code.

Local-first is a feature: it keeps files and context near the work, with fewer external dependencies.

FAQ

Q: Is it cloud-based? A: No—README frames it as local-first; your workspace lives on your machine.

Q: Do I need a single LLM provider? A: No—docs list multiple providers and optional failover chains.

Q: How do I keep tool use safe? A: Enable connectors gradually and require approvals for outbound or high-impact actions.

🙏

Source & Thanks

Source: https://github.com/CoWork-OS/CoWork-OS > License: MIT > GitHub stars: 291 · forks: 49

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets

SwarmVault — Local-First LLM Wiki + Graph

SwarmVault turns docs/code/transcripts into a durable Markdown wiki plus a local knowledge graph for agents, with a 30-second `quickstart` CLI path.

CLI Tools
AI Open Source

Codeg — Local AI Coding Workspace (Tauri/Web)

Run Codeg as a standalone server or desktop app to manage local agent workflows, MCP installs, and engineering loops; one-line install is available.

CLI Tools
Script Depot

Local Deep Research — Privacy-First AI Research Agent

A self-hosted deep research agent that achieves near-perfect accuracy on benchmarks using local or cloud LLMs, with support for 10+ search engines and fully encrypted processing.

Scripts
Script Depot

MemPalace — Local-First AI Memory CLI

MemPalace is a local-first memory system with a `mempalace` CLI (+ MCP tools), hitting 96.6% R@5 on LongMemEval with no LLM required.

CLI Tools
Agent Toolkit
◈Home🔍Search👤Me