# Nastech Agent

> The self-improving AI agent built by Nastech Research. 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 Nastech Portal, OpenRouter, OpenAI, Anthropic, Google, or any OpenAI-compatible endpoint.

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

Repo: https://github.com/NastechResearch/nastech-agent

## Getting Started

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

## Using Nastech

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

## Core Features

- [Features Overview](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/overview)
- [Tools](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/tools): Overview of Nastech Agent's tools — what's available, how toolsets work, and terminal backends
- [Skills System](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/skills): On-demand knowledge documents — progressive disclosure, agent-managed skills, and the Skills Hub
- [Curator](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/curator): Background maintenance for agent-created skills — usage tracking, staleness, archival, and LLM-driven review
- [Memory](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/memory): How Nastech Agent remembers across sessions — MEMORY.md, USER.md, and session search
- [Memory Providers](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/memory-providers): External memory provider plugins — Honcho, OpenViking, Mem0, Hindsight, Holographic, RetainDB, ByteRover, Supermemory
- [Context Files](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/context-files): Project context files — .nastech.md, AGENTS.md, CLAUDE.md, global SOUL.md, and .cursorrules — automatically injected into every conversation
- [Context References](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/context-references): Inline @-syntax for attaching files, folders, git diffs, and URLs directly into your messages
- [Personality & SOUL.md](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/personality): Customize Nastech Agent's personality with a global SOUL.md, built-in personalities, and custom persona definitions
- [Plugins](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/plugins): Extend Nastech with custom tools, hooks, and integrations via the plugin system
- [Built-in Plugins](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/built-in-plugins): Plugins shipped with Nastech Agent that run automatically via lifecycle hooks — disk-cleanup and friends
- [Codex App-Server Runtime (optional)](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/codex-app-server-runtime)
- [Computer Use](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/computer-use)
- [Passwords & Logins](https://nastechresearch.github.io/nastech-agent/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://nastechresearch.github.io/nastech-agent/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://nastechresearch.github.io/nastech-agent/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://nastechresearch.github.io/nastech-agent/docs/user-guide/features/extending-the-dashboard): Build themes and plugins for the Nastech web dashboard — palettes, typography, layouts, custom tabs, shell slots, page-scoped slots, and backend API routes
- [Session Heartbeats](https://nastechresearch.github.io/nastech-agent/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://nastechresearch.github.io/nastech-agent/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://nastechresearch.github.io/nastech-agent/docs/user-guide/features/kanban-worker-lanes)
- [Recurring Loops](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/loops): Re-run a prompt on a recurring interval inside your session — Nastech' take on Claude Code's /loop.
- [LSP — Semantic Diagnostics](https://nastechresearch.github.io/nastech-agent/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://nastechresearch.github.io/nastech-agent/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://nastechresearch.github.io/nastech-agent/docs/user-guide/features/pets): Adopt an animated mascot that reacts to agent activity across the CLI, TUI, and desktop app
- [Plugin Catalog](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/plugin-catalog): Browse and install reviewed, SHA-pinned Nastech plugins from the curated catalog
- [Skins & Themes](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/skins): Customize the Nastech CLI with built-in and user-defined skins
- [Spotify](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/spotify)
- [Subscription Proxy](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/subscription-proxy): Use your Nastech Portal subscription (or other OAuth provider) as an OpenAI-compatible endpoint for external apps
- [Nastech Tool Gateway](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/tool-gateway): One subscription, every tool. Web search, image generation, TTS, and cloud browsers — all routed through Nastech Portal with no extra API keys.
- [Tool Search](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/tool-search)
- [Wake Word](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/wake-word): Hands-free 'Hey Nastech' wake word — start a voice session by speaking, the 'Hey Siri' way
- [Nastech Web Dashboard](https://nastechresearch.github.io/nastech-agent/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://nastechresearch.github.io/nastech-agent/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://nastechresearch.github.io/nastech-agent/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://nastechresearch.github.io/nastech-agent/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://nastechresearch.github.io/nastech-agent/docs/user-guide/features/delegation): Spawn isolated child agents for parallel workstreams with delegate_task
- [Kanban Multi-Agent](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/kanban): Durable SQLite-backed task board for coordinating multiple Nastech profiles
- [Kanban Tutorial](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/kanban-tutorial)
- [Persistent Goals](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/goals): Set a standing goal and let Nastech keep working across turns until it's done. Our take on the Ralph loop.
- [Code Execution](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/code-execution): Programmatic Python execution with RPC tool access — collapse multi-step workflows into a single turn
- [Hooks](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/hooks): Run custom code at key lifecycle points — log activity, send alerts, post to webhooks
- [Batch Processing](https://nastechresearch.github.io/nastech-agent/docs/user-guide/features/batch-processing): Generate agent trajectories at scale — parallel processing, checkpointing, and toolset distributions

## Media & Web

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

## Messaging Platforms

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

## Integrations

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

## Guides & Tutorials

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

## Developer Guide

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

## More

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