📊 Data Analyst

Mode: data-analyst · Category: Productivity

Data exploration, SQL queries, chart generation, data quality checks

Quick run

From the repo root, after pnpm -r build:

node apps/cli/dist/index.js -a data-analyst -q "your question here"

Requirements

LLM provider

Recommended: anthropic claude-opus, gpt-4-turbo (good with SQL)

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

  • ANTHROPIC_API_KEY
  • DATABASE_URL (optional)

Plugins used

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

database, filesystem, code

Skills it can pull in

sql-from-natural-language

Example sessions

node apps/cli/dist/index.js -a data-analyst -q "Analyze this CSV: data/sales.csv. What stands out?"
node apps/cli/dist/index.js -a data-analyst -q "Write a SQL query for top customers by revenue"

Scheduled mode (optional)

This agent ships with a heartbeat checklist in.agents/data-analyst/HEARTBEAT.md. The default schedule is0 9 * * MON but the heartbeat is disabled by default.

To enable scheduled execution:

# Edit .agents/data-analyst/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-data-analyst   --schedule "0 9 * * MON"   --agent data-analyst   --prompt "Run your heartbeat checklist for {{date}}"   --deliver-to "telegram:@me"

Files

The agent's source files live under .agents/data-analyst/:

  • 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?