# Agenvoy Wiki

> [!NOTE]
> This wiki was generated by [SKILL](https://github.com/pardnchiu/skill-wiki-generate).

***

**Agenvoy** makes AI actually work for you — a personal AI assistant runtime that is always-on, model-agnostic, and self-improving. A single Go daemon talks to multiple LLM providers (Claude / GPT / Gemini auto-routed), reaches you through Telegram / Discord / TUI / browser, and lets the agent build & persist its own tools as you ask.

## Highlights

- **Seven LLM providers** — Claude · OpenAI · Codex (OAuth) · Gemini · GitHub Copilot · Nvidia NIM · Compat (any OpenAI-compatible endpoint, Zed-style `/v1` URL)
- **Dispatcher-based routing** — a dispatcher LLM routes each task to the best-fit worker (Claude for coding, Gemini for video, GPT for research)
- **Three-pass concurrent tool dispatch** — read tools fan out concurrently; write tools stay serial for safety
- **Multi-layer memory** — rolling summary (incremental, timestamp-cursored) + 16-message recent history + keyword/semantic dual search + cross-session error memory with 90-day TTL
- **Native document RAG** — KuraDB in-process child process (`rag_list_db` / `rag_search_keyword` / `rag_search_semantic`), enabled via `/kuradb` in the TUI
- **Skill system** — loadable markdown skill packs triggered by `/skill-name` or `activate_skill`; scheduler skills isolated under `~/.config/agenvoy/skills/scheduler/<short>-<hash8>/`
- **OS sandbox** — Linux bubblewrap / macOS sandbox-exec; tools execute in isolation
- **MCP client** — stdio + HTTP/SSE; tools auto-inject as `mcp__<server>__<tool>`
- **Chat platform integration** — Telegram (6-digit OTP first-contact verification) + Discord (native select menus / modals); cross-session push via `send_to_telegram_chat` / `send_to_discord_channel`
- **Voice & image** — `[SEND_VOICE:text]` → Gemini TTS (OGG/OPUS); `generate_image` → gpt-image-2 (codex OAuth backend); inbound attachments saved to download dir
- **Sub-agents & external agents** — `invoke_subagent` (in-process) + `invoke_external_agent` (codex / copilot / claude / gemini CLI) + `cross_review_with_external_agents` (parallel review)
- **Scheduler** — cron / one-shot tasks, fsnotify hot-reload, output push back to Telegram/Discord
- **Send-timeout 3-layer system** — Transport `ResponseHeaderTimeout=10s` · `Client.Timeout` 5m / 10m (SSE) · exec layer `AgentSendTimeout` 600s with retry

## Pages

| English | 中文 |
|---|---|
| [Getting Started](Getting-Started.md) | [新手入門](Getting-Started.zh.md) |
| [Architecture](Architecture.md) | [架構](Architecture.zh.md) |
| [Core Concepts](Core-Concepts.md) | [核心概念](Core-Concepts.zh.md) |
| [Providers](Providers.md) | [Provider 設定](Providers.zh.md) |
| [Tools](Tools.md) | [工具系統](Tools.zh.md) |
| [Memory System](Memory-System.md) | [記憶系統](Memory-System.zh.md) |
| [KuraDB RAG](KuraDB-RAG.md) | [KuraDB RAG](KuraDB-RAG.zh.md) |
| [Skill System](Skill-System.md) | [Skill 系統](Skill-System.zh.md) |
| [MCP Integration](MCP-Integration.md) | [MCP 整合](MCP-Integration.zh.md) |
| [Security and Sandbox](Security-and-Sandbox.md) | [安全與沙箱](Security-and-Sandbox.zh.md) |
| [CLI Reference](CLI-Reference.md) | [命令列參考](CLI-Reference.zh.md) |
| [Configuration](Configuration.md) | [設定檔](Configuration.zh.md) |

## Source

- Repository: [pardnchiu/Agenvoy](https://github.com/pardnchiu/Agenvoy)
- Architecture: [doc/architecture.md](https://github.com/pardnchiu/Agenvoy/blob/master/doc/architecture.md)
- Living spec: [CLAUDE.md](https://github.com/pardnchiu/Agenvoy/blob/master/CLAUDE.md)
