Veda

Local-first autonomous AI agent. Runs on your machine — single-user, persistent, context-aware. Plans before acting; uses tools (code, files, GitHub, search, memory) and can talk over CLI and Telegram with shared context so a message on Telegram continues the same conversation you had in the terminal.

Quick start

git clone <repo>
cd veda
npm install
npm run onboard   # add API key + optional Telegram bot token (saved in identity/config.json)
npm start         # starts daemon: CLI + Telegram bot

• CLI: Type in the terminal and get replies. Tool runs (e.g. write file, push to GitHub) require confirmation (y/n) unless in autonomous mode.
• Telegram: Message the bot; it uses the same session and sees recent turns from both CLI and Telegram so short replies like “give more ideas” work with full context.

Configuration

• Root: All data lives under ~/.veda by default. Override with VEDA_HOME (e.g. VEDA_HOME=. for project dir).
• Identity: identity/config.json holds API keys and Telegram token (from onboarding). Soul/persona and workspace paths are under the same root; see config/paths.ts.
• AI: Set provider/model via config (e.g. Anthropic, OpenAI, Google). Default is anthropic:claude-sonnet-4-5.

Features

• Planning: Multi-step tool loop with approval; uses a skill catalog and can delegate coding to Cursor CLI.
• Tools: cursor_agent, write_file_home, create_folder, github_push, github_api, web_search, recall, read_session, write_note, exec, and others; see tools/.
• Skills: Loaded from workspace and .veda; agent sees a catalog and can read_skill (e.g. frontend) and pass skills into cursor_agent for multi-file work.
• Memory: Long-term recall, session history, and cross-channel recent context (CLI + primary Telegram chat merged by time).
• Goals & autonomy: Goals, research, and insights can be proposed and sent to you on Telegram; scheduler and cron drive background behavior.

Project structure

• core/ — daemon, agent loop, planner, session, router, gateway, memory, goals, reflection.
• tools/ — tool implementations and registry.
• interfaces/ — CLI and Telegram.
• config/ — paths, env, AI models, config load/save.
• identity/ — soul loader, profile, onboarding.
• utils/ — e.g. skill loader.

Development

npm run dev    # same as start, runs from source
npm run build  # tsc

Soul/persona is defined in identity/SOUL.md (or workspace copy). Tools and skills are wired in tools/registry.ts and core/planner.ts.