VasperaMesh CLI

Turn solo AI agents into collaborative swarms.

VasperaMesh is a multi-agent orchestration platform that coordinates AI agents across your codebase. Run security scans, code reviews, and automated analysis with 37+ production-ready agents.

Installation

npm install -g vasperamesh

Quick Start

1. Create an Account

vasperamesh install

This opens your browser to create a free account at vasperamesh.com.

2. Connect Your Account

vasperamesh connect

You'll be prompted to either:

• Paste your API key (get one from vasperamesh.com/api-keys)
• Browser authentication (opens sign-in page)

3. Initialize Your Project

cd your-project
vasperamesh init

4. Run Your First Scan

# Scan current directory with all bundled agents
vasperamesh scan

# Scan with specific agents
vasperamesh scan --agents security-scanner,code-reviewer

# Scan specific files
vasperamesh scan src/auth.ts

Commands

| Command | Description | |---------|-------------| | vasperamesh install | First-time setup - create account | | vasperamesh connect | Connect existing account | | vasperamesh init | Initialize mesh in current project | | vasperamesh scan [path] | Scan code with AI agents | | vasperamesh watch | Stream real-time events from mesh | | vasperamesh debates | View agent debates and discussions | | vasperamesh create | Create a new custom agent | | vasperamesh publish | Publish agent to marketplace |

Local-First Scanning

Run scans locally without sending code to the cloud:

# Uses local LLM providers (Ollama, etc.)
vasperamesh scan --local

# Specify provider
vasperamesh scan --provider ollama --model llama3.2

Bundled Agents

VasperaMesh includes 37+ production-ready agents:

| Agent | Description | |-------|-------------| | security-scanner | OWASP Top 10, SQL injection, XSS detection | | code-reviewer | Code quality, complexity, maintainability | | todo-scanner | Find and track TODO/FIXME comments | | dependency-checker | Outdated packages, vulnerabilities | | type-checker | TypeScript/type annotation issues | | performance-analyzer | Memory leaks, N+1 queries, bottlenecks | | accessibility-checker | WCAG compliance, a11y issues | | api-reviewer | REST/GraphQL best practices |

View all agents →

Real-Time Streaming

Watch agent activity in real-time:

vasperamesh watch

# Filter by severity
vasperamesh watch --severity critical,high

# Filter by agent
vasperamesh watch --agent security-scanner

Configuration

Configuration is stored in ~/.vasperamesh/config.json:

{
  "apiKey": "vm_...",
  "userId": "uuid",
  "email": "[email protected]",
  "defaultMeshId": "uuid"
}

Project-level configuration in .vasperamesh.json:

{
  "meshId": "your-mesh-id",
  "agents": ["security-scanner", "code-reviewer"],
  "exclude": ["node_modules", "dist", ".git"]
}

Environment Variables

| Variable | Description | |----------|-------------| | VASPERAMESH_API_URL | API endpoint (default: https://www.vasperamesh.com) | | VASPERAMESH_API_KEY | API key (alternative to config file) |

VS Code Extension

For IDE integration, install the VasperaMesh VS Code Extension:

• Inline annotations for findings
• Real-time agent status
• One-click fixes

Data & Privacy

What We Collect

When you use VasperaMesh, we collect:

• Account information: Email address, name (required for authentication)
• Usage data: Commands run, agents used, scan statistics
• Mesh metadata: Project names, agent configurations
• Findings: Issues detected by agents (for dashboard display)

What We Don't Collect

• Your source code is never stored on our servers (local-first scanning)
• API keys for third-party services
• Environment variables or secrets

Data Retention

• Account data is retained while your account is active
• Usage analytics are aggregated and anonymized after 90 days
• You can delete your account and all data at any time

See our Privacy Policy for full details.

Requirements

• Node.js 18+
• npm or pnpm

Support

• Documentation: docs.vasperamesh.com
• GitHub Issues: github.com/RCOLKITT/VasperaMesh/issues
• Discord: discord.gg/vasperamesh

License

MIT License - see LICENSE for details.

Built by Vaspera Capital