# Subnaut Agent

> The agent for Bittensor, built by Subnaut Labs. Reads subnets, metagraphs and stake from the chain, runs btcli with approval on every signature, and ships miner, validator and subnet-owner skills. A terminal-native autonomous agent with persistent memory, agent-created skills, and a messaging gateway for Telegram, Discord, Slack, webhooks, and an OpenAI-compatible API server. 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://tryimagent.com/install.sh | bash`  (Linux, macOS, WSL2, Termux); Windows: `irm https://tryimagent.com/install.ps1 | iex`

Releases: https://tryimagent.com/releases

## Getting Started

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

## Using Subnaut

- [CLI](https://tryimagent.com/user-guide/cli): Master the Subnaut Agent terminal interface — commands, keybindings, personalities, and more
- [TUI (Ink terminal UI)](https://tryimagent.com/user-guide/tui): Launch the modern terminal UI for Subnaut — mouse-friendly, rich overlays, and non-blocking input.
- [Configuration](https://tryimagent.com/user-guide/configuration): Configure Subnaut Agent — config.yaml, providers, models, API keys, and more
- [Configuring Models](https://tryimagent.com/user-guide/configuring-models)
- [Sessions](https://tryimagent.com/user-guide/sessions): Session persistence, resume, search, management, and per-platform session tracking
- [Profiles](https://tryimagent.com/user-guide/profiles)
- [Git Worktrees](https://tryimagent.com/user-guide/git-worktrees): Run multiple Subnaut agents safely on the same repository using git worktrees and isolated checkouts
- [Docker Backend](https://tryimagent.com/user-guide/docker): Running Subnaut Agent in Docker and using Docker as a terminal backend
- [Security](https://tryimagent.com/user-guide/security): Security model, dangerous command approval, user authorization, container isolation, and production deployment best practices
- [Checkpoints & Rollback](https://tryimagent.com/user-guide/checkpoints-and-rollback): Filesystem safety nets for destructive operations using shadow git repos and automatic snapshots
- [Bot Mode](https://tryimagent.com/user-guide/bot-mode): Turn your Subnaut 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.
- [Subnaut Desktop](https://tryimagent.com/user-guide/desktop): The native Subnaut desktop app — a polished experience for chatting with Subnaut, with streaming tool output, side-by-side previews, a file browser, voice, cron, profiles, skills, and settings. macOS, Windows, and Linux.
- [Egress proxy](https://tryimagent.com/user-guide/egress)
- [Egress credential-injection proxy (iron-proxy)](https://tryimagent.com/user-guide/egress/iron-proxy)
- [Import from Other Agents](https://tryimagent.com/user-guide/import-from-other-agents): One-command import of a Claude Code (~/.claude) or OpenAI Codex CLI (~/.codex) setup into Subnaut — instructions, allowlists, MCP servers, skills, and memories.
- [Local Models](https://tryimagent.com/user-guide/local-models): Run models entirely on your own machine — no account, no API key, nothing leaves your computer.
- [Managed Scope](https://tryimagent.com/user-guide/managed-scope): Administrator-pinned, user-immutable config and secrets via a system-level managed directory
- [Connecting Desktop to Many Subnaut Instances](https://tryimagent.com/user-guide/multi-connection-desktop)
- [Running Many Gateways at Once](https://tryimagent.com/user-guide/multi-profile-gateways)
- [Profile Distributions: Share a Whole Agent](https://tryimagent.com/user-guide/profile-distributions)
- [Secrets](https://tryimagent.com/user-guide/secrets)
- [Bitwarden Secrets Manager](https://tryimagent.com/user-guide/secrets/bitwarden)
- [Command Helper Secret Source](https://tryimagent.com/user-guide/secrets/command)
- [1Password](https://tryimagent.com/user-guide/secrets/onepassword)
- [Google Workspace — Gmail, Calendar, Drive, Sheets & Docs](https://tryimagent.com/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://tryimagent.com/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://tryimagent.com/user-guide/windows-native): Run Subnaut 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://tryimagent.com/user-guide/windows-wsl-quickstart): Run Subnaut Agent on Windows via WSL2 — setup, filesystem access between Windows and Linux, networking, and common pitfalls

## Core Features

- [Features Overview](https://tryimagent.com/user-guide/features/overview)
- [Tools](https://tryimagent.com/user-guide/features/tools): Overview of Subnaut Agent's tools — what's available, how toolsets work, and terminal backends
- [Bittensor Chain Tools](https://tryimagent.com/user-guide/features/bittensor): Read-only Bittensor tools for subnets, metagraphs and accounts: what they return, units, networks, and the first-use SDK install
- [Skills System](https://tryimagent.com/user-guide/features/skills): On-demand knowledge documents — progressive disclosure, agent-managed skills, and the Skills Hub
- [Curator](https://tryimagent.com/user-guide/features/curator): Background maintenance for agent-created skills — usage tracking, staleness, archival, and LLM-driven review
- [Memory](https://tryimagent.com/user-guide/features/memory): How Subnaut Agent remembers across sessions — MEMORY.md, USER.md, and session search
- [Memory Providers](https://tryimagent.com/user-guide/features/memory-providers): External memory provider plugins — Honcho, OpenViking, Mem0, Hindsight, Holographic, RetainDB, ByteRover, Supermemory
- [Context Files](https://tryimagent.com/user-guide/features/context-files): Project context files — .subnaut.md, AGENTS.md, CLAUDE.md, global SOUL.md, and .cursorrules — automatically injected into every conversation
- [Context References](https://tryimagent.com/user-guide/features/context-references): Inline @-syntax for attaching files, folders, git diffs, and URLs directly into your messages
- [Personality & SOUL.md](https://tryimagent.com/user-guide/features/personality): Customize Subnaut Agent's personality with a global SOUL.md, built-in personalities, and custom persona definitions
- [Plugins](https://tryimagent.com/user-guide/features/plugins): Extend Subnaut with custom tools, hooks, and integrations via the plugin system
- [Built-in Plugins](https://tryimagent.com/user-guide/features/built-in-plugins): Plugins shipped with Subnaut Agent that run automatically via lifecycle hooks — disk-cleanup and friends
- [Codex App-Server Runtime (optional)](https://tryimagent.com/user-guide/features/codex-app-server-runtime)
- [Computer Use](https://tryimagent.com/user-guide/features/computer-use)
- [Deliverable Mode (Artifacts in Chat)](https://tryimagent.com/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://tryimagent.com/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
- [Session Heartbeats](https://tryimagent.com/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://tryimagent.com/user-guide/features/kanban-worker-lanes)
- [Recurring Loops](https://tryimagent.com/user-guide/features/loops): Re-run a prompt on a recurring interval inside your session — Subnaut's take on Claude Code's /loop.
- [LSP — Semantic Diagnostics](https://tryimagent.com/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://tryimagent.com/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://tryimagent.com/user-guide/features/pets): Adopt an animated mascot that reacts to agent activity across the CLI, TUI, and desktop app
- [Skins & Themes](https://tryimagent.com/user-guide/features/skins): Customize the Subnaut CLI with built-in and user-defined skins
- [Subscription Proxy](https://tryimagent.com/user-guide/features/subscription-proxy): Use your xAI Grok OAuth subscription as an OpenAI-compatible endpoint for external apps
- [Tool Search](https://tryimagent.com/user-guide/features/tool-search)
- [Wake Word](https://tryimagent.com/user-guide/features/wake-word): Hands-free 'Hey Subnaut' wake word — start a voice session by speaking, the 'Hey Siri' way
- [Web Search & Extract](https://tryimagent.com/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://tryimagent.com/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://tryimagent.com/user-guide/features/cron): Schedule automated tasks with natural language, manage them with one cron tool, and attach one or more skills
- [Delegation](https://tryimagent.com/user-guide/features/delegation): Spawn isolated child agents for parallel workstreams with delegate_task
- [Kanban Multi-Agent](https://tryimagent.com/user-guide/features/kanban): Durable SQLite-backed task board for coordinating multiple Subnaut profiles
- [Kanban Tutorial](https://tryimagent.com/user-guide/features/kanban-tutorial)
- [Persistent Goals](https://tryimagent.com/user-guide/features/goals): Set a standing goal and let Subnaut keep working across turns until it's done. Our take on the Ralph loop.
- [Code Execution](https://tryimagent.com/user-guide/features/code-execution): Programmatic Python execution with RPC tool access — collapse multi-step workflows into a single turn
- [Hooks](https://tryimagent.com/user-guide/features/hooks): Run custom code at key lifecycle points — log activity, send alerts, post to webhooks

## Media & Web

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

## Messaging Platforms

- [Overview](https://tryimagent.com/user-guide/messaging): Chat with Subnaut from Telegram, Discord, Slack, Webhooks, or any OpenAI-compatible frontend via the API server — architecture and setup overview
- [Telegram](https://tryimagent.com/user-guide/messaging/telegram): Set up Subnaut Agent as a Telegram bot
- [Discord](https://tryimagent.com/user-guide/messaging/discord): Set up Subnaut Agent as a Discord bot
- [Slack](https://tryimagent.com/user-guide/messaging/slack): Set up Subnaut Agent as a Slack bot using Socket Mode
- [Webhooks](https://tryimagent.com/user-guide/messaging/webhooks): Receive events from GitHub, GitLab, and other services to trigger Subnaut agent runs
- [Open WebUI](https://tryimagent.com/user-guide/messaging/open-webui): Connect Open WebUI to Subnaut Agent via the OpenAI-compatible API server

## Integrations

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

## Guides & Tutorials

- [Tips & Best Practices](https://tryimagent.com/guides/tips): Practical advice to get the most out of Subnaut Agent — prompt tips, CLI shortcuts, context files, memory, cost optimization, and security
- [Local LLMs on Mac](https://tryimagent.com/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://tryimagent.com/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://tryimagent.com/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 Subnaut as a Python Library](https://tryimagent.com/guides/python-library): Embed AIAgent in your own Python scripts, web apps, or automation pipelines — no CLI required
- [Use MCP with Subnaut](https://tryimagent.com/guides/use-mcp-with-subnaut): A practical guide to connecting MCP servers to Subnaut Agent, filtering their tools, and using them safely in real workflows
- [Use Voice Mode with Subnaut](https://tryimagent.com/guides/use-voice-mode-with-subnaut): A practical guide to setting up and using Subnaut voice mode across CLI, Telegram, Discord, and Discord voice channels
- [Use SOUL.md with Subnaut](https://tryimagent.com/guides/use-soul-with-subnaut): How to use SOUL.md to shape Subnaut Agent's default voice, what belongs there, and how it differs from AGENTS.md and /personality
- [Automate with Cron](https://tryimagent.com/guides/automate-with-cron): Real-world automation patterns using Subnaut cron — monitoring, reports, pipelines, and multi-skill workflows
- [Work with Skills](https://tryimagent.com/guides/work-with-skills): Find, install, use, and create skills — on-demand knowledge that teaches Subnaut new workflows
- [Delegation Patterns](https://tryimagent.com/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://tryimagent.com/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://tryimagent.com/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://tryimagent.com/guides/automation-blueprints): Ready-to-use automation blueprints — scheduled tasks, GitHub event triggers, API webhooks, and multi-skill workflows
- [Script-Only Cron Jobs (No LLM)](https://tryimagent.com/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://tryimagent.com/guides/cron-troubleshooting): Diagnose and fix common Subnaut cron issues — jobs not firing, delivery failures, skill loading errors, and performance problems
- [Desktop Native Sign-In (RFC 8252)](https://tryimagent.com/guides/desktop-native-signin): How the Subnaut Desktop app signs in to a gated gateway using your system browser and PKCE — no embedded webview, no session cookies
- [Google Gemini](https://tryimagent.com/guides/google-gemini): Use Subnaut Agent with Google Gemini — native AI Studio API, API-key setup, tool calling, streaming, and quota guidance
- [Run Subnaut Locally with Ollama — Zero API Cost](https://tryimagent.com/guides/local-ollama-setup): Step-by-step guide to running Subnaut Agent entirely on your own machine with Ollama and open-weight models like Gemma 4, no cloud API keys or paid subscriptions needed
- [MiniMax OAuth](https://tryimagent.com/guides/minimax-oauth): Log into MiniMax via browser OAuth and use MiniMax-M2.7 models in Subnaut Agent — no API key required
- [OAuth over SSH / Remote Hosts](https://tryimagent.com/guides/oauth-over-ssh): How to complete browser-based OAuth for MCP servers when Subnaut runs on a remote machine, container, or behind a jump box
- [Pipe Script Output to Messaging Platforms](https://tryimagent.com/guides/pipe-script-output): Send text from any shell script, cron job, CI hook, or monitoring daemon to Telegram, Discord, Slack, and other platforms using `subnaut send`.
- [Running Subnaut on a Personal or Work Machine](https://tryimagent.com/guides/secure-subnaut-on-a-work-machine): A security-posture walkthrough for running Subnaut 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://tryimagent.com/guides/troubleshooting-agent-quality): A diagnostic checklist for when Subnaut 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://tryimagent.com/guides/webhook-github-pr-review): Connect Subnaut 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://tryimagent.com/guides/xai-grok-oauth): Sign in with your SuperGrok or X Premium+ subscription to use Grok models in Subnaut Agent — no API key required

## Developer Guide

- [Contributing](https://tryimagent.com/developer-guide/contributing): How to contribute to Subnaut Agent — dev setup, code style, PR process
- [Architecture](https://tryimagent.com/developer-guide/architecture): Subnaut Agent internals — major subsystems, execution paths, data flow, and where to read next
- [Agent Loop](https://tryimagent.com/developer-guide/agent-loop): Detailed walkthrough of AIAgent execution, API modes, tools, callbacks, and fallback behavior
- [Prompt Assembly](https://tryimagent.com/developer-guide/prompt-assembly): How Subnaut builds the system prompt, preserves cache stability, and injects ephemeral layers
- [Context Compression & Caching](https://tryimagent.com/developer-guide/context-compression-and-caching)
- [Gateway Internals](https://tryimagent.com/developer-guide/gateway-internals): How the messaging gateway boots, authorizes users, routes sessions, and delivers messages
- [Session Storage](https://tryimagent.com/developer-guide/session-storage)
- [Provider Runtime](https://tryimagent.com/developer-guide/provider-runtime): How Subnaut resolves providers, credentials, API modes, and auxiliary models at runtime
- [Adding Tools](https://tryimagent.com/developer-guide/adding-tools): How to add a new tool to Subnaut Agent — schemas, handlers, registration, and toolsets
- [Adding Providers](https://tryimagent.com/developer-guide/adding-providers): How to add a new inference provider to Subnaut Agent — auth, runtime resolution, CLI flows, adapters, tests, and docs
- [Adding Platform Adapters](https://tryimagent.com/developer-guide/adding-platform-adapters)
- [Creating Skills](https://tryimagent.com/developer-guide/creating-skills): How to create skills for Subnaut Agent — SKILL.md format, guidelines, and publishing
- [Extending the CLI](https://tryimagent.com/developer-guide/extending-the-cli): Build wrapper CLIs that extend the Subnaut TUI with custom widgets, keybindings, and layout changes
- [ACP Internals](https://tryimagent.com/developer-guide/acp-internals): How the ACP adapter works: lifecycle, sessions, event bridge, approvals, and tool rendering
- [Browser Provider Plugins](https://tryimagent.com/developer-guide/browser-provider-plugin): How to build a cloud browser backend plugin for Subnaut Agent
- [Browser CDP Supervisor](https://tryimagent.com/developer-guide/browser-supervisor): How Subnaut detects and responds to native JS dialogs and interacts with cross-origin iframes via a persistent CDP connection.
- [CLI Internals](https://tryimagent.com/developer-guide/cli-internals): How subnaut_cli is shaped: slash dispatch, config loaders, the skin engine, the transactional update pipeline, and process-identity rules
- [Codebase Ownership Map](https://tryimagent.com/developer-guide/codebase-ownership): Which directories belong to which subsystem, and where the right docs entry point lives for each
- [Background completion backlogs](https://tryimagent.com/developer-guide/completion-backlog-delivery)
- [Context Engine Plugins](https://tryimagent.com/developer-guide/context-engine-plugin): How to build a context engine plugin that replaces the built-in ContextCompressor
- [Cron Internals](https://tryimagent.com/developer-guide/cron-internals): How Subnaut stores, schedules, edits, pauses, skill-loads, and delivers cron jobs
- [Desktop Plugin SDK (@subnaut/plugin-sdk)](https://tryimagent.com/developer-guide/desktop-plugin-sdk): Extend the native Subnaut 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://tryimagent.com/developer-guide/egress-internals): How the iron-proxy egress firewall integrates with Subnaut — module layout, lifecycle, security invariants, and extension points
- [Image Generation Provider Plugins](https://tryimagent.com/developer-guide/image-gen-provider-plugin): How to build an image-generation backend plugin for Subnaut Agent
- [Memory Provider Plugins](https://tryimagent.com/developer-guide/memory-provider-plugin): How to build a memory provider plugin for Subnaut Agent
- [Model Provider Plugins](https://tryimagent.com/developer-guide/model-provider-plugin): How to build a model provider (inference backend) plugin for Subnaut Agent
- [Plugin LLM Access](https://tryimagent.com/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 Subnaut Plugin](https://tryimagent.com/developer-guide/plugins): Step-by-step guide to building a complete Subnaut plugin with tools, hooks, data files, and skills
- [Programmatic Integration](https://tryimagent.com/developer-guide/programmatic-integration): Three protocols for driving subnaut-agent from external programs: ACP, the TUI gateway JSON-RPC, and the OpenAI-compatible HTTP API
- [Secret Source Plugins](https://tryimagent.com/developer-guide/secret-source-plugin): How to build a secret-manager backend plugin for Subnaut Agent
- [Public Subagent Lifecycle API](https://tryimagent.com/developer-guide/subagent-lifecycle-api)
- [Terminal Environment Provider Plugins](https://tryimagent.com/developer-guide/terminal-environment-plugin)
- [Tools Runtime](https://tryimagent.com/developer-guide/tools-runtime): Runtime behavior of the tool registry, toolsets, dispatch, and terminal environments
- [Trajectory Format](https://tryimagent.com/developer-guide/trajectory-format)
- [Web Search Provider Plugins](https://tryimagent.com/developer-guide/web-search-provider-plugin): How to build a web-search/extract/crawl backend plugin for Subnaut Agent
- [TUI & Desktop from Worktrees](https://tryimagent.com/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://tryimagent.com/reference/cli-commands): Authoritative reference for Subnaut terminal commands and command families
- [Slash Commands](https://tryimagent.com/reference/slash-commands): Complete reference for interactive CLI and messaging slash commands
- [Profile Commands](https://tryimagent.com/reference/profile-commands)
- [Environment Variables](https://tryimagent.com/reference/environment-variables): Complete reference of all environment variables used by Subnaut Agent
- [Tools Reference](https://tryimagent.com/reference/tools-reference): Authoritative reference for Subnaut built-in tools, grouped by toolset
- [Toolsets Reference](https://tryimagent.com/reference/toolsets-reference): Reference for Subnaut core, composite, platform, and dynamic toolsets
- [MCP Config Reference](https://tryimagent.com/reference/mcp-config-reference): Reference for Subnaut Agent MCP configuration keys, filtering semantics, and utility-tool policy
- [Model Catalog](https://tryimagent.com/reference/model-catalog): Remotely-hosted manifest driving the curated OpenRouter model picker list.
- [Skills Catalog](https://tryimagent.com/reference/skills-catalog): Table of all ~150 skills that ship with Subnaut, active by default
- [FAQ & Troubleshooting](https://tryimagent.com/reference/faq): Frequently asked questions and solutions to common issues with Subnaut Agent
- [Automation Blueprints Catalog](https://tryimagent.com/reference/automation-blueprints-catalog): Ready-to-run automation blueprints — set one up from the CLI, TUI, any messenger, or the desktop app.
- [CLI Symbols Glossary](https://tryimagent.com/reference/cli-symbols): What every symbol in the Subnaut terminal UI means — transcript markers, status-bar badges, overlay glyphs, and approval prompts.