🗣 Language Tutor

Mode: language-tutor · Category: Lifestyle

Vocabulary practice, grammar explanation, conversation practice

Quick run

From the repo root, after pnpm -r build:

node apps/cli/dist/index.js -a language-tutor -q "your question here"

Requirements

LLM provider

Recommended: anthropic, gpt-4-turbo (best for nuance)

Set the corresponding API key in ~/.openvesper/.env:

  • ANTHROPIC_API_KEY

Plugins used

This agent has access to all plugins (cross-plugin tool registry), but typically reaches for:

translate

Skills it can pull in

language-conversation-drill

Example sessions

node apps/cli/dist/index.js -a language-tutor -q "Teach me a new German phrase today"
node apps/cli/dist/index.js -a language-tutor -q "What's the difference between 'ser' and 'estar' in Spanish?"

Scheduled mode (optional)

This agent ships with a heartbeat checklist in.agents/language-tutor/HEARTBEAT.md. The default schedule is0 8 * * * but the heartbeat is disabled by default.

To enable scheduled execution:

# Edit .agents/language-tutor/HEARTBEAT.md
# Change "enabled: false" to "enabled: true"

# Then add it to your cron job state
node apps/cli/dist/index.js cron add hb-language-tutor   --schedule "0 8 * * *"   --agent language-tutor   --prompt "Run your heartbeat checklist for {{date}}"   --deliver-to "telegram:@me"

Files

The agent's source files live under .agents/language-tutor/:

  • SOUL.md — persona and principles
  • IDENTITY.md — metadata (name, icon, model preferences)
  • USER.md — what the agent knows about you
  • TOOLS.md — tool policy
  • HEARTBEAT.md — scheduled checklist (opt-in)
  • MEMORY.md — long-term memory store

You can edit any of these files to customize the agent. Changes take effect on the next run — no rebuild needed.

Privacy

This agent runs entirely on your machine. Your prompts go only to your configured LLM provider. Nothing is sent to OpenVesper servers (we don't have any). SeeSecurity policy for details.

What's next?