# Tutou Agent

> The self-improving AI agent built by Tutou Keji. 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/NousResearch/tutou-agent/main/scripts/install.sh | bash`  (Linux, macOS, WSL2)

Repo: https://github.com/tutoukeji/tutou-agent

## Getting Started

- [Installation](https://docs.tutoukeji.com/docs/getting-started/installation): Install Tutou Agent with desktop bundles, source installers, Docker, Nix, or the Termux APT package
- [Quickstart](https://docs.tutoukeji.com/docs/getting-started/quickstart): Your first conversation with Tutou Agent — from install to chatting in under 5 minutes
- [Learning Path](https://docs.tutoukeji.com/docs/getting-started/learning-path): Choose your learning path through the Tutou Agent documentation based on your experience level and goals.
- [Updating](https://docs.tutoukeji.com/docs/getting-started/updating): How to update Tutou Agent to the latest version or uninstall it
- [Nix Setup](https://docs.tutoukeji.com/docs/getting-started/nix-setup): Install and deploy Tutou Agent with Nix — from quick `nix run` to fully declarative NixOS module with container mode
- [Platform Support](https://docs.tutoukeji.com/docs/getting-started/platform-support): Which operating systems, distribution methods, and features Tutou Agent supports.
- [Android / Termux](https://docs.tutoukeji.com/docs/getting-started/termux): Install Tutou Agent on Android from its signed Termux APT repository

## Using Tutou

- [CLI](https://docs.tutoukeji.com/docs/user-guide/cli): Master the Tutou Agent terminal interface — commands, keybindings, personalities, and more
- [TUI (Ink terminal UI)](https://docs.tutoukeji.com/docs/user-guide/tui): Launch the modern terminal UI for Tutou — mouse-friendly, rich overlays, and non-blocking input.
- [Configuration](https://docs.tutoukeji.com/docs/user-guide/configuration): Configure Tutou Agent — config.yaml, providers, models, API keys, and more
- [Configuring Models](https://docs.tutoukeji.com/docs/user-guide/configuring-models)
- [Sessions](https://docs.tutoukeji.com/docs/user-guide/sessions): Session persistence, resume, search, management, and per-platform session tracking
- [Profiles](https://docs.tutoukeji.com/docs/user-guide/profiles)
- [Git Worktrees](https://docs.tutoukeji.com/docs/user-guide/git-worktrees): Run multiple Tutou agents safely on the same repository using git worktrees and isolated checkouts
- [Docker Backend](https://docs.tutoukeji.com/docs/user-guide/docker): Running Tutou Agent in Docker and using Docker as a terminal backend
- [Security](https://docs.tutoukeji.com/docs/user-guide/security): Security model, dangerous command approval, user authorization, container isolation, and production deployment best practices
- [Checkpoints & Rollback](https://docs.tutoukeji.com/docs/user-guide/checkpoints-and-rollback): Filesystem safety nets for destructive operations using shadow git repos and automatic snapshots
- [Bot Mode](https://docs.tutoukeji.com/docs/user-guide/bot-mode): Turn your Tutou 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.
- [Tutou Desktop](https://docs.tutoukeji.com/docs/user-guide/desktop): The native Tutou desktop app — a polished experience for chatting with Tutou, 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.tutoukeji.com/docs/user-guide/egress)
- [Egress credential-injection proxy (iron-proxy)](https://docs.tutoukeji.com/docs/user-guide/egress/iron-proxy)
- [Network Egress Isolation (Docker)](https://docs.tutoukeji.com/docs/user-guide/egress/network-isolation): Segment Docker networks so the agent sandbox can only reach allowlisted hosts
- [Import from Other Agents](https://docs.tutoukeji.com/docs/user-guide/import-from-other-agents): One-command import of a Claude Code (~/.claude) or OpenAI Codex CLI (~/.codex) setup into Tutou — instructions, allowlists, MCP servers, skills, and memories.
- [Local Models](https://docs.tutoukeji.com/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.tutoukeji.com/docs/user-guide/managed-scope): Administrator-pinned, user-immutable config and secrets via a system-level managed directory
- [Connecting Desktop to Many Tutou Instances](https://docs.tutoukeji.com/docs/user-guide/multi-connection-desktop)
- [Running Many Gateways at Once](https://docs.tutoukeji.com/docs/user-guide/multi-profile-gateways)
- [Profile Distributions: Share a Whole Agent](https://docs.tutoukeji.com/docs/user-guide/profile-distributions)
- [Secrets](https://docs.tutoukeji.com/docs/user-guide/secrets)
- [Bitwarden Secrets Manager](https://docs.tutoukeji.com/docs/user-guide/secrets/bitwarden)
- [Command Helper Secret Source](https://docs.tutoukeji.com/docs/user-guide/secrets/command)
- [1Password](https://docs.tutoukeji.com/docs/user-guide/secrets/onepassword)
- [Session Storage Recovery](https://docs.tutoukeji.com/docs/user-guide/session-storage-recovery): What to do when Tutou says another process holds an old copy of the session database's write-ahead log, and what the files beside state.db are
- [Google Workspace — Gmail, Calendar, Drive, Sheets & Docs](https://docs.tutoukeji.com/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
- [Switching to a Source Install](https://docs.tutoukeji.com/docs/user-guide/switching-to-source): Run a separate source checkout without overwriting packaged files or losing track of user data
- [Which File Does What?](https://docs.tutoukeji.com/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.tutoukeji.com/docs/user-guide/windows-native): Run Tutou 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.tutoukeji.com/docs/user-guide/windows-wsl-quickstart): Run Tutou Agent on Windows via WSL2 — setup, filesystem access between Windows and Linux, networking, and common pitfalls

## Core Features

- [Features Overview](https://docs.tutoukeji.com/docs/user-guide/features/overview)
- [Tools](https://docs.tutoukeji.com/docs/user-guide/features/tools): Overview of Tutou Agent's tools — what's available, how toolsets work, and terminal backends
- [Skills System](https://docs.tutoukeji.com/docs/user-guide/features/skills): On-demand knowledge documents — progressive disclosure, agent-managed skills, and the Skills Hub
- [Curator](https://docs.tutoukeji.com/docs/user-guide/features/curator): Background maintenance for agent-created skills — usage tracking, staleness, archival, and LLM-driven review
- [Memory](https://docs.tutoukeji.com/docs/user-guide/features/memory): How Tutou Agent remembers across sessions — MEMORY.md, USER.md, and session search
- [Memory Providers](https://docs.tutoukeji.com/docs/user-guide/features/memory-providers): External memory provider plugins — Honcho, OpenViking, Mem0, Hindsight, Holographic, RetainDB, ByteRover, Supermemory
- [Context Files](https://docs.tutoukeji.com/docs/user-guide/features/context-files): Project context files — .tutou.md, AGENTS.md, CLAUDE.md, global SOUL.md, and .cursorrules — automatically injected into every conversation
- [Context References](https://docs.tutoukeji.com/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.tutoukeji.com/docs/user-guide/features/personality): Customize Tutou Agent's personality with a global SOUL.md, built-in personalities, and custom persona definitions
- [Plugins](https://docs.tutoukeji.com/docs/user-guide/features/plugins): Extend Tutou with custom tools, hooks, and integrations via the plugin system
- [Built-in Plugins](https://docs.tutoukeji.com/docs/user-guide/features/built-in-plugins): Plugins shipped with Tutou Agent that run automatically via lifecycle hooks — disk-cleanup and friends
- [Bot Screen](https://docs.tutoukeji.com/docs/user-guide/features/bot-screen)
- [Codex App-Server Runtime (optional)](https://docs.tutoukeji.com/docs/user-guide/features/codex-app-server-runtime)
- [Computer Use](https://docs.tutoukeji.com/docs/user-guide/features/computer-use)
- [Passwords & Logins](https://docs.tutoukeji.com/docs/user-guide/features/credential-vault): The agent signs into sites, pays and fills addresses for you without ever seeing a password.
- [Deliverable Mode (Artifacts in Chat)](https://docs.tutoukeji.com/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.tutoukeji.com/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.tutoukeji.com/docs/user-guide/features/extending-the-dashboard): Build themes and plugins for the Tutou web dashboard — palettes, typography, layouts, custom tabs, shell slots, page-scoped slots, and backend API routes
- [Session Heartbeats](https://docs.tutoukeji.com/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 Multi-Gateway Deployment](https://docs.tutoukeji.com/docs/user-guide/features/kanban-multi-gateway): Running one kanban board across several per-profile gateways: single dispatcher, profile-owned delivery
- [Kanban worker lanes](https://docs.tutoukeji.com/docs/user-guide/features/kanban-worker-lanes)
- [Language Packs](https://docs.tutoukeji.com/docs/user-guide/features/language-packs): Add or override UI languages for the CLI, gateway, TUI and Desktop with a plugin or a personal overlay
- [Recurring Loops](https://docs.tutoukeji.com/docs/user-guide/features/loops): Re-run a prompt on a recurring interval inside your session — Tutou' take on Claude Code's /loop.
- [LSP — Semantic Diagnostics](https://docs.tutoukeji.com/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.tutoukeji.com/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.tutoukeji.com/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.tutoukeji.com/docs/user-guide/features/plugin-catalog): Give Tutou new powers with reviewed plugins you can install in one click
- [Skins & Themes](https://docs.tutoukeji.com/docs/user-guide/features/skins): Customize the Tutou CLI with built-in and user-defined skins
- [Spotify](https://docs.tutoukeji.com/docs/user-guide/features/spotify)
- [Subscription Proxy](https://docs.tutoukeji.com/docs/user-guide/features/subscription-proxy): Use your Nous Portal subscription (or other OAuth provider) as an OpenAI-compatible endpoint for external apps
- [Nous Tool Gateway](https://docs.tutoukeji.com/docs/user-guide/features/tool-gateway): One subscription, every tool. Web search, image generation, TTS, and cloud browsers — all routed through Nous Portal with no extra API keys.
- [Tool Search](https://docs.tutoukeji.com/docs/user-guide/features/tool-search)
- [Wake Word](https://docs.tutoukeji.com/docs/user-guide/features/wake-word): Hands-free 'Hey Tutou' wake word — start a voice session by speaking, the 'Hey Siri' way
- [Tutou Web Dashboard](https://docs.tutoukeji.com/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.tutoukeji.com/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.tutoukeji.com/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.tutoukeji.com/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.tutoukeji.com/docs/user-guide/features/delegation): Spawn isolated child agents for parallel workstreams with delegate_task
- [Kanban Multi-Agent](https://docs.tutoukeji.com/docs/user-guide/features/kanban): Durable SQLite-backed task board for coordinating multiple Tutou profiles
- [Kanban Tutorial](https://docs.tutoukeji.com/docs/user-guide/features/kanban-tutorial)
- [Persistent Goals](https://docs.tutoukeji.com/docs/user-guide/features/goals): Set a standing goal and let Tutou keep working across turns until it's done. Our take on the Ralph loop.
- [Code Execution](https://docs.tutoukeji.com/docs/user-guide/features/code-execution): Programmatic Python execution with RPC tool access — collapse multi-step workflows into a single turn
- [Hooks](https://docs.tutoukeji.com/docs/user-guide/features/hooks): Run custom code at key lifecycle points — log activity, send alerts, post to webhooks
- [Batch Processing](https://docs.tutoukeji.com/docs/user-guide/features/batch-processing): Generate agent trajectories at scale — parallel processing, checkpointing, and toolset distributions

## Media & Web

- [Voice Mode](https://docs.tutoukeji.com/docs/user-guide/features/voice-mode): Real-time voice conversations with Tutou Agent — CLI, Telegram, Discord (DMs, text channels, and voice channels)
- [Browser](https://docs.tutoukeji.com/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.tutoukeji.com/docs/user-guide/features/vision): Paste images from your clipboard into the Tutou CLI for multimodal vision analysis.
- [Image Generation](https://docs.tutoukeji.com/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 `tutou tools`.
- [Text-to-Speech](https://docs.tutoukeji.com/docs/user-guide/features/tts): Text-to-speech and voice message transcription across all platforms

## Messaging Platforms

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

## Integrations

- [Integrations Overview](https://docs.tutoukeji.com/docs/integrations)
- [Providers](https://docs.tutoukeji.com/docs/integrations/providers)
- [MCP (Model Context Protocol)](https://docs.tutoukeji.com/docs/user-guide/features/mcp): Connect Tutou Agent to external tool servers via MCP — and control exactly which MCP tools Tutou loads
- [ACP (Agent Context Protocol)](https://docs.tutoukeji.com/docs/user-guide/features/acp): Use Tutou Agent inside ACP-compatible editors and collaboration platforms
- [API Server](https://docs.tutoukeji.com/docs/user-guide/features/api-server): Expose tutou-agent as an OpenAI-compatible API for any frontend
- [Honcho Memory](https://docs.tutoukeji.com/docs/user-guide/features/honcho): AI-native persistent memory via Honcho — dialectic reasoning, multi-agent user modeling, and deep personalization
- [Provider Routing](https://docs.tutoukeji.com/docs/user-guide/features/provider-routing): Configure OpenRouter provider preferences to optimize for cost, speed, or quality.
- [Fallback Providers](https://docs.tutoukeji.com/docs/user-guide/features/fallback-providers): Configure automatic failover to backup LLM providers when your primary model is unavailable.
- [Credential Pools](https://docs.tutoukeji.com/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.tutoukeji.com/docs/integrations/buzz): All three ways to connect Tutou Agent to Buzz — Block's Nostr-based human+agent workspace
- [Nous Portal](https://docs.tutoukeji.com/docs/integrations/nous-portal): One subscription, 300+ frontier models, and the Tool Gateway — the recommended way to run Tutou Agent

## Guides & Tutorials

- [Tips & Best Practices](https://docs.tutoukeji.com/docs/guides/tips): Practical advice to get the most out of Tutou Agent — prompt tips, CLI shortcuts, context files, memory, cost optimization, and security
- [Local LLMs on Mac](https://docs.tutoukeji.com/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.tutoukeji.com/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.tutoukeji.com/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 Tutou as a Python Library](https://docs.tutoukeji.com/docs/guides/python-library): Embed AIAgent in your own Python scripts, web apps, or automation pipelines — no CLI required
- [Use MCP with Tutou](https://docs.tutoukeji.com/docs/guides/use-mcp-with-tutou): A practical guide to connecting MCP servers to Tutou Agent, filtering their tools, and using them safely in real workflows
- [Use Voice Mode with Tutou](https://docs.tutoukeji.com/docs/guides/use-voice-mode-with-tutou): A practical guide to setting up and using Tutou voice mode across CLI, Telegram, Discord, and Discord voice channels
- [Use SOUL.md with Tutou](https://docs.tutoukeji.com/docs/guides/use-soul-with-tutou): How to use SOUL.md to shape Tutou Agent's default voice, what belongs there, and how it differs from AGENTS.md and /personality
- [Automate with Cron](https://docs.tutoukeji.com/docs/guides/automate-with-cron): Real-world automation patterns using Tutou cron — monitoring, reports, pipelines, and multi-skill workflows
- [Work with Skills](https://docs.tutoukeji.com/docs/guides/work-with-skills): Find, install, use, and create skills — on-demand knowledge that teaches Tutou new workflows
- [Delegation Patterns](https://docs.tutoukeji.com/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.tutoukeji.com/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.tutoukeji.com/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.tutoukeji.com/docs/guides/automation-blueprints): Ready-to-use automation blueprints — scheduled tasks, GitHub event triggers, API webhooks, and multi-skill workflows
- [AWS Bedrock](https://docs.tutoukeji.com/docs/guides/aws-bedrock): Use Tutou 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.tutoukeji.com/docs/guides/azure-foundry): Use Tutou 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.tutoukeji.com/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.tutoukeji.com/docs/guides/cron-troubleshooting): Diagnose and fix common Tutou cron issues — jobs not firing, delivery failures, skill loading errors, and performance problems
- [Desktop Native Sign-In (RFC 8252)](https://docs.tutoukeji.com/docs/guides/desktop-native-signin): How the Tutou Desktop app signs in to a gated gateway using your system browser and PKCE — no embedded webview, no session cookies
- [Google Gemini](https://docs.tutoukeji.com/docs/guides/google-gemini): Use Tutou Agent with Google Gemini — native AI Studio API, API-key setup, tool calling, streaming, and quota guidance
- [Google Vertex AI](https://docs.tutoukeji.com/docs/guides/google-vertex): Use Tutou Agent with Gemini on Google Cloud Vertex AI — OAuth2 service account or ADC, GCP billing and quotas, no static API key
- [Run Tutou Locally with Ollama — Zero API Cost](https://docs.tutoukeji.com/docs/guides/local-ollama-setup): Step-by-step guide to running Tutou Agent entirely on your own machine with Ollama and open-weight models like Gemma 4, no cloud API keys or paid subscriptions needed
- [Manage Tutou Cloud with MCP](https://docs.tutoukeji.com/docs/guides/manage-tutou-cloud-with-mcp): Connect Tutou Agent to the Nous Portal MCP server so your local agent can list, start, stop, and manage your Tutou Cloud instances conversationally
- [Register a Microsoft Graph Application](https://docs.tutoukeji.com/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.tutoukeji.com/docs/guides/migrate-from-openclaw): Complete guide to migrating your OpenClaw / Clawdbot setup to Tutou Agent — what gets migrated, how config maps, and what to check after.
- [MiniMax OAuth](https://docs.tutoukeji.com/docs/guides/minimax-oauth): Log into MiniMax via browser OAuth and use MiniMax-M2.7 models in Tutou Agent — no API key required
- [OAuth over SSH / Remote Hosts](https://docs.tutoukeji.com/docs/guides/oauth-over-ssh): How to complete browser-based OAuth (Spotify, MCP servers) when Tutou runs on a remote machine, container, or behind a jump box
- [Operate the Teams Meeting Pipeline](https://docs.tutoukeji.com/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.tutoukeji.com/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 `tutou send`.
- [Run Nemotron 3 Ultra free in Tutou Agent](https://docs.tutoukeji.com/docs/guides/run-nemotron-3-ultra-free): Try NVIDIA Nemotron 3 Ultra on Nous Portal — free June 4–18 — with day 0 support in Tutou Agent
- [Run Tutou Agent with Nous Portal](https://docs.tutoukeji.com/docs/guides/run-tutou-with-nous-portal): Start-to-finish walkthrough: subscribe, set up, switch models, enable gateway tools, and verify routing
- [Running Tutou on a Personal or Work Machine](https://docs.tutoukeji.com/docs/guides/secure-tutou-on-a-work-machine): A security-posture walkthrough for running Tutou 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.tutoukeji.com/docs/guides/troubleshooting-agent-quality): A diagnostic checklist for when Tutou 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.tutoukeji.com/docs/guides/webhook-github-pr-review): Connect Tutou 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.tutoukeji.com/docs/guides/xai-grok-oauth): Sign in with your SuperGrok or X Premium+ subscription to use Grok models in Tutou Agent — no API key required

## Developer Guide

- [Contributing](https://docs.tutoukeji.com/docs/developer-guide/contributing): How to contribute to Tutou Agent — dev setup, code style, PR process
- [Architecture](https://docs.tutoukeji.com/docs/developer-guide/architecture): Tutou Agent internals — major subsystems, execution paths, data flow, and where to read next
- [Agent Loop](https://docs.tutoukeji.com/docs/developer-guide/agent-loop): Detailed walkthrough of AIAgent execution, API modes, tools, callbacks, and fallback behavior
- [Prompt Assembly](https://docs.tutoukeji.com/docs/developer-guide/prompt-assembly): How Tutou builds the system prompt, preserves cache stability, and injects ephemeral layers
- [Context Compression & Caching](https://docs.tutoukeji.com/docs/developer-guide/context-compression-and-caching)
- [Gateway Internals](https://docs.tutoukeji.com/docs/developer-guide/gateway-internals): How the messaging gateway boots, authorizes users, routes sessions, and delivers messages
- [Session Storage](https://docs.tutoukeji.com/docs/developer-guide/session-storage)
- [Provider Runtime](https://docs.tutoukeji.com/docs/developer-guide/provider-runtime): How Tutou resolves providers, credentials, API modes, and auxiliary models at runtime
- [Adding Tools](https://docs.tutoukeji.com/docs/developer-guide/adding-tools): How to add a new tool to Tutou Agent — schemas, handlers, registration, and toolsets
- [Adding Providers](https://docs.tutoukeji.com/docs/developer-guide/adding-providers): How to add a new inference provider to Tutou Agent — auth, runtime resolution, CLI flows, adapters, tests, and docs
- [Adding Platform Adapters](https://docs.tutoukeji.com/docs/developer-guide/adding-platform-adapters)
- [Creating Skills](https://docs.tutoukeji.com/docs/developer-guide/creating-skills): How to create skills for Tutou Agent — SKILL.md format, guidelines, and publishing
- [Extending the CLI](https://docs.tutoukeji.com/docs/developer-guide/extending-the-cli): Build wrapper CLIs that extend the Tutou TUI with custom widgets, keybindings, and layout changes
- [ACP Internals](https://docs.tutoukeji.com/docs/developer-guide/acp-internals): How the ACP adapter works: lifecycle, sessions, event bridge, approvals, and tool rendering
- [Billing Lifecycle (TUI)](https://docs.tutoukeji.com/docs/developer-guide/billing-lifecycle): Map from every billing/subscription state and typed refusal to the exact TUI copy and recovery action
- [Browser Provider Plugins](https://docs.tutoukeji.com/docs/developer-guide/browser-provider-plugin): How to build a cloud browser backend plugin for Tutou Agent
- [Browser CDP Supervisor](https://docs.tutoukeji.com/docs/developer-guide/browser-supervisor): How Tutou detects and responds to native JS dialogs and interacts with cross-origin iframes via a persistent CDP connection.
- [Chronos Managed-Cron Contract](https://docs.tutoukeji.com/docs/developer-guide/chronos-managed-cron-contract): Agent ↔ NAS wire contract for the Chronos cron provider
- [CLI Internals](https://docs.tutoukeji.com/docs/developer-guide/cli-internals): How tutou_cli is shaped: slash dispatch, config loaders, the skin engine, the transactional update pipeline, and process-identity rules
- [Codebase Ownership Map](https://docs.tutoukeji.com/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.tutoukeji.com/docs/developer-guide/completion-backlog-delivery)
- [Context Engine Plugins](https://docs.tutoukeji.com/docs/developer-guide/context-engine-plugin): How to build a context engine plugin that replaces the built-in ContextCompressor
- [Cron Internals](https://docs.tutoukeji.com/docs/developer-guide/cron-internals): How Tutou stores, schedules, edits, pauses, skill-loads, and delivers cron jobs
- [Desktop Plugin SDK (@tutou/plugin-sdk)](https://docs.tutoukeji.com/docs/developer-guide/desktop-plugin-sdk): Extend the native Tutou 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.tutoukeji.com/docs/developer-guide/egress-internals): How the iron-proxy egress firewall integrates with Tutou — module layout, lifecycle, security invariants, and extension points
- [Gateway Monitoring](https://docs.tutoukeji.com/docs/developer-guide/gateway-monitoring): Health export, structured diagnostics, fleet queries and how to extend the monitoring plane
- [Gateway Session Lifecycle](https://docs.tutoukeji.com/docs/developer-guide/gateway-session-lifecycle): SessionSource, SessionEntry, SessionStore, session-key rules and multi-user isolation in the gateway
- [Image Generation Provider Plugins](https://docs.tutoukeji.com/docs/developer-guide/image-gen-provider-plugin): How to build an image-generation backend plugin for Tutou Agent
- [macOS bundle updates](https://docs.tutoukeji.com/docs/developer-guide/macos-bundle-updates)
- [Memory Provider Plugins](https://docs.tutoukeji.com/docs/developer-guide/memory-provider-plugin): How to build a memory provider plugin for Tutou Agent
- [Micro-compaction](https://docs.tutoukeji.com/docs/developer-guide/micro-compaction): How micro-compaction amortizes context compression cost: triggers, tail sizing, the cached-prefix trade-off
- [Middleware](https://docs.tutoukeji.com/docs/developer-guide/middleware): Behavior-changing plugin middleware for LLM and tool calls: contract, execution order, examples
- [Model Provider Plugins](https://docs.tutoukeji.com/docs/developer-guide/model-provider-plugin): How to build a model provider (inference backend) plugin for Tutou Agent
- [Multiplexing Gateway Internals](https://docs.tutoukeji.com/docs/developer-guide/multiplexing-gateway): Design of the one-gateway-for-all-profiles mode: scope composition, secret scope, inbound routing, persistence
- [Observer Hooks](https://docs.tutoukeji.com/docs/developer-guide/observer-hooks): Read-only telemetry contract for plugins: event families, correlation IDs, payload safety
- [Onboarding recommendations](https://docs.tutoukeji.com/docs/developer-guide/onboarding-recommendations)
- [Plugin LLM Access](https://docs.tutoukeji.com/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 Tutou Plugin](https://docs.tutoukeji.com/docs/developer-guide/plugins): Step-by-step guide to building a complete Tutou plugin with tools, hooks, data files, and skills
- [Application declarations](https://docs.tutoukeji.com/docs/developer-guide/plugins/application-declarations)
- [Submitting to the Plugin Catalog](https://docs.tutoukeji.com/docs/developer-guide/plugins/catalog-submission): The full admission guidelines for the Tutou plugin catalog: what to check before you submit, the rules every entry follows, and what reviewers look at
- [PM audit remediation status](https://docs.tutoukeji.com/docs/developer-guide/pm-audit-status)
- [Programmatic Integration](https://docs.tutoukeji.com/docs/developer-guide/programmatic-integration): Three protocols for driving tutou-agent from external programs: ACP, the TUI gateway JSON-RPC, and the OpenAI-compatible HTTP API
- [Relay ↔ Connector Contract](https://docs.tutoukeji.com/docs/developer-guide/relay-connector-contract): Wire contract between the Tutou gateway relay adapter and external connectors (experimental)
- [Relay Shared Metrics](https://docs.tutoukeji.com/docs/developer-guide/relay-shared-metrics): NeMo Relay shared metrics: what is exported, consent and retention, staging validation
- [Secret Source Plugins](https://docs.tutoukeji.com/docs/developer-guide/secret-source-plugin): How to build a secret-manager backend plugin for Tutou Agent
- [Shared bundle builds](https://docs.tutoukeji.com/docs/developer-guide/shared-bundle-builds)
- [Source update completion ownership](https://docs.tutoukeji.com/docs/developer-guide/source-update-completion)
- [Stable release admission and promotion](https://docs.tutoukeji.com/docs/developer-guide/stable-releases)
- [State DB Recovery](https://docs.tutoukeji.com/docs/developer-guide/state-db-recovery): How Tutou recovers state.db when the FTS index or the file itself is corrupt
- [Streaming TTS Internals](https://docs.tutoukeji.com/docs/developer-guide/streaming-tts): Sentence chunker, streaming provider ABC, capability matrix and how to add a streaming TTS provider
- [Public Subagent Lifecycle API](https://docs.tutoukeji.com/docs/developer-guide/subagent-lifecycle-api)
- [Terminal Environment Provider Plugins](https://docs.tutoukeji.com/docs/developer-guide/terminal-environment-plugin)
- [Tools Runtime](https://docs.tutoukeji.com/docs/developer-guide/tools-runtime): Runtime behavior of the tool registry, toolsets, dispatch, and terminal environments
- [Trajectory Format](https://docs.tutoukeji.com/docs/developer-guide/trajectory-format)
- [Video Generation Provider Plugins](https://docs.tutoukeji.com/docs/developer-guide/video-gen-provider-plugin): How to build a video-generation backend plugin for Tutou Agent
- [Web Search Provider Plugins](https://docs.tutoukeji.com/docs/developer-guide/web-search-provider-plugin): How to build a web-search/extract/crawl backend plugin for Tutou Agent
- [TUI & Desktop from Worktrees](https://docs.tutoukeji.com/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.tutoukeji.com/docs/reference/cli-commands): Authoritative reference for Tutou terminal commands and command families
- [Slash Commands](https://docs.tutoukeji.com/docs/reference/slash-commands): Complete reference for interactive CLI and messaging slash commands
- [Profile Commands](https://docs.tutoukeji.com/docs/reference/profile-commands)
- [Environment Variables](https://docs.tutoukeji.com/docs/reference/environment-variables): Complete reference of all environment variables used by Tutou Agent
- [Tools Reference](https://docs.tutoukeji.com/docs/reference/tools-reference): Authoritative reference for Tutou built-in tools, grouped by toolset
- [Toolsets Reference](https://docs.tutoukeji.com/docs/reference/toolsets-reference): Reference for Tutou core, composite, platform, and dynamic toolsets
- [MCP Config Reference](https://docs.tutoukeji.com/docs/reference/mcp-config-reference): Reference for Tutou Agent MCP configuration keys, filtering semantics, and utility-tool policy
- [Model Catalog](https://docs.tutoukeji.com/docs/reference/model-catalog): Remotely-hosted manifest driving curated model picker lists for OpenRouter and Nous Portal.
- [Bundled Skills Catalog](https://docs.tutoukeji.com/docs/reference/skills-catalog): Table of all ~90 skills bundled with Tutou
- [Optional Skills Catalog](https://docs.tutoukeji.com/docs/reference/optional-skills-catalog): Table of ~60 additional installable skills
- [FAQ & Troubleshooting](https://docs.tutoukeji.com/docs/reference/faq): Frequently asked questions and solutions to common issues with Tutou Agent
- [Automation Blueprints Catalog](https://docs.tutoukeji.com/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.tutoukeji.com/docs/reference/cli-symbols): What every symbol in the Tutou terminal UI means — transcript markers, status-bar badges, overlay glyphs, and approval prompts.
- [Package Management](https://docs.tutoukeji.com/docs/reference/package-management): PM tool pins, Python environments, optional dependencies, and installation ownership

## More

- [User Stories & Use Cases](https://docs.tutoukeji.com/docs/user-stories): Real stories from the Tutou Agent community — what people are actually building, scraped from X, GitHub, Reddit, Hacker News, YouTube, blogs, and podcasts.