快速開始

前置需求

• Go 1.25.1 或更高版本
• Linux（透過 bubblewrap 沙箱；若缺少 bwrap 會自動經 apt/dnf/yum/pacman/apk 安裝）或 macOS（sandbox-exec）
• 至少一個 LLM provider 帳號（Copilot 訂閱，或 OpenAI / Claude / Gemini / Nvidia 的 API key）
• 選用：pdftotext（poppler-utils）供 read_file 解析 PDF
• 選用：OPENAI_API_KEY 以啟用語意搜尋（text-embedding-3-small）

安裝

git clone https://github.com/pardnchiu/Agenvoy.git
cd agenvoy
make build

make build 會編譯、將最新 git tag 嵌入為 projectVersion，並將 binary 安裝至 /usr/local/bin/agen。

至少配置一個 provider

Agenvoy 需要至少一個 LLM provider 才能運作：

agen model add

互動式提示會逐步帶你完成 provider 選擇、model 選擇與憑證儲存。Token 會落在 OS keychain（macOS 用 security、Linux 用 secret-tool，其餘則 fallback 至加密檔案），服務名稱固定為 agenvoy。

主要 config 位於 ~/.config/agenvoy/config.json。

首次執行

# Create a named cli- session and switch the primary pointer to it
agen session new my-assistant

# Launch the full stack (TUI + Discord + Telegram + REST)
make app

TUI 啟動後，按 i 開啟 Message 輸入並以 Enter 送出（在會轉發 modifier 的終端機上，Shift+Enter 可插入換行）。按 c 開啟 Command（$）輸入。Tab 於主畫面中切換 Content 與 Logs；Ctrl+P 開啟 co-work dashboard（Sessions / Log / Pending 三面板）。

一次性 CLI 用法：

make cli "summarize the latest changes in main.go"
make run "use playwright to open example.com and screenshot"

make cli 會確認每個非唯讀工具呼叫；make run 則自動核准一切。

後續步驟

• Core Concepts — session、agent routing、iteration 迴圈與三階段工具派送
• Providers — 支援的 LLM 後端與 dispatcher model
• MCP Integration — 接入外部工具 server
• CLI Reference — 完整命令清單

[!NOTE] 本文件由 Claude 讀取完整原始碼後自動生成。