Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
npx -y [email protected]Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
claude mcp add crewly -- npx -y crewly@1.30.0รันในเทอร์มินัล
{ "mcpServers": { "crewly": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดYour judgment, run by an AI crew.
You're closest to the problem. Crewly gives you an AI crew that works the way you'd decide — even when you're not in the room.
Under the hood, Crewly is an open-source multi-agent orchestration platform that coordinates AI coding agents (Claude Code, Gemini CLI, Codex, OpenCode) to work together as a team. It provides a web dashboard for real-time monitoring, task management, and team coordination — all running locally on your machine.
curl -fsSL https://crewlyai.com/install.sh | bash
The installer needs no sudo: if your global npm folder is not writable (a system Node on Linux), it installs Crewly under ~/.crewly/npm-global and adds that to your PATH. Then it runs the setup wizard (the same as crewly init). When it finishes, open a new terminal and run:
crewly start
Prefer npm? With Node from nvm, fnm or Homebrew (your user owns the global npm folder):
npm install -g crewly
crewly init
crewly start
EACCES: permission denied from npm install -g on Linux? A system Node (from apt, NodeSource or the official Docker images) keeps its global packages under /usr/local, which a normal user cannot write. Do not use sudo. Install into your home folder instead, which is what the installer script does, and crewly upgrade keeps using that folder:
npm install -g --prefix ~/.crewly/npm-global crewly
echo 'export PATH="$HOME/.crewly/npm-global/bin:$PATH"' >> ~/.bashrc # ~/.zshrc for zsh
export PATH="$HOME/.crewly/npm-global/bin:$PATH"
crewly init
crewly start
The init command walks you through provider selection, installs agent skills, and scaffolds a .crewly/ directory. Then crewly start launches the backend server and prints the web dashboard URL (add --open or set CREWLY_OPEN_BROWSER=1 to open it). From there:
Node.js 22 or later (with npm). Node 20 is end-of-life and its better-sqlite3 has no prebuilt binary.
No C/C++ toolchain on macOS (x64/arm64) or glibc Linux (x64/arm64). The native modules install from prebuilt binaries there. You do need python3, make and g++ (Xcode Command Line Tools on macOS) in these cases:
node-pty compiles from sourcebetter-sqlite3 fetches its binary from GitHub at install time and compiles from source if it cannotOn Debian/Ubuntu, install the toolchain with sudo apt-get install -y python3 make g++. crewly doctor tells you whether you need it.
jq (brew install jq on macOS, sudo apt-get install -y jq on Debian/Ubuntu). Agent skills use it, and crewly init stops if it is missing.
curl
One AI coding CLI, installed and logged in: Claude Code (claude), Gemini CLI (gemini) or Codex (codex). OpenCode also works.
A normal user account, not root. Run Crewly as a normal user, not with sudo or as root. Claude Code refuses to start its agents under root.
tmux is not required.
API keys: Gemini CLI requires GEMINI_API_KEY. On a Gemini agent's first run, answer its two terminal prompts: authentication (Use Gemini API Key) and folder trust (Yes). Codex requires an OpenAI API key. Claude Code: run claude once in a terminal, finish its first-run setup (choose a theme) and log in before you start a team. A Claude agent cannot get past those screens on its own. OpenCode uses whichever provider you connect via opencode auth login (or the ANTHROPIC_API_KEY / OPENAI_API_KEY / GEMINI_API_KEY env vars Crewly already exports to agent sessions).
┌─────────────────────────────────────────────────────┐
│ Web Dashboard │
│ (React + xterm.js + WebSocket) │
└───────────────────────┬─────────────────────────────┘
│
┌───────────────────────▼─────────────────────────────┐
│ Backend Server │
│ (Express + Socket.IO + PTY) │
│ │
│ ┌──────────┐ ┌──────────┐ ┌───────────────────┐ │
│ │ Services │ │ Scheduler│ │ Agent Registration │ │
│ │ (Storage,│ │ (Check- │ │ (Heartbeat, Idle │ │
│ │ Memory) │ │ ins) │ │ Detection, Resume)│ │
│ └──────────┘ └──────────┘ └───────────────────┘ │
└───────────────────────┬─────────────────────────────┘
│
┌───────────────┼───────────────┐
▼ ▼ ▼
┌──────────────┐ ┌─────────────┐ ┌─────────────┐
│ Agent PTY │ │ Agent PTY │ │ Agent PTY │
│ (Claude) │ │ (Gemini) │ │ (Codex) │
│ │ │ │ │ │
│ Skills ◄────┤ │ Skills ◄───┤ │ Skills ◄───┤
│ Memory ◄────┤ │ Memory ◄───┤ │ Memory ◄───┤
└──────────────┘ └─────────────┘ └─────────────┘
Storage: ~/.crewly/ (global) + project/.crewly/ (per-project)
You can change the default runtime or customize launch commands in Settings.
crewly init # Interactive setup wizard (alias: onboard)
crewly start # Start backend (prints dashboard URL; --open to open it)
crewly stop # Stop all services and sessions
crewly status # Show running services
crewly logs # View aggregated logs
crewly upgrade # Upgrade to latest version
crewly install [id] # Install a skill from marketplace
crewly search [q] # Search skill marketplace
crewly token # Print the API token remote callers must send (--url: dashboard link)
crewly security scrub-logs # Count API keys/tokens left in session logs + shell history (--apply: mask them)
Optional environment variables (.env file or shell):
GEMINI_API_KEY=your_key_here # Required for Gemini CLI runtime
SLACK_BOT_TOKEN=xoxb-... # Optional: self-hosted Slack app (see "Slack" below)
SLACK_APP_TOKEN=xapp-...
SLACK_SIGNING_SECRET=...
CREWLY_SLACK_SOURCE=cloud # Optional: env | cloud (unset = last connected source, else self-hosted, when both exist)
CREWLY_SLACK_PRIMARY=1 # Optional: this instance handles DMs / unmapped channels
LOG_LEVEL=info # debug, info, warn, error
WEB_PORT=8787 # Dashboard port (default: 8787)
CREWLY_BIND_HOST=0.0.0.0 # Interface to listen on (127.0.0.1 = this machine only)
CREWLY_API_TOKEN=... # Pin the API token (otherwise generated at ~/.crewly/api-token)
One click (recommended). Log in to Crewly Cloud (Settings → Cloud), open
Settings → Integrations → Slack and press Connect Slack. Slack asks you to
approve the Crewly app once; from then on every Crewly instance signed in to the
same Crewly account gets Slack automatically — team channels, and one real Slack
bot user per agent — with no tokens to copy. The instance pulls its config from
Cloud on boot and every 10 minutes (cached 0600 at
~/.crewly/slack-cloud-config.json); Slack events reach it through the Cloud
relay, so no Socket Mode connection is opened.
The one manual step. Slack only lets an app be created by an App
Configuration Token of a workspace member, and Crewly creates one Slack app per
agent so each agent is a real bot user (name in the member list, native @
mentions). Generate the token at api.slack.com/apps ("Your App Configuration
Tokens" → Generate) and paste it in Settings → Slack → Agent Identities. Cloud
keeps it refreshed. Each new agent then shows an install link you click once.
Several instances, one workspace. Every instance registers its teams,
channels and agents with Cloud (on boot, on team changes, every 5 min); Slack
traffic for a team channel goes to the instance running that team. Direct
messages to the Crewly bot and channels no team owns go to the primary
instance — the Settings toggle, or CREWLY_SLACK_PRIMARY=1.
Self-hosted app. The original path (your own Slack app, Socket Mode,
SLACK_BOT_TOKEN / SLACK_APP_TOKEN / SLACK_SIGNING_SECRET or the form under
Settings → Slack → Advanced) still works. CREWLY_SLACK_SOURCE picks the source:
cloud uses only the Cloud workspace, env uses only local tokens and never
asks Cloud. Unset, when both exist, a restart keeps the app that was last
connected (with none recorded, the self-hosted app) and logs a warning — the
two are different bot users, so switching silently would break every channel of
the other one. The other app is used only if the chosen one cannot connect.
Switch explicitly with PUT /api/slack/source {"source":"env"|"cloud"}.
GET /api/slack/status reports the connected source and turns degraded
(with degradedReason) when posts keep failing with channel_not_found /
not_in_channel.
Crewly agents run as real shells on the host, and POST /api/terminal/:session/write
types into them — so the API must not be open to the network. The rules:
127.0.0.1 / ::1 (local skills via
api_call, the dashboard at http://localhost:8787) work with zero setup, as before./api/*, Socket.IO and WebSocket
connections: Authorization: Bearer <token>, X-Crewly-Token: <token>, a
crewly_token cookie, or ?token= for WebSocket handshakes. Missing/invalid → 401 {"error":"unauthorized"}. X-Forwarded-For is only honoured with CREWLY_TRUST_PROXY=1.CREWLY_API_TOKEN if set, otherwise generated on first boot and stored
(mode 0600) at ~/.crewly/api-token. Print it with crewly token; crewly token --url
prints a ready-to-open http://<lan-ip>:8787/?token=… link — the dashboard stores the
token once and strips it from the address bar. Otherwise the dashboard asks for it the
first time a request is refused.CREWLY_BIND_HOST=127.0.0.1 and reach the box over SSH
(ssh -L 8787:localhost:8787 user@host) or a VPN. Headless installs that bind every
interface with neither variable set log a WARN at startup.POST /api/missions/:id/approve|reject require the
token even from loopback and refuse agent sessions (403 owner_approval_required);
agent PTYs never inherit CREWLY_API_TOKEN./health needs the token from other addresses too (since #825). Loopback gets the
same response as before. Any other address without the token gets the same 401 as
/api, so a phone on your Wi-Fi without the token falls back to the Cloud relay instead
of picking a LAN connection it cannot use. If you monitor /health from another
machine (uptime checker, load balancer, a reverse proxy in front of Docker), either
send the token or set CREWLY_PUBLIC_HEALTH=1 to keep it open. Behind Docker's port
mapping even curl localhost:8787/health on the host is a non-loopback call; the
container's own HEALTHCHECK runs inside the container and is unaffected.POST /api/cloud/mobile-pair
is token-gated like everything else (it hands out the Cloud session).Run Crewly with a single command using Docker:
# 1. Clone the repo
git clone https://github.com/stevehuang0115/crewly.git
cd crewly
# 2. Add your API keys to .env
cp .env.example .env
# Edit .env and add ANTHROPIC_API_KEY, GEMINI_API_KEY, etc.
# 3. Start Crewly
docker compose up
# Dashboard available at http://localhost:8787
To mount a project directory for agents to work on, edit docker-compose.yml and uncomment the volume mount:
volumes:
- crewly_data:/home/node/.crewly
- /path/to/your/project:/home/node/project # <-- uncomment and edit
Build the image manually:
# On Apple Silicon, use --platform linux/amd64
docker build --platform linux/amd64 -t crewly .
docker run -p 8787:8787 --env-file .env crewly
# Clone the repository
git clone https://github.com/stevehuang0115/crewly.git
cd crewly
# Install dependencies
npm install
# Build all components (backend + frontend + CLI)
npm run build
# Start in dev mode (backend + frontend with hot-reload)
npm run dev
# Run tests
npm run test:unit
See CONTRIBUTING.md for detailed development guidelines.
Screenshots and demo video coming soon. Star the repo to get notified!
Multi-agent orchestration platform for AI coding teams — coordinates Claude Code, Gemini CLI, and Codex agents with a real-time web dashboard
{ "mcpServers": { "crewly": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Crewly ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-14 Multi-agent orchestration platform for AI coding teams — coordinates Claude Code, Gemini CLI, and Codex agents with a real-time web dashboard