๐Ÿค– Auto Agent

Mode: auto ยท Category: General-purpose

The auto agent is the default. It has no specific persona โ€” it routes your question to the most appropriate tool based on the input. Good for one-off queries when you don't want to pick a specialist.

Quick run

From the repo root, after pnpm -r build:

node apps/cli/dist/index.js -q "What's the price of BTC?"

Or be explicit:

node apps/cli/dist/index.js -a auto -q "What's the price of BTC?"

Requirements

LLM provider

Any one of these. Recommended:

  • Anthropic Claude โ€” best quality, paid
  • Groq โ€” fast and has a free tier
  • Gemini โ€” Google, free tier available
  • Ollama โ€” fully local, free, slower

Set one in ~/.openvesper/.env:

ANTHROPIC_API_KEY=sk-ant-...
# or
GROQ_API_KEY=gsk_...
# or
GEMINI_API_KEY=AIza...
# or fully local
OLLAMA_HOST=http://localhost:11434

Plugins used

All 47 plugins are loaded. The agent picks tools as needed from the global registry. No per-agent restrictions.

When to use auto vs. a specialist

Use auto when...Use a specialist when...
You have a one-off, mixed questionYou're focused on one domain (crypto, code, fitness)
You don't know which agent fitsYou want a specific tone or persona
The question is generalYou're scheduling repeated tasks for one purpose

Example sessions

node apps/cli/dist/index.js -q "Price of SOL right now"
node apps/cli/dist/index.js -q "Trending coins on Pump.fun today"
node apps/cli/dist/index.js -q "Send a Telegram message: deployment finished"
node apps/cli/dist/index.js -q "What's the weather in Istanbul tomorrow?"

Switching LLM providers

You can override the provider per query:

node apps/cli/dist/index.js -a auto -p groq -q "summarize my morning"
node apps/cli/dist/index.js -a auto -p anthropic --model claude-opus-4-5 -q "harder question"

What's next?