# Ailiv Agent

> The self-improving AI agent built by Ailiv Soluções. 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 OpenRouter, OpenAI, Anthropic, Google, or any OpenAI-compatible endpoint.

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

Repo: https://github.com/devnx-web/ailiv-2027-back

## Getting Started

- [Installation](https://docs.ailiv.com.br/docs/getting-started/installation): Install Ailiv Agent on Linux, macOS, WSL2, native Windows, or Android via Termux
- [Quickstart](https://docs.ailiv.com.br/docs/getting-started/quickstart): Your first conversation with Ailiv Agent — from install to chatting in under 5 minutes
- [Learning Path](https://docs.ailiv.com.br/docs/getting-started/learning-path): Choose your learning path through the Ailiv Agent documentation based on your experience level and goals.
- [Updating](https://docs.ailiv.com.br/docs/getting-started/updating): How to update Ailiv Agent to the latest version or uninstall it
- [Termux (Android)](https://docs.ailiv.com.br/docs/getting-started/termux): Run Ailiv Agent directly on an Android phone with Termux
- [Nix Setup](https://docs.ailiv.com.br/docs/getting-started/nix-setup): Install and deploy Ailiv Agent with Nix — from quick `nix run` to fully declarative NixOS module with container mode
- [Platform Support](https://docs.ailiv.com.br/docs/getting-started/platform-support): Which operating systems, distribution methods, and features Ailiv Agent supports.

## Using Ailiv

- [CLI](https://docs.ailiv.com.br/docs/user-guide/cli): Master the Ailiv Agent terminal interface — commands, keybindings, personalities, and more
- [TUI (Ink terminal UI)](https://docs.ailiv.com.br/docs/user-guide/tui): Launch the modern terminal UI for Ailiv — mouse-friendly, rich overlays, and non-blocking input.
- [Configuration](https://docs.ailiv.com.br/docs/user-guide/configuration): Configure Ailiv Agent — config.yaml, providers, models, API keys, and more
- [Configuring Models](https://docs.ailiv.com.br/docs/user-guide/configuring-models)
- [Sessions](https://docs.ailiv.com.br/docs/user-guide/sessions): Session persistence, resume, search, management, and per-platform session tracking
- [Profiles](https://docs.ailiv.com.br/docs/user-guide/profiles)
- [Git Worktrees](https://docs.ailiv.com.br/docs/user-guide/git-worktrees): Run multiple Ailiv agents safely on the same repository using git worktrees and isolated checkouts
- [Docker Backend](https://docs.ailiv.com.br/docs/user-guide/docker): Running Ailiv Agent in Docker and using Docker as a terminal backend
- [Security](https://docs.ailiv.com.br/docs/user-guide/security): Security model, dangerous command approval, user authorization, container isolation, and production deployment best practices
- [Checkpoints & Rollback](https://docs.ailiv.com.br/docs/user-guide/checkpoints-and-rollback): Filesystem safety nets for destructive operations using shadow git repos and automatic snapshots
- [Bot Mode](https://docs.ailiv.com.br/docs/user-guide/bot-mode): Turn your Ailiv profiles into a roster of named Bots — each with its own chat, role, model, memory, skills, and avatar. Bots run routines, share group chats, and message each other.
- [Ailiv Desktop](https://docs.ailiv.com.br/docs/user-guide/desktop): The native Ailiv desktop app — a polished experience for chatting with Ailiv, with streaming tool output, side-by-side previews, a file browser, voice, cron, profiles, skills, and settings. macOS, Windows, and Linux.
- [Egress proxy](https://docs.ailiv.com.br/docs/user-guide/egress)
- [Egress credential-injection proxy (iron-proxy)](https://docs.ailiv.com.br/docs/user-guide/egress/iron-proxy)
- [Import from Other Agents](https://docs.ailiv.com.br/docs/user-guide/import-from-other-agents): One-command import of a Claude Code (~/.claude) or OpenAI Codex CLI (~/.codex) setup into Ailiv — instructions, allowlists, MCP servers, skills, and memories.
- [Local Models](https://docs.ailiv.com.br/docs/user-guide/local-models): Run models entirely on your own machine — no account, no API key, nothing leaves your computer.
- [Managed Scope](https://docs.ailiv.com.br/docs/user-guide/managed-scope): Administrator-pinned, user-immutable config and secrets via a system-level managed directory
- [Connecting Desktop to Many Ailiv Instances](https://docs.ailiv.com.br/docs/user-guide/multi-connection-desktop)
- [Running Many Gateways at Once](https://docs.ailiv.com.br/docs/user-guide/multi-profile-gateways)
- [Profile Distributions: Share a Whole Agent](https://docs.ailiv.com.br/docs/user-guide/profile-distributions)
- [Secrets](https://docs.ailiv.com.br/docs/user-guide/secrets)
- [Bitwarden Secrets Manager](https://docs.ailiv.com.br/docs/user-guide/secrets/bitwarden)
- [Command Helper Secret Source](https://docs.ailiv.com.br/docs/user-guide/secrets/command)
- [1Password](https://docs.ailiv.com.br/docs/user-guide/secrets/onepassword)
- [Google Workspace — Gmail, Calendar, Drive, Sheets & Docs](https://docs.ailiv.com.br/docs/user-guide/skills/google-workspace): Send email, manage calendar events, search Drive, read/write Sheets, and access Docs — all through OAuth2-authenticated Google APIs
- [Which File Does What?](https://docs.ailiv.com.br/docs/user-guide/which-file-does-what): SOUL.md vs USER.md vs MEMORY.md vs AGENTS.md — a one-page map of the agent's files, who writes each one, and when the agent actually sees them
- [Windows (Native) Guide](https://docs.ailiv.com.br/docs/user-guide/windows-native): Run Ailiv Agent natively on Windows 10 / 11 — install, feature matrix, UTF-8 console, Git Bash, gateway as a Scheduled Task, editor handling, PATH, uninstall, and common pitfalls
- [Windows (WSL2) Guide](https://docs.ailiv.com.br/docs/user-guide/windows-wsl-quickstart): Run Ailiv Agent on Windows via WSL2 — setup, filesystem access between Windows and Linux, networking, and common pitfalls

## Core Features

- [Features Overview](https://docs.ailiv.com.br/docs/user-guide/features/overview)
- [Tools](https://docs.ailiv.com.br/docs/user-guide/features/tools): Overview of Ailiv Agent's tools — what's available, how toolsets work, and terminal backends
- [Skills System](https://docs.ailiv.com.br/docs/user-guide/features/skills): On-demand knowledge documents — progressive disclosure, agent-managed skills, and the Skills Hub
- [Curator](https://docs.ailiv.com.br/docs/user-guide/features/curator): Background maintenance for agent-created skills — usage tracking, staleness, archival, and LLM-driven review
- [Memory](https://docs.ailiv.com.br/docs/user-guide/features/memory): How Ailiv Agent remembers across sessions — MEMORY.md, USER.md, and session search
- [Memory Providers](https://docs.ailiv.com.br/docs/user-guide/features/memory-providers): External memory provider plugins — Honcho, OpenViking, Mem0, Hindsight, Holographic, RetainDB, ByteRover, Supermemory
- [Context Files](https://docs.ailiv.com.br/docs/user-guide/features/context-files): Project context files — .ailiv.md, AGENTS.md, CLAUDE.md, global SOUL.md, and .cursorrules — automatically injected into every conversation
- [Context References](https://docs.ailiv.com.br/docs/user-guide/features/context-references): Inline @-syntax for attaching files, folders, git diffs, and URLs directly into your messages
- [Personality & SOUL.md](https://docs.ailiv.com.br/docs/user-guide/features/personality): Customize Ailiv Agent's personality with a global SOUL.md, built-in personalities, and custom persona definitions
- [Plugins](https://docs.ailiv.com.br/docs/user-guide/features/plugins): Extend Ailiv with custom tools, hooks, and integrations via the plugin system
- [Built-in Plugins](https://docs.ailiv.com.br/docs/user-guide/features/built-in-plugins): Plugins shipped with Ailiv Agent that run automatically via lifecycle hooks — disk-cleanup and friends
- [Codex App-Server Runtime (optional)](https://docs.ailiv.com.br/docs/user-guide/features/codex-app-server-runtime)
- [Computer Use](https://docs.ailiv.com.br/docs/user-guide/features/computer-use)
- [Deliverable Mode (Artifacts in Chat)](https://docs.ailiv.com.br/docs/user-guide/features/deliverable-mode): How the agent ships generated charts, PDFs, spreadsheets, and other files as native attachments in messaging platforms.
- [Document Extraction](https://docs.ailiv.com.br/docs/user-guide/features/document-extraction): How read_file converts PDFs, Office documents, and notebooks to text — and what to do when a PDF is scanned images
- [Extending the Dashboard](https://docs.ailiv.com.br/docs/user-guide/features/extending-the-dashboard): Build themes and plugins for the Ailiv web dashboard — palettes, typography, layouts, custom tabs, shell slots, page-scoped slots, and backend API routes
- [Session Heartbeats](https://docs.ailiv.com.br/docs/user-guide/features/heartbeat): A recurring prompt that re-enters your current session whenever it's idle — /heartbeat every 10m Check the deployment.
- [Kanban worker lanes](https://docs.ailiv.com.br/docs/user-guide/features/kanban-worker-lanes)
- [Live Voice Call](https://docs.ailiv.com.br/docs/user-guide/features/live-call): Talk to the assistant in real time from the hosted web app, powered by Gemini Live, with the Ailiv agent doing the work
- [Recurring Loops](https://docs.ailiv.com.br/docs/user-guide/features/loops): Re-run a prompt on a recurring interval inside your session — Ailiv' take on Claude Code's /loop.
- [LSP — Semantic Diagnostics](https://docs.ailiv.com.br/docs/user-guide/features/lsp): Real language servers (pyright, gopls, rust-analyzer, …) wired into the post-write lint check used by write_file and patch.
- [Mixture of Agents](https://docs.ailiv.com.br/docs/user-guide/features/mixture-of-agents): Create named MoA presets that appear as selectable models under the Mixture of Agents provider
- [Pets (Petdex Mascots)](https://docs.ailiv.com.br/docs/user-guide/features/pets): Adopt an animated mascot that reacts to agent activity across the CLI, TUI, and desktop app
- [Plugin Catalog](https://docs.ailiv.com.br/docs/user-guide/features/plugin-catalog): Browse and install reviewed, SHA-pinned Ailiv plugins from the curated catalog
- [Skins & Themes](https://docs.ailiv.com.br/docs/user-guide/features/skins): Customize the Ailiv CLI with built-in and user-defined skins
- [Spotify](https://docs.ailiv.com.br/docs/user-guide/features/spotify)
- [Tool Search](https://docs.ailiv.com.br/docs/user-guide/features/tool-search)
- [Wake Word](https://docs.ailiv.com.br/docs/user-guide/features/wake-word): Hands-free wake word — start a voice session by speaking, the 'Hey Siri' way
- [Ailiv Web Dashboard](https://docs.ailiv.com.br/docs/user-guide/features/web-dashboard): Browser-based administration panel for managing configuration, API keys, MCP servers, messaging pairing, webhooks, the gateway, memory, credentials, sessions, logs, analytics, cron jobs, and skills
- [Web Search & Extract](https://docs.ailiv.com.br/docs/user-guide/features/web-search): Search the web and extract page content with multiple backend providers — including free self-hosted SearXNG.
- [X (Twitter) Search](https://docs.ailiv.com.br/docs/user-guide/features/x-search): Search X (Twitter) posts and threads from within the agent using xAI's built-in x_search Responses tool — works with either a SuperGrok OAuth login or an XAI_API_KEY.

## Automation

- [Cron Jobs](https://docs.ailiv.com.br/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://docs.ailiv.com.br/docs/user-guide/features/delegation): Spawn isolated child agents for parallel workstreams with delegate_task
- [Kanban Multi-Agent](https://docs.ailiv.com.br/docs/user-guide/features/kanban): Durable SQLite-backed task board for coordinating multiple Ailiv profiles
- [Kanban Tutorial](https://docs.ailiv.com.br/docs/user-guide/features/kanban-tutorial)
- [Persistent Goals](https://docs.ailiv.com.br/docs/user-guide/features/goals): Set a standing goal and let Ailiv keep working across turns until it's done. Our take on the Ralph loop.
- [Code Execution](https://docs.ailiv.com.br/docs/user-guide/features/code-execution): Programmatic Python execution with RPC tool access — collapse multi-step workflows into a single turn
- [Hooks](https://docs.ailiv.com.br/docs/user-guide/features/hooks): Run custom code at key lifecycle points — log activity, send alerts, post to webhooks
- [Batch Processing](https://docs.ailiv.com.br/docs/user-guide/features/batch-processing): Generate agent trajectories at scale — parallel processing, checkpointing, and toolset distributions

## Media & Web

- [Voice Mode](https://docs.ailiv.com.br/docs/user-guide/features/voice-mode): Real-time voice conversations with Ailiv Agent — CLI, Telegram, Discord (DMs, text channels, and voice channels)
- [Browser](https://docs.ailiv.com.br/docs/user-guide/features/browser): Control browsers with multiple providers, local Chromium-family browsers via CDP, or cloud browsers for web interaction, form filling, scraping, and more.
- [Vision](https://docs.ailiv.com.br/docs/user-guide/features/vision): Paste images from your clipboard into the Ailiv CLI for multimodal vision analysis.
- [Image Generation](https://docs.ailiv.com.br/docs/user-guide/features/image-generation): Generate images via FAL.ai — 11 models including FLUX 2, GPT Image (1.5 & 2), Nano Banana Pro, Ideogram, Recraft V4 Pro, Krea 2, and more, selectable via `ailiv tools`.
- [Text-to-Speech](https://docs.ailiv.com.br/docs/user-guide/features/tts): Text-to-speech and voice message transcription across all platforms

## Messaging Platforms

- [Overview](https://docs.ailiv.com.br/docs/user-guide/messaging): Chat with Ailiv from Telegram, Discord, Slack, WhatsApp, Signal, SMS, Email, Home Assistant, Mattermost, Matrix, DingTalk, Yuanbao, Microsoft Teams, LINE, Raft, Webhooks, or any OpenAI-compatible frontend via the API server — architecture and setup overview
- [Telegram](https://docs.ailiv.com.br/docs/user-guide/messaging/telegram): Set up Ailiv Agent as a Telegram bot
- [Discord](https://docs.ailiv.com.br/docs/user-guide/messaging/discord): Set up Ailiv Agent as a Discord bot
- [Slack](https://docs.ailiv.com.br/docs/user-guide/messaging/slack): Set up Ailiv Agent as a Slack bot using Socket Mode
- [WhatsApp](https://docs.ailiv.com.br/docs/user-guide/messaging/whatsapp): Set up Ailiv Agent as a WhatsApp bot via the built-in Baiailiv bridge
- [Signal](https://docs.ailiv.com.br/docs/user-guide/messaging/signal): Set up Ailiv Agent as a Signal messenger bot via signal-cli daemon
- [Email](https://docs.ailiv.com.br/docs/user-guide/messaging/email): Set up Ailiv Agent as an email assistant via IMAP/SMTP
- [SMS](https://docs.ailiv.com.br/docs/user-guide/messaging/sms): Set up Ailiv Agent as an SMS chatbot via Twilio
- [Matrix](https://docs.ailiv.com.br/docs/user-guide/messaging/matrix): Set up Ailiv Agent as a Matrix bot
- [Mattermost](https://docs.ailiv.com.br/docs/user-guide/messaging/mattermost): Set up Ailiv Agent as a Mattermost bot
- [Home Assistant](https://docs.ailiv.com.br/docs/user-guide/messaging/homeassistant): Control your smart home with Ailiv Agent via Home Assistant integration.
- [Webhooks](https://docs.ailiv.com.br/docs/user-guide/messaging/webhooks): Receive events from GitHub, GitLab, and other services to trigger Ailiv agent runs
- [A2A (Agent-to-Agent)](https://docs.ailiv.com.br/docs/user-guide/messaging/a2a)
- [BlueBubbles (iMessage)](https://docs.ailiv.com.br/docs/user-guide/messaging/bluebubbles)
- [Buzz](https://docs.ailiv.com.br/docs/user-guide/messaging/buzz)
- [DingTalk](https://docs.ailiv.com.br/docs/user-guide/messaging/dingtalk): Set up Ailiv Agent as a DingTalk chatbot
- [Feishu / Lark](https://docs.ailiv.com.br/docs/user-guide/messaging/feishu): Set up Ailiv Agent as a Feishu or Lark bot
- [Google Chat](https://docs.ailiv.com.br/docs/user-guide/messaging/google_chat): Set up Ailiv Agent as a Google Chat bot using Cloud Pub/Sub
- [IRC](https://docs.ailiv.com.br/docs/user-guide/messaging/irc)
- [LINE](https://docs.ailiv.com.br/docs/user-guide/messaging/line): Set up Ailiv Agent as a LINE Messaging API bot
- [Microsoft Graph Webhook Listener](https://docs.ailiv.com.br/docs/user-guide/messaging/msgraph-webhook): Receive Microsoft Graph change notifications (meetings, calendar, chat, etc.) in Ailiv
- [ntfy](https://docs.ailiv.com.br/docs/user-guide/messaging/ntfy)
- [Open WebUI](https://docs.ailiv.com.br/docs/user-guide/messaging/open-webui): Connect Open WebUI to Ailiv Agent via the OpenAI-compatible API server
- [Photon iMessage](https://docs.ailiv.com.br/docs/user-guide/messaging/photon)
- [QQ Bot](https://docs.ailiv.com.br/docs/user-guide/messaging/qqbot)
- [Raft](https://docs.ailiv.com.br/docs/user-guide/messaging/raft): Connect Ailiv Agent to Raft as an external agent via wake-channel bridge
- [Ailiv Relay](https://docs.ailiv.com.br/docs/user-guide/messaging/relay): Connect Ailiv to messaging platforms through a relay connector that owns the platform credentials — enrollment, capabilities, config, and troubleshooting
- [SimpleX Chat](https://docs.ailiv.com.br/docs/user-guide/messaging/simplex)
- [Microsoft Teams](https://docs.ailiv.com.br/docs/user-guide/messaging/teams): Set up Ailiv Agent as a Microsoft Teams bot
- [Teams Meetings](https://docs.ailiv.com.br/docs/user-guide/messaging/teams-meetings): Set up the Microsoft Teams meeting summary pipeline with Microsoft Graph webhooks
- [WeCom (Enterprise WeChat)](https://docs.ailiv.com.br/docs/user-guide/messaging/wecom): Connect Ailiv Agent to WeCom via the AI Bot WebSocket gateway
- [WeCom Callback (Self-Built App)](https://docs.ailiv.com.br/docs/user-guide/messaging/wecom-callback)
- [Weixin (WeChat)](https://docs.ailiv.com.br/docs/user-guide/messaging/weixin): Connect Ailiv Agent to personal WeChat accounts via the iLink Bot API
- [WhatsApp Business (Cloud API)](https://docs.ailiv.com.br/docs/user-guide/messaging/whatsapp-cloud): Set up Ailiv Agent as a WhatsApp bot via Meta's official Business Cloud API
- [Yuanbao](https://docs.ailiv.com.br/docs/user-guide/messaging/yuanbao): Connect Ailiv Agent to the Yuanbao enterprise messaging platform via WebSocket gateway

## Integrations

- [Integrations Overview](https://docs.ailiv.com.br/docs/integrations)
- [Providers](https://docs.ailiv.com.br/docs/integrations/providers)
- [MCP (Model Context Protocol)](https://docs.ailiv.com.br/docs/user-guide/features/mcp): Connect Ailiv Agent to external tool servers via MCP — and control exactly which MCP tools Ailiv loads
- [ACP (Agent Context Protocol)](https://docs.ailiv.com.br/docs/user-guide/features/acp): Use Ailiv Agent inside ACP-compatible editors and collaboration platforms
- [API Server](https://docs.ailiv.com.br/docs/user-guide/features/api-server): Expose ailiv-agent as an OpenAI-compatible API for any frontend
- [Honcho Memory](https://docs.ailiv.com.br/docs/user-guide/features/honcho): AI-native persistent memory via Honcho — dialectic reasoning, multi-agent user modeling, and deep personalization
- [Provider Routing](https://docs.ailiv.com.br/docs/user-guide/features/provider-routing): Configure OpenRouter provider preferences to optimize for cost, speed, or quality.
- [Fallback Providers](https://docs.ailiv.com.br/docs/user-guide/features/fallback-providers): Configure automatic failover to backup LLM providers when your primary model is unavailable.
- [Credential Pools](https://docs.ailiv.com.br/docs/user-guide/features/credential-pools): Pool multiple API keys or OAuth tokens per provider for automatic rotation and rate limit recovery.
- [Buzz Integration](https://docs.ailiv.com.br/docs/integrations/buzz): All three ways to connect Ailiv Agent to Buzz — Block's Nostr-based human+agent workspace

## Guides & Tutorials

- [Tips & Best Practices](https://docs.ailiv.com.br/docs/guides/tips): Practical advice to get the most out of Ailiv Agent — prompt tips, CLI shortcuts, context files, memory, cost optimization, and security
- [Local LLMs on Mac](https://docs.ailiv.com.br/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://docs.ailiv.com.br/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://docs.ailiv.com.br/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 Ailiv as a Python Library](https://docs.ailiv.com.br/docs/guides/python-library): Embed AIAgent in your own Python scripts, web apps, or automation pipelines — no CLI required
- [Use MCP with Ailiv](https://docs.ailiv.com.br/docs/guides/use-mcp-with-ailiv): A practical guide to connecting MCP servers to Ailiv Agent, filtering their tools, and using them safely in real workflows
- [Use Voice Mode with Ailiv](https://docs.ailiv.com.br/docs/guides/use-voice-mode-with-ailiv): A practical guide to setting up and using Ailiv voice mode across CLI, Telegram, Discord, and Discord voice channels
- [Use SOUL.md with Ailiv](https://docs.ailiv.com.br/docs/guides/use-soul-with-ailiv): How to use SOUL.md to shape Ailiv Agent's default voice, what belongs there, and how it differs from AGENTS.md and /personality
- [Automate with Cron](https://docs.ailiv.com.br/docs/guides/automate-with-cron): Real-world automation patterns using Ailiv cron — monitoring, reports, pipelines, and multi-skill workflows
- [Work with Skills](https://docs.ailiv.com.br/docs/guides/work-with-skills): Find, install, use, and create skills — on-demand knowledge that teaches Ailiv new workflows
- [Delegation Patterns](https://docs.ailiv.com.br/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://docs.ailiv.com.br/docs/guides/github-pr-review-agent): Build an automated AI code reviewer that monitors your repos, reviews pull requests, and delivers feedback — hands-free
- [Give Your Agent Its Own Email Address](https://docs.ailiv.com.br/docs/guides/agent-email-address): Set up a dedicated mailbox your agent can read and send from using the bundled Himalaya skill, with a cron polling pattern and safety notes
- [Automation Blueprints](https://docs.ailiv.com.br/docs/guides/automation-blueprints): Ready-to-use automation blueprints — scheduled tasks, GitHub event triggers, API webhooks, and multi-skill workflows
- [AWS Bedrock](https://docs.ailiv.com.br/docs/guides/aws-bedrock): Use Ailiv Agent with Amazon Bedrock — native Converse API, Anthropic SDK routing, OpenAI models via Bedrock Mantle, IAM authentication, Guardrails, and cross-region inference
- [Microsoft Foundry](https://docs.ailiv.com.br/docs/guides/azure-foundry): Use Ailiv Agent with Microsoft Foundry — OpenAI-style and Anthropic-style endpoints, auto-detection of transport and deployed models
- [Script-Only Cron Jobs (No LLM)](https://docs.ailiv.com.br/docs/guides/cron-script-only): Classic watchdog cron jobs that skip the LLM entirely — a script runs on schedule and its stdout gets delivered to your messaging platform. Memory alerts, disk alerts, CI pings, periodic health checks.
- [Cron Troubleshooting](https://docs.ailiv.com.br/docs/guides/cron-troubleshooting): Diagnose and fix common Ailiv cron issues — jobs not firing, delivery failures, skill loading errors, and performance problems
- [Desktop Native Sign-In (RFC 8252)](https://docs.ailiv.com.br/docs/guides/desktop-native-signin): How the Ailiv Desktop app signs in to a gated gateway using your system browser and PKCE — no embedded webview, no session cookies
- [Google Gemini](https://docs.ailiv.com.br/docs/guides/google-gemini): Use Ailiv Agent with Google Gemini — native AI Studio API, API-key setup, tool calling, streaming, and quota guidance
- [Google Vertex AI](https://docs.ailiv.com.br/docs/guides/google-vertex): Use Ailiv Agent with Gemini on Google Cloud Vertex AI — OAuth2 service account or ADC, GCP billing and quotas, no static API key
- [Run Ailiv Locally with Ollama — Zero API Cost](https://docs.ailiv.com.br/docs/guides/local-ollama-setup): Step-by-step guide to running Ailiv Agent entirely on your own machine with Ollama and open-weight models like Gemma 4, no cloud API keys or paid subscriptions needed
- [Register a Microsoft Graph Application](https://docs.ailiv.com.br/docs/guides/microsoft-graph-app-registration): Azure portal walkthrough for creating the app registration that powers the Teams meeting pipeline
- [Migrate from OpenClaw](https://docs.ailiv.com.br/docs/guides/migrate-from-openclaw): Complete guide to migrating your OpenClaw / Clawdbot setup to Ailiv Agent — what gets migrated, how config maps, and what to check after.
- [MiniMax OAuth](https://docs.ailiv.com.br/docs/guides/minimax-oauth): Log into MiniMax via browser OAuth and use MiniMax-M2.7 models in Ailiv Agent — no API key required
- [OAuth over SSH / Remote Hosts](https://docs.ailiv.com.br/docs/guides/oauth-over-ssh): How to complete browser-based OAuth (Spotify, MCP servers) when Ailiv runs on a remote machine, container, or behind a jump box
- [Operate the Teams Meeting Pipeline](https://docs.ailiv.com.br/docs/guides/operate-teams-meeting-pipeline): Runbook, go-live checklist, and operator worksheet for the Microsoft Teams meeting pipeline
- [Pipe Script Output to Messaging Platforms](https://docs.ailiv.com.br/docs/guides/pipe-script-output): Send text from any shell script, cron job, CI hook, or monitoring daemon to Telegram, Discord, Slack, Signal, and other platforms using `ailiv send`.
- [Running Ailiv on a Personal or Work Machine](https://docs.ailiv.com.br/docs/guides/secure-ailiv-on-a-work-machine): A security-posture walkthrough for running Ailiv Agent on the machine you live on — what the defaults protect, how to tighten further, and how to undo mistakes
- [Troubleshooting: \"My Agent Feels Dumber\"](https://docs.ailiv.com.br/docs/guides/troubleshooting-agent-quality): A diagnostic checklist for when Ailiv seems less capable than before or forgets things mid-session — model switches, context pressure, wrong context detection, and the frozen memory snapshot
- [Automated GitHub PR Comments with Webhooks](https://docs.ailiv.com.br/docs/guides/webhook-github-pr-review): Connect Ailiv to GitHub so it automatically fetches PR diffs, reviews code changes, and posts comments — triggered by webhooks with no manual prompting
- [xAI Grok OAuth (SuperGrok / X Premium+)](https://docs.ailiv.com.br/docs/guides/xai-grok-oauth): Sign in with your SuperGrok or X Premium+ subscription to use Grok models in Ailiv Agent — no API key required

## Developer Guide

- [Contributing](https://docs.ailiv.com.br/docs/developer-guide/contributing): How to contribute to Ailiv Agent — dev setup, code style, PR process
- [Architecture](https://docs.ailiv.com.br/docs/developer-guide/architecture): Ailiv Agent internals — major subsystems, execution paths, data flow, and where to read next
- [Agent Loop](https://docs.ailiv.com.br/docs/developer-guide/agent-loop): Detailed walkthrough of AIAgent execution, API modes, tools, callbacks, and fallback behavior
- [Prompt Assembly](https://docs.ailiv.com.br/docs/developer-guide/prompt-assembly): How Ailiv builds the system prompt, preserves cache stability, and injects ephemeral layers
- [Context Compression & Caching](https://docs.ailiv.com.br/docs/developer-guide/context-compression-and-caching)
- [Gateway Internals](https://docs.ailiv.com.br/docs/developer-guide/gateway-internals): How the messaging gateway boots, authorizes users, routes sessions, and delivers messages
- [Session Storage](https://docs.ailiv.com.br/docs/developer-guide/session-storage)
- [Provider Runtime](https://docs.ailiv.com.br/docs/developer-guide/provider-runtime): How Ailiv resolves providers, credentials, API modes, and auxiliary models at runtime
- [Adding Tools](https://docs.ailiv.com.br/docs/developer-guide/adding-tools): How to add a new tool to Ailiv Agent — schemas, handlers, registration, and toolsets
- [Adding Providers](https://docs.ailiv.com.br/docs/developer-guide/adding-providers): How to add a new inference provider to Ailiv Agent — auth, runtime resolution, CLI flows, adapters, tests, and docs
- [Adding Platform Adapters](https://docs.ailiv.com.br/docs/developer-guide/adding-platform-adapters)
- [Creating Skills](https://docs.ailiv.com.br/docs/developer-guide/creating-skills): How to create skills for Ailiv Agent — SKILL.md format, guidelines, and publishing
- [Extending the CLI](https://docs.ailiv.com.br/docs/developer-guide/extending-the-cli): Build wrapper CLIs that extend the Ailiv TUI with custom widgets, keybindings, and layout changes
- [ACP Internals](https://docs.ailiv.com.br/docs/developer-guide/acp-internals): How the ACP adapter works: lifecycle, sessions, event bridge, approvals, and tool rendering
- [Browser Provider Plugins](https://docs.ailiv.com.br/docs/developer-guide/browser-provider-plugin): How to build a cloud browser backend plugin for Ailiv Agent
- [Browser CDP Supervisor](https://docs.ailiv.com.br/docs/developer-guide/browser-supervisor): How Ailiv detects and responds to native JS dialogs and interacts with cross-origin iframes via a persistent CDP connection.
- [CLI Internals](https://docs.ailiv.com.br/docs/developer-guide/cli-internals): How ailiv_cli is shaped: slash dispatch, config loaders, the skin engine, the transactional update pipeline, and process-identity rules
- [Codebase Ownership Map](https://docs.ailiv.com.br/docs/developer-guide/codebase-ownership): Which directories belong to which subsystem, and where the right docs entry point lives for each
- [Background completion backlogs](https://docs.ailiv.com.br/docs/developer-guide/completion-backlog-delivery)
- [Context Engine Plugins](https://docs.ailiv.com.br/docs/developer-guide/context-engine-plugin): How to build a context engine plugin that replaces the built-in ContextCompressor
- [Cron Internals](https://docs.ailiv.com.br/docs/developer-guide/cron-internals): How Ailiv stores, schedules, edits, pauses, skill-loads, and delivers cron jobs
- [Desktop Plugin SDK (@ailiv/plugin-sdk)](https://docs.ailiv.com.br/docs/developer-guide/desktop-plugin-sdk): Extend the native Ailiv Desktop app — panes, pages, sidebar nav, status bar, palette commands, keybinds, themes, and a scoped backend namespace, with one import and no build step.
- [Egress proxy internals](https://docs.ailiv.com.br/docs/developer-guide/egress-internals): How the iron-proxy egress firewall integrates with Ailiv — module layout, lifecycle, security invariants, and extension points
- [Image Generation Provider Plugins](https://docs.ailiv.com.br/docs/developer-guide/image-gen-provider-plugin): How to build an image-generation backend plugin for Ailiv Agent
- [Memory Provider Plugins](https://docs.ailiv.com.br/docs/developer-guide/memory-provider-plugin): How to build a memory provider plugin for Ailiv Agent
- [Model Provider Plugins](https://docs.ailiv.com.br/docs/developer-guide/model-provider-plugin): How to build a model provider (inference backend) plugin for Ailiv Agent
- [Plugin LLM Access](https://docs.ailiv.com.br/docs/developer-guide/plugin-llm-access): Run any LLM call from inside a plugin via ctx.llm — chat or structured, sync or async. Host-owned auth, fail-closed trust gate, optional JSON Schema validation.
- [Build a Ailiv Plugin](https://docs.ailiv.com.br/docs/developer-guide/plugins): Step-by-step guide to building a complete Ailiv plugin with tools, hooks, data files, and skills
- [Programmatic Integration](https://docs.ailiv.com.br/docs/developer-guide/programmatic-integration): Three protocols for driving ailiv-agent from external programs: ACP, the TUI gateway JSON-RPC, and the OpenAI-compatible HTTP API
- [Secret Source Plugins](https://docs.ailiv.com.br/docs/developer-guide/secret-source-plugin): How to build a secret-manager backend plugin for Ailiv Agent
- [Public Subagent Lifecycle API](https://docs.ailiv.com.br/docs/developer-guide/subagent-lifecycle-api)
- [Terminal Environment Provider Plugins](https://docs.ailiv.com.br/docs/developer-guide/terminal-environment-plugin)
- [Tools Runtime](https://docs.ailiv.com.br/docs/developer-guide/tools-runtime): Runtime behavior of the tool registry, toolsets, dispatch, and terminal environments
- [Trajectory Format](https://docs.ailiv.com.br/docs/developer-guide/trajectory-format)
- [Video Generation Provider Plugins](https://docs.ailiv.com.br/docs/developer-guide/video-gen-provider-plugin): How to build a video-generation backend plugin for Ailiv Agent
- [Web Search Provider Plugins](https://docs.ailiv.com.br/docs/developer-guide/web-search-provider-plugin): How to build a web-search/extract/crawl backend plugin for Ailiv Agent
- [TUI & Desktop from Worktrees](https://docs.ailiv.com.br/docs/developer-guide/worktree-ui-dev): Run the Ink TUI and Electron desktop app from a git worktree without a full npm install per checkout

## Reference

- [CLI Commands](https://docs.ailiv.com.br/docs/reference/cli-commands): Authoritative reference for Ailiv terminal commands and command families
- [Slash Commands](https://docs.ailiv.com.br/docs/reference/slash-commands): Complete reference for interactive CLI and messaging slash commands
- [Profile Commands](https://docs.ailiv.com.br/docs/reference/profile-commands)
- [Environment Variables](https://docs.ailiv.com.br/docs/reference/environment-variables): Complete reference of all environment variables used by Ailiv Agent
- [Tools Reference](https://docs.ailiv.com.br/docs/reference/tools-reference): Authoritative reference for Ailiv built-in tools, grouped by toolset
- [Toolsets Reference](https://docs.ailiv.com.br/docs/reference/toolsets-reference): Reference for Ailiv core, composite, platform, and dynamic toolsets
- [MCP Config Reference](https://docs.ailiv.com.br/docs/reference/mcp-config-reference): Reference for Ailiv Agent MCP configuration keys, filtering semantics, and utility-tool policy
- [Model Catalog](https://docs.ailiv.com.br/docs/reference/model-catalog): Remotely-hosted manifest driving curated model picker lists for OpenRouter and other providers.
- [Bundled Skills Catalog](https://docs.ailiv.com.br/docs/reference/skills-catalog): Table of all ~90 skills bundled with Ailiv
- [Optional Skills Catalog](https://docs.ailiv.com.br/docs/reference/optional-skills-catalog): Table of ~60 additional installable skills
- [FAQ & Troubleshooting](https://docs.ailiv.com.br/docs/reference/faq): Frequently asked questions and solutions to common issues with Ailiv Agent
- [Automation Blueprints Catalog](https://docs.ailiv.com.br/docs/reference/automation-blueprints-catalog): Ready-to-run automation blueprints — set one up from the dashboard, CLI, TUI, any messenger, or the desktop app.
- [CLI Symbols Glossary](https://docs.ailiv.com.br/docs/reference/cli-symbols): What every symbol in the Ailiv terminal UI means — transcript markers, status-bar badges, overlay glyphs, and approval prompts.