Overview
Learn how to use Fleet — an AI agent desktop app that runs locally on your Mac. Create agents, build automations, and manage your AI workflows.
What is Fleet?
Fleet is a local, high-performance AI agent desktop app that lets you create, manage, and run autonomous AI agents on your Mac. Everything runs on your machine—your data stays with you.
Agents in Fleet can:
- Execute tasks using tools (browser, terminal, file operations)
- Maintain persistent memory across sessions
- Automate via triggers (schedules, webhooks, file watchers, git hooks)
- Collaborate through multi-agent workflows
- Connect to external services via MCP
Getting Started
New to Fleet? Start here:
- Installation & Setup — Download Fleet and configure your first AI provider
- Your First Agent — Create an agent and start chatting
- Quick Reference — Keyboard shortcuts and agent states
Tutorials
Step-by-step guides for common tasks:
- Build a Code Review Agent — Create a specialized code reviewer
- Automate with Triggers — Set up file watchers, schedules, and webhooks
- Multi-Agent Workflows — Coordinate multiple agents
Core Concepts
Understand how Fleet works:
- Agents — Create and manage AI agents that think, plan, and execute
- Skills — Build reusable capabilities for agents
- Triggers — Automate with schedules, webhooks, file watchers, and git hooks
- MCP Servers — Connect to external tools via Model Context Protocol
- Lifecycle Hooks — Execute custom logic during agent execution
Reference
Look up specific information:
- AGENT.md Format — Complete agent configuration reference
- Trigger Types — All 7 trigger types with examples
- Tools Reference — All tools agents can use
- AI Providers — Connect Claude, OpenAI, Ollama, and more
- Settings — Customize Fleet to your workflow
- Security & Permissions — Control what agents can do
Examples
See Fleet in action:
- Automation Examples — Common workflows and use cases
- Agent Examples — Complete AGENT.md files to copy
Advanced
Explore advanced features:
- Inter-Agent Communication — Agents messaging each other
- Remote Gateway — Receive webhooks from external services
- CLI Reference — Run Fleet from the command line
Quick Reference
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
| Cmd+N | Create a new agent |
| Cmd+, | Open Settings |
| Cmd+Shift+F | Global Search |
| Cmd+K | Open command palette |
| Cmd+L | Focus chat input |
| Cmd+B | Toggle sidebar |
| Cmd+P | Pause/resume agent |
| Cmd+Shift+C | Compact conversation history |
Agent States
| State | Meaning |
|---|---|
| Idle | Waiting for input |
| Running | Actively processing your request |
| Paused | Execution paused by you |
| Waiting | Waiting for sub-agents or triggers |
| Awaiting Approval | Needs permission to execute a tool |
| Awaiting Secret | Requesting sensitive input |
| Awaiting QA Response | Waiting for your answer |
| Completed | Task finished successfully |
| Error | Something went wrong |
Need Help?
- Browse the documentation sections above
- Review automation examples
- Check agent examples for templates