# Crewlabs Agent

> The self-improving AI agent built by CrewLabs. A terminal-native autonomous coding and task agent with persistent memory, agent-created skills, and a messaging gateway that lives on 21+ messaging platforms — 19 native to the gateway plus IRC and Microsoft Teams via plugins (Telegram, Discord, Slack, SMS, Matrix, ...). Runs on local, Docker, SSH, Daytona, Modal, or Singularity backends. Works with Nous Portal, OpenRouter, OpenAI, Anthropic, Google, or any OpenAI-compatible endpoint.

Install: `curl -fsSL https://raw.githubusercontent.com/CrewLabs/crewlabs-agent/main/scripts/install.sh | bash`  (Linux, macOS, WSL2, Termux)

Repo: https://github.com/CrewLabs/crewlabs-runtime-v2

## Getting Started

- [Installation](https://crewlabs-agent.crewlabs.net/docs/getting-started/installation): Install Crewlabs Agent on Linux, macOS, WSL2, native Windows (early beta), or Android via Termux
- [Quickstart](https://crewlabs-agent.crewlabs.net/docs/getting-started/quickstart): Your first conversation with Crewlabs Agent — from install to chatting in under 5 minutes
- [Learning Path](https://crewlabs-agent.crewlabs.net/docs/getting-started/learning-path): Choose your learning path through the Crewlabs Agent documentation based on your experience level and goals.
- [Updating](https://crewlabs-agent.crewlabs.net/docs/getting-started/updating): How to update Crewlabs Agent to the latest version or uninstall it
- [Termux (Android)](https://crewlabs-agent.crewlabs.net/docs/getting-started/termux): Run Crewlabs Agent directly on an Android phone with Termux
- [Nix Setup](https://crewlabs-agent.crewlabs.net/docs/getting-started/nix-setup): Install and deploy Crewlabs Agent with Nix — from quick `nix run` to fully declarative NixOS module with container mode

## Using Crewlabs

- [CLI](https://crewlabs-agent.crewlabs.net/docs/user-guide/cli): Master the Crewlabs Agent terminal interface — commands, keybindings, personalities, and more
- [TUI (Ink terminal UI)](https://crewlabs-agent.crewlabs.net/docs/user-guide/tui): Launch the modern terminal UI for Crewlabs — mouse-friendly, rich overlays, and non-blocking input.
- [Configuration](https://crewlabs-agent.crewlabs.net/docs/user-guide/configuration): Configure Crewlabs Agent — config.yaml, providers, models, API keys, and more
- [Configuring Models](https://crewlabs-agent.crewlabs.net/docs/user-guide/configuring-models)
- [Sessions](https://crewlabs-agent.crewlabs.net/docs/user-guide/sessions): Session persistence, resume, search, management, and per-platform session tracking
- [Profiles](https://crewlabs-agent.crewlabs.net/docs/user-guide/profiles)
- [Git Worktrees](https://crewlabs-agent.crewlabs.net/docs/user-guide/git-worktrees): Run multiple Crewlabs agents safely on the same repository using git worktrees and isolated checkouts
- [Docker Backend](https://crewlabs-agent.crewlabs.net/docs/user-guide/docker): Running Crewlabs Agent in Docker and using Docker as a terminal backend
- [Security](https://crewlabs-agent.crewlabs.net/docs/user-guide/security): Security model, dangerous command approval, user authorization, container isolation, and production deployment best practices
- [Checkpoints & Rollback](https://crewlabs-agent.crewlabs.net/docs/user-guide/checkpoints-and-rollback): Filesystem safety nets for destructive operations using shadow git repos and automatic snapshots

## Core Features

- [Features Overview](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/overview)
- [Tools](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/tools): Overview of Crewlabs Agent's tools — what's available, how toolsets work, and terminal backends
- [Skills System](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/skills): On-demand knowledge documents — progressive disclosure, agent-managed skills, and the Skills Hub
- [Curator](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/curator): Background maintenance for agent-created skills — usage tracking, staleness, archival, and LLM-driven review
- [Memory](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/memory): How Crewlabs Agent remembers across sessions — MEMORY.md, USER.md, and session search
- [Memory Providers](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/memory-providers): External memory provider plugins — Honcho, OpenViking, Mem0, Hindsight, Holographic, RetainDB, ByteRover, Supermemory
- [Context Files](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/context-files): Project context files — .crewlabs.md, AGENTS.md, CLAUDE.md, global SOUL.md, and .cursorrules — automatically injected into every conversation
- [Context References](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/context-references): Inline @-syntax for attaching files, folders, git diffs, and URLs directly into your messages
- [Personality & SOUL.md](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/personality): Customize Crewlabs Agent's personality with a global SOUL.md, built-in personalities, and custom persona definitions
- [Plugins](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/plugins): Extend Crewlabs with custom tools, hooks, and integrations via the plugin system
- [Built-in Plugins](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/built-in-plugins): Plugins shipped with Crewlabs Agent that run automatically via lifecycle hooks — disk-cleanup and friends

## Automation

- [Cron Jobs](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/cron): Schedule automated tasks with natural language, manage them with one cron tool, and attach one or more skills
- [Delegation](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/delegation): Spawn isolated child agents for parallel workstreams with delegate_task
- [Kanban Multi-Agent](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/kanban): Durable SQLite-backed task board for coordinating multiple Crewlabs profiles
- [Kanban Tutorial](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/kanban-tutorial)
- [Persistent Goals](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/goals): Set a standing goal and let Crewlabs keep working across turns until it's done. Our take on the Ralph loop.
- [Code Execution](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/code-execution): Programmatic Python execution with RPC tool access — collapse multi-step workflows into a single turn
- [Hooks](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/hooks): Run custom code at key lifecycle points — log activity, send alerts, post to webhooks
- [Batch Processing](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/batch-processing): Generate agent trajectories at scale — parallel processing, checkpointing, and toolset distributions

## Media & Web

- [Voice Mode](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/voice-mode): Real-time voice conversations with Crewlabs Agent — CLI, Telegram, Discord (DMs, text channels, and voice channels)
- [Browser](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/browser)
- [Vision](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/vision)
- [Image Generation](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/image-generation)
- [Text-to-Speech](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/tts): Text-to-speech and voice message transcription across all platforms

## Messaging Platforms

- [Overview](https://crewlabs-agent.crewlabs.net/docs/user-guide/messaging/index): Chat with Crewlabs from Telegram, Discord, Slack, WhatsApp, Signal, SMS, Email, Home Assistant, Mattermost, Matrix, DingTalk, Yuanbao, Microsoft Teams, LINE, Webhooks, or any OpenAI-compatible frontend via the API server — architecture and setup overview
- [Telegram](https://crewlabs-agent.crewlabs.net/docs/user-guide/messaging/telegram): Set up Crewlabs Agent as a Telegram bot
- [Discord](https://crewlabs-agent.crewlabs.net/docs/user-guide/messaging/discord): Set up Crewlabs Agent as a Discord bot
- [Slack](https://crewlabs-agent.crewlabs.net/docs/user-guide/messaging/slack): Set up Crewlabs Agent as a Slack bot using Socket Mode
- [WhatsApp](https://crewlabs-agent.crewlabs.net/docs/user-guide/messaging/whatsapp): Set up Crewlabs Agent as a WhatsApp bot via the built-in Baileys bridge
- [Signal](https://crewlabs-agent.crewlabs.net/docs/user-guide/messaging/signal): Set up Crewlabs Agent as a Signal messenger bot via signal-cli daemon
- [Email](https://crewlabs-agent.crewlabs.net/docs/user-guide/messaging/email): Set up Crewlabs Agent as an email assistant via IMAP/SMTP
- [SMS](https://crewlabs-agent.crewlabs.net/docs/user-guide/messaging/sms): Set up Crewlabs Agent as an SMS chatbot via Twilio
- [Matrix](https://crewlabs-agent.crewlabs.net/docs/user-guide/messaging/matrix): Set up Crewlabs Agent as a Matrix bot
- [Mattermost](https://crewlabs-agent.crewlabs.net/docs/user-guide/messaging/mattermost): Set up Crewlabs Agent as a Mattermost bot
- [Home Assistant](https://crewlabs-agent.crewlabs.net/docs/user-guide/messaging/homeassistant)
- [Webhooks](https://crewlabs-agent.crewlabs.net/docs/user-guide/messaging/webhooks): Receive events from GitHub, GitLab, and other services to trigger Crewlabs agent runs

## Integrations

- [Integrations Overview](https://crewlabs-agent.crewlabs.net/docs/integrations/index)
- [Providers](https://crewlabs-agent.crewlabs.net/docs/integrations/providers)
- [MCP (Model Context Protocol)](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/mcp): Connect Crewlabs Agent to external tool servers via MCP — and control exactly which MCP tools Crewlabs loads
- [ACP (Agent Context Protocol)](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/acp): Use Crewlabs Agent inside ACP-compatible editors such as VS Code, Zed, and JetBrains
- [API Server](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/api-server): Expose crewlabs-agent as an OpenAI-compatible API for any frontend
- [Honcho Memory](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/honcho): AI-native persistent memory via Honcho — dialectic reasoning, multi-agent user modeling, and deep personalization
- [Provider Routing](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/provider-routing)
- [Fallback Providers](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/fallback-providers)
- [Credential Pools](https://crewlabs-agent.crewlabs.net/docs/user-guide/features/credential-pools)

## Guides & Tutorials

- [Tips & Best Practices](https://crewlabs-agent.crewlabs.net/docs/guides/tips): Practical advice to get the most out of Crewlabs Agent — prompt tips, CLI shortcuts, context files, memory, cost optimization, and security
- [Local LLMs on Mac](https://crewlabs-agent.crewlabs.net/docs/guides/local-llm-on-mac): Set up a local OpenAI-compatible LLM server on macOS with llama.cpp or MLX, including model selection, memory optimization, and real benchmarks on Apple Silicon
- [Daily Briefing Bot](https://crewlabs-agent.crewlabs.net/docs/guides/daily-briefing-bot): Build an automated daily briefing bot that researches topics, summarizes findings, and delivers them to Telegram or Discord every morning
- [Team Telegram Assistant](https://crewlabs-agent.crewlabs.net/docs/guides/team-telegram-assistant): Step-by-step guide to setting up a Telegram bot that your whole team can use for code help, research, system admin, and more
- [Use Crewlabs as a Python Library](https://crewlabs-agent.crewlabs.net/docs/guides/python-library): Embed AIAgent in your own Python scripts, web apps, or automation pipelines — no CLI required
- [Use MCP with Crewlabs](https://crewlabs-agent.crewlabs.net/docs/guides/use-mcp-with-crewlabs): A practical guide to connecting MCP servers to Crewlabs Agent, filtering their tools, and using them safely in real workflows
- [Use Voice Mode with Crewlabs](https://crewlabs-agent.crewlabs.net/docs/guides/use-voice-mode-with-crewlabs): A practical guide to setting up and using Crewlabs voice mode across CLI, Telegram, Discord, and Discord voice channels
- [Use SOUL.md with Crewlabs](https://crewlabs-agent.crewlabs.net/docs/guides/use-soul-with-crewlabs): How to use SOUL.md to shape Crewlabs Agent's default voice, what belongs there, and how it differs from AGENTS.md and /personality
- [Build a Crewlabs Plugin](https://crewlabs-agent.crewlabs.net/docs/guides/build-a-crewlabs-plugin): Step-by-step guide to building a complete Crewlabs plugin with tools, hooks, data files, and skills
- [Automate with Cron](https://crewlabs-agent.crewlabs.net/docs/guides/automate-with-cron): Real-world automation patterns using Crewlabs cron — monitoring, reports, pipelines, and multi-skill workflows
- [Work with Skills](https://crewlabs-agent.crewlabs.net/docs/guides/work-with-skills): Find, install, use, and create skills — on-demand knowledge that teaches Crewlabs new workflows
- [Delegation Patterns](https://crewlabs-agent.crewlabs.net/docs/guides/delegation-patterns): When and how to use subagent delegation — patterns for parallel research, code review, and multi-file work
- [GitHub PR Review Agent](https://crewlabs-agent.crewlabs.net/docs/guides/github-pr-review-agent): Build an automated AI code reviewer that monitors your repos, reviews pull requests, and delivers feedback — hands-free

## Developer Guide

- [Contributing](https://crewlabs-agent.crewlabs.net/docs/developer-guide/contributing): How to contribute to Crewlabs Agent — dev setup, code style, PR process
- [Architecture](https://crewlabs-agent.crewlabs.net/docs/developer-guide/architecture): Crewlabs Agent internals — major subsystems, execution paths, data flow, and where to read next
- [Agent Loop](https://crewlabs-agent.crewlabs.net/docs/developer-guide/agent-loop): Detailed walkthrough of AIAgent execution, API modes, tools, callbacks, and fallback behavior
- [Prompt Assembly](https://crewlabs-agent.crewlabs.net/docs/developer-guide/prompt-assembly): How Crewlabs builds the system prompt, preserves cache stability, and injects ephemeral layers
- [Context Compression & Caching](https://crewlabs-agent.crewlabs.net/docs/developer-guide/context-compression-and-caching)
- [Gateway Internals](https://crewlabs-agent.crewlabs.net/docs/developer-guide/gateway-internals): How the messaging gateway boots, authorizes users, routes sessions, and delivers messages
- [Session Storage](https://crewlabs-agent.crewlabs.net/docs/developer-guide/session-storage)
- [Provider Runtime](https://crewlabs-agent.crewlabs.net/docs/developer-guide/provider-runtime): How Crewlabs resolves providers, credentials, API modes, and auxiliary models at runtime
- [Adding Tools](https://crewlabs-agent.crewlabs.net/docs/developer-guide/adding-tools): How to add a new tool to Crewlabs Agent — schemas, handlers, registration, and toolsets
- [Adding Providers](https://crewlabs-agent.crewlabs.net/docs/developer-guide/adding-providers): How to add a new inference provider to Crewlabs Agent — auth, runtime resolution, CLI flows, adapters, tests, and docs
- [Adding Platform Adapters](https://crewlabs-agent.crewlabs.net/docs/developer-guide/adding-platform-adapters)
- [Creating Skills](https://crewlabs-agent.crewlabs.net/docs/developer-guide/creating-skills): How to create skills for Crewlabs Agent — SKILL.md format, guidelines, and publishing
- [Extending the CLI](https://crewlabs-agent.crewlabs.net/docs/developer-guide/extending-the-cli): Build wrapper CLIs that extend the Crewlabs TUI with custom widgets, keybindings, and layout changes

## Reference

- [CLI Commands](https://crewlabs-agent.crewlabs.net/docs/reference/cli-commands): Authoritative reference for Crewlabs terminal commands and command families
- [Slash Commands](https://crewlabs-agent.crewlabs.net/docs/reference/slash-commands): Complete reference for interactive CLI and messaging slash commands
- [Profile Commands](https://crewlabs-agent.crewlabs.net/docs/reference/profile-commands)
- [Environment Variables](https://crewlabs-agent.crewlabs.net/docs/reference/environment-variables): Complete reference of all environment variables used by Crewlabs Agent
- [Tools Reference](https://crewlabs-agent.crewlabs.net/docs/reference/tools-reference): Authoritative reference for Crewlabs built-in tools, grouped by toolset
- [Toolsets Reference](https://crewlabs-agent.crewlabs.net/docs/reference/toolsets-reference): Reference for Crewlabs core, composite, platform, and dynamic toolsets
- [MCP Config Reference](https://crewlabs-agent.crewlabs.net/docs/reference/mcp-config-reference): Reference for Crewlabs Agent MCP configuration keys, filtering semantics, and utility-tool policy
- [Model Catalog](https://crewlabs-agent.crewlabs.net/docs/reference/model-catalog)
- [Bundled Skills Catalog](https://crewlabs-agent.crewlabs.net/docs/reference/skills-catalog): Table of all ~90 skills bundled with Crewlabs
- [Optional Skills Catalog](https://crewlabs-agent.crewlabs.net/docs/reference/optional-skills-catalog): Table of ~60 additional installable skills
- [FAQ & Troubleshooting](https://crewlabs-agent.crewlabs.net/docs/reference/faq): Frequently asked questions and solutions to common issues with Crewlabs Agent