👥 OpenStaff — AI Staff Operations

Hire your AI staff. Let them work 24/7.

OpenStaff is a local-first desktop app for operating multiple AI coding agents like a real team. Each Staff runs a continuous loop: Gather -> Execute -> Evaluate. You define each role in plain language, attach skills, and monitor outcomes from one dashboard.

Releases · Product Docs · Screen Specs · Security

Preferred setup: install the desktop app from Releases.

Install (recommended)

Download the latest app package from Releases.

• macOS: .dmg
• Linux: .AppImage / .deb

Install via curl

curl -fsSL https://raw.githubusercontent.com/KoreanThinker/openstaff/main/scripts/install.sh | bash

Optional flags:

• Download only (skip install/open): OPENSTAFF_DOWNLOAD_ONLY=1
• Install to a custom directory: OPENSTAFF_INSTALL_DIR=/path/to/dir
• Pin a specific release: OPENSTAFF_VERSION=v1.1.0

Quick start (TL;DR)

Runtime: Node >= 22, pnpm >= 9.

git clone https://github.com/KoreanThinker/openstaff.git
cd openstaff
pnpm install
pnpm dev

From source (development)

Build distributable packages:

pnpm build:mac
pnpm build:linux

Security defaults (remote access)

• Remote access is off by default.
• Ngrok tunnel requires both API key and auth password.
• Sensitive values are encrypted in local config (electron-store + safeStorage).

Full details: SECURITY.md

Highlights

• Infinite operations loop: every Staff continuously runs Gather -> Execute -> Evaluate.
• Multi-agent support: run Staff with Claude Code, OpenAI Codex, or Google Gemini CLI.
• Multi-staff orchestration: run specialized Staff in parallel for different business functions.
• Live monitoring: track cycles, token usage, costs, logs, and KPIs in real time.
• Skill system: install reusable SKILL.md skills from registry or local folders.
• Remote dashboard access: connect securely through Ngrok with password protection.
• Slack alerts: optional webhook alerts for staff errors, pauses, and budget warnings.
• Local-first storage: data stays on your machine under ~/.openstaff.

How it works (short)

┌──────────────────────────────────────────────┐
│                OpenStaff App                 │
│                                              │
│  React UI  <-->  Main Process API/WebSocket │
│                      │                       │
│                 Staff Manager                │
│                      │                       │
│   Agent Drivers (Claude/Codex/Gemini CLI)    │
└──────────────────────────────────────────────┘
                       │
                 ~/.openstaff/

Star History

License

MIT