GitHub - outworked/outworked: Một văn phòng ảo với AI

Outworked

AI agent orchestration với giao diện văn phòng 8-bit.

Outworked biến các agent AI thành nhân viên văn phòng bạn có thể thấy và quản lý. Hãy tưởng tượng Animal Crossing và Claude Code kết hợp tạo ra một văn phòng pixel-art dễ thương.

Outworked Screenshot

Tính Năng

Văn Phòng Ảo: Văn phòng 8-bit sử dụng Phaser, nơi các agent có thể đi lại, ngồi và hợp tác trong thời gian thực.
Tùy Chỉnh Agent: Đặt tên, vai trò, cá tính (hệ thống prompt), model và sprite cho từng agent.
Điều Phối Nhiệm Vụ: Mô tả mục tiêu và hệ thống tự phân tách thành nhiệm vụ, gán cho agent.
Tích Hợp Claude Code: Agent chạy các phiên làm việc Claude Code với đầy đủ quyền truy cập công cụ.
Chat Trực Tiếp: Hỗ trợ hội thoại kết hợp mã code với đánh dấu cú pháp và thay đổi khác biệt.
Bảng Git: Xem trạng thái, thay đổi chuẩn bị, nhánh và tạo PR không cần rời app.
Trình Duyệt File: Cây thư mục cập nhật trực tiếp khi agent chỉnh sửa file.
Hệ Thống Kỹ Năng: Tích hợp kỹ năng qua các file SKILL.md (GitHub, Whisper, Apple Notes, PDF, v.v.)
Giao Tiếp Giữa Các Agent: Agent phối hợp dùng [ASK:AgentName] và message bus.
Bảng Điều Khiển Chi Phí: Theo dõi token và chi tiêu theo agent, session và ngày.
Quyền Hạn & An Toàn: Danh sách cấp phép, giới hạn thư mục làm việc, nhật ký audit và xác nhận lệnh nguy hiểm.
Thông Báo Desktop: Nhận thông báo khi nhiệm vụ hoàn thành hoặc cần phê duyệt.
Âm Thanh 8-Bit: Văn phòng cần âm nhạc.

Cài Đặt

Cách dễ nhất để bắt đầu là tải về .dmg từ GitHub Releases và kéo vào thư mục Ứng dụng.

Yêu Cầu Trước

Claude Code đã cài đặt và xác thực.

Từ Mã Nguồn

# Yêu cầu Node.js v18+
npm install
npm run electron:dev

Khi khởi chạy lần đầu, modal giới thiệu sẽ hướng dẫn bạn chọn workspace và tạo agent đầu tiên.

Scripts

Command	Description
`npm run dev`	Khởi động Vite dev server (chỉ browser, không có Electron)
`npm run electron:dev`	Xây dựng và khởi chạy đầy đủ ứng dụng Electron
`npm run electron:build`	Đóng gói phân phối (dmg/zip trên macOS, exe trên Windows, AppImage trên Linux)

Tech Stack

Desktop: Electron
Frontend: React 19 + TypeScript + Tailwind CSS
Build: Vite
Graphics: Phaser 3
AI: Claude Code

Cấu Trúc Dự Án

src/
├── components/       # UI React (ChatWindow, OfficeCanvas, GitPanel, v.v.)
├── lib/              # Logic cốt lõi (AI, điều phối, terminal, lưu trữ, chi phí)
├── basic-skills/     # Các module SKILL.md tích hợp sẵn (github, whisper, v.v.)
└── phaser/           # Cảnh game và logic sprite Phaser
electron/
├── main.js           # Quá trình chính của Electron (IPC, shell, permissions)
└── preload.js        # Cầu nối ngữ cảnh tới renderer
public/
├── sprites/          # Các sheet sprite nhân vật 8-bit
├── backgrounds/      # Hình nền văn phòng
└── music/            # Các track nhạc nền

Kỹ Năng

Outworked sử dụng định dạng SKILL.md — các file markdown có phần đầu YAML để định nghĩa nhiệm vụ agent có thể thực hiện. Kỹ năng tích hợp sẵn bao gồm:

github — Truy cập API GitHub
openai-whisper — Chuyển giọng nói thành văn bản
apple-notes / apple-reminders — Tích hợp ứng dụng macOS
nano-pdf — Đọc và trích xuất PDF
mcporter — Hỗ trợ server MCP

Bạn có thể tạo kỹ năng tùy chỉnh và gán cho từng agent.

Mô Hình An Toàn

Outworked áp dụng biện pháp bảo vệ từng lớp:

Yêu cầu phê duyệt rõ ràng trước các lệnh nguy hiểm (xóa, cài đặt, thay đổi mạng)
Danh sách chấp nhận/từ chối cho các lệnh shell được phép
Giới hạn thư mục làm việc
Thời gian chờ có thể cấu hình cho các tác vụ chạy lâu
Nhật ký và theo dõi đầy đủ
Các agent lập kế hoạch trước khi thực thi
Bảng điều khiển quyền để xem xét và quản lý truy cập

Giấy Phép

GPL-3.0