Skip to content

OpenSource Claude Cowork. A desktop AI assistant that helps you with programming, file management, and any task you can describe.

Notifications You must be signed in to change notification settings

DevAgentForge/Claude-Cowork

Repository files navigation

简体中文

Claude Cowork

A desktop AI assistant that helps you with programming, file management, and any task you can describe.

It is fully compatible with the exact same configuration as Claude Code, which means you can run it with any Anthropic-compatible large language model.

Not just a GUI.
A real AI collaboration partner.
No need to learn the Claude Agent SDK — just create tasks and choose execution paths.

An example of organizing a local folder:

agent-cowork-demo.mp4

✨ Why Claude Cowork?

Claude Code is powerful — but it only runs in the terminal.

That means:

  • ❌ No visual feedback for complex tasks
  • ❌ Hard to track multiple sessions
  • ❌ Tool outputs are inconvenient to inspect

Agent Cowork solves these problems:

  • 🖥️ Runs as a native desktop application
  • 🤖 Acts as your AI collaboration partner for any task
  • 🔁 Reuses your existing ~/.claude/settings.json
  • 🧠 100% compatible with Claude Code

If Claude Code works on your machine —
Agent Cowork works too.


🚀 Quick Start

Before using Agent Cowork, make sure Claude Code is installed and properly configured.

Option 1: Download a Release

👉 Go to Releases


Option 2: Build from Source

Prerequisites

bash

Clone the repository

git clone https://github.com/DevAgentForge/agent-cowork.git cd agent-cowork

Install dependencies

bun install

Run in development mode

bun run dev

Or build production binaries

bun run dist:mac # macOS bun run dist:win # Windows bun run dist:linux # Linux `


🧠 Core Capabilities

🤖 AI Collaboration Partner — Not Just a GUI

Agent Cowork is your AI partner that can:

  • Write and edit code — in any programming language
  • Manage files — create, move, and organize
  • Run commands — build, test, deploy
  • Answer questions — about your codebase
  • Do anything — as long as you can describe it in natural language

📂 Session Management

  • Create sessions with custom working directories
  • Resume any previous conversation
  • Complete local session history (stored in SQLite)
  • Safe deletion and automatic persistence

🎯 Real-Time Streaming Output

  • Token-by-token streaming output
  • View Claude’s reasoning process
  • Markdown rendering with syntax-highlighted code
  • Visualized tool calls with status indicators

🔐 Tool Permission Control

  • Explicit approval required for sensitive actions
  • Allow or deny per tool
  • Interactive decision panels
  • Full control over what Claude is allowed to do

🔁 Fully Compatible with Claude Code

Agent Cowork shares configuration with Claude Code.

It directly reuses:

text ~/.claude/settings.json

This means:

  • Same API keys
  • Same base URL
  • Same models
  • Same behavior

Configure Claude Code once — use it everywhere.


🧩 Architecture Overview

Layer Technology
Framework Electron 39
Frontend React 19, Tailwind CSS 4
State Management Zustand
Database better-sqlite3 (WAL mode)
AI @anthropic-ai/claude-agent-sdk
Build Vite, electron-builder

🛠 Development

bash

Start development server (hot reload)

bun run dev

Type checking / build

bun run build


🗺 Roadmap

Planned features:

  • GUI-based configuration for models and API keys
  • 🚧 More features coming soon

🤝 Contributing

Pull requests are welcome.

  1. Fork this repository
  2. Create your feature branch
  3. Commit your changes
  4. Open a Pull Request

⭐ Final Words

If you’ve ever wanted:

  • A persistent desktop AI collaboration partner
  • Visual insight into how Claude works
  • Convenient session management across projects

This project is built for you.

👉 If it helps you, please give it a Star.


License

MIT

About

OpenSource Claude Cowork. A desktop AI assistant that helps you with programming, file management, and any task you can describe.

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages