zeus-agent

Configure, extend, theme, and orchestrate ZeusAgent instances across CLI, desktop, and messaging surfaces.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill zeus-agent-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: zeus-agent
Source: https://github.com/loteiron/ZeusAgent/tree/main/skills/autonomous-ai-agents/zeus-agent
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill zeus-agent-loteiron

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? ZeusAgent is a large, multi-surface AI agent framework, and answering questions about its CLI commands, configuration, providers, plugins, themes, and multi-agent orchestration from memory leads to stale or wrong answers. This Skill acts as a routing hub that directs the agent to the correct reference file or live documentation before answering. ## Core Features & Use Cases - Guided configuration and setup: Covers installation, provider and model selection, credential pools, profiles, config.yaml sections, and toolsets with exact CLI commands. - Extension authoring: Provides references and templates for desktop UI plugins, TUI widgets, custom skins/themes, and pet mascots, including pitfalls like hot-reload behavior and theme variable rules. - Multi-agent orchestration: Documents spawning independent ZeusAgent processes via one-shot mode, tmux PTY sessions, worktree isolation, and when to prefer delegate_task, cron, or kanban instead. - Use Case: A user asks why their delegate_task batch ran fewer subagents than configured. The Skill routes to the concurrency diagnosis reference, which walks through checking the config value, grepping agent logs for the two real cap paths, and identifying model self-limiting behavior. ## Quick Start Ask the agent to help you install ZeusAgent, configure a model provider, or answer a specific question about a ZeusAgent feature, and it will load the matching reference file or the live docs index before responding.

Frequently Asked Questions about zeus-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install and set up ZeusAgent?▼

Run the shell installer with curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash, which sets up uv, Python, the venv, and the launcher. Then use zeus setup for the wizard, zeus model to pick a provider, and zeus doctor for a health check.

How do I spawn multiple ZeusAgent instances for parallel work?▼

Use zeus chat -q for one-shot background tasks, or tmux new-session with zeus for interactive PTY sessions since prompt_toolkit needs a real terminal. Add -w for worktree mode to prevent git conflicts, and prefer delegate_task for quick subtasks.

What LLM providers does ZeusAgent support?▼

ZeusAgent supports 35+ providers including OpenRouter, Anthropic, OpenAI, Google, DeepSeek, xAI, and local models via custom base_url endpoints. Credentials are managed with zeus auth, and multiple keys per provider form an automatically rotating pool.

Why did delegate_task run fewer subagents than I configured?▼

Only three code paths cap batches: a per-call hard reject, a per-turn truncator, both governed by delegation.max_concurrent_children. If neither log line appears in agent.log, the model itself trimmed the batch, which is a known reasoning-model behavior.

Can I add custom UI elements to the ZeusAgent desktop app?▼

Yes, write a plain JavaScript ESM plugin in ~/.zeus/desktop-plugins/<id>/plugin.js using the @zeus/plugin-sdk imports. The app hot-reloads the file on save, and plugins can add panes, statusbar chips, palette commands, routes, and themes.

How do I connect ZeusAgent to Telegram or Discord?▼

Use the gateway with zeus gateway run or zeus gateway setup, which supports 20+ platforms including Telegram, Discord, Slack, WhatsApp, Signal, and Matrix. Adapters ship under plugins/platforms/ and give the agent full tool access, not just chat.