vasperamesh

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": "[e-mail]",
  "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