Getting Started

Installation

There are three ways to install Crewly. Pick whichever suits you best, or visit the download page for more details.

Option 1 — Quick install (macOS / Linux)

$ curl -fsSL https://crewlyai.com/install.sh | bash

Option 2 — npm

$ npm i -g crewly && crewly init

Option 3 — Desktop app

Download the macOS or Windows app from the download page. It includes a setup wizard, system tray controls, and auto-updates.

All three methods end with a fully configured setup. The curl script and desktop app run the interactive onboarding wizard automatically.

Prerequisites

  • Node.js 18+
  • tmux installed on your system
  • At least one AI CLI tool installed:
    • Claude Code — Anthropic's coding agent
    • Gemini CLI — Google's coding agent
    • Codex — OpenAI's coding agent

The onboarding wizard (crewly onboard) can install Claude Code and Gemini CLI for you.

Creating a Team

Open the dashboard and go to the Teams page. Create a team, pick roles (developer, QA, architect, PM, etc.), and choose which AI runtime powers each agent. Start the team and agents will register themselves automatically.

Communicating with Your Team

Talk to your AI team through two channels:

  • Slack — Connect your workspace and chat with agents in dedicated channels with full thread support.
  • Chat UI — Use the built-in chat on the dashboard to send messages and tasks directly.

Knowledge Base & Memory

Store SOPs, architecture docs, and runbooks in the knowledge base. Agents query these automatically when working on tasks. The memory system lets agents persist learnings, patterns, and decisions across sessions — your team gets smarter over time.

Skills Marketplace

Browse the marketplace to find community-built skills, roles, and 3D models for your agents. Install items directly from the dashboard or use the CLI:

$ crewly install --all