Familiar logo
Familiar usefamiliar.com
Documentation / Fleet

Installation & Setup

Install Fleet, set up your first AI provider, and create your first agent in minutes.

System Requirements

  • macOS 12.0 (Monterey) or later
  • 8GB RAM minimum (16GB+ recommended for local models)
  • 500MB disk space for Fleet
  • Additional space for agent workspaces and conversations

Installation

Download Fleet

  1. Go to the Fleet download page
  2. Download the latest version for macOS
  3. Open the .dmg file
  4. Drag Fleet.app to your Applications folder
  5. Launch Fleet from Applications (or Spotlight: Cmd+Space, type "Fleet")

Directory Structure

Fleet stores data in your Application Support folder:

~/Library/Application Support/com.usefamiliar.desktop/
├── agents/           # Agent definitions (AGENT.md files)
├── workspaces/       # Agent workspace files
├── conversations/    # Conversation history
├── skills/           # Installed skills
├── triggers/         # Trigger definitions
├── plans/            # Planning documents
├── config.yaml       # Global configuration
└── fleet.db          # Database

How Fleet Runs

Fleet is a menubar application. When you close the window, Fleet keeps running in your menu bar — your agents and automations stay active.

  • Open the window — Click the menu bar icon → Select Open
  • Quit Fleet — Click the menu bar icon → Select Quit

Sleep & Wake Behavior

When your Mac goes to sleep, automations pause. When it wakes:

  • Poll triggers run immediately if their interval passed during sleep
  • Scheduled tasks fire immediately if their time passed during sleep
  • Daemon triggers resume automatically

Your automations catch up on missed work when your Mac wakes.

Set Up Your First AI Provider

Before creating agents, connect an AI provider.

Fleet settings showing provider configuration

GLM Coding Plan (Recommended)

The GLM Coding Plan from z.ai provides access to Claude and other top models, optimized for coding tools like Fleet, Claude Code, and Cline — starting at just $3/month:

  1. Subscribe at z.ai
  2. Get your API key from the dashboard
  3. Open Settings (Cmd+,)
  4. Go to General tab
  5. Click OpenRouter (GLM uses OpenRouter-compatible API)
  6. Enter your API key
  7. Toggle Enable

See AI Providers for other options.

Create Your First Agent

  1. Click New Agent (Cmd+N)
  2. Name it something simple like "Helper"
  3. Choose your provider (e.g., Claude API)
  4. Choose a model
  5. Click Create
  6. Start chatting

For a detailed walkthrough, see Your First Agent.

Next Steps