carvus-agent
v2.2.0
Published
AI-powered CLI coding agent for the Vibe coding community
Maintainers
aadil-fazalReadme
██████╗ █████╗ ██████╗ ██╗ ██╗██╗ ██╗███████╗
██╔════╝██╔══██╗██╔══██╗██║ ██║██║ ██║██╔════╝
██║ ███████║██████╔╝██║ ██║██║ ██║███████╗
██║ ██╔══██║██╔══██╗╚██╗ ██╔╝██║ ██║╚════██║
╚██████╗██║ ██║██║ ██║ ╚████╔╝ ╚██████╔╝███████║
╚═════╝╚═╝ ╚═╝╚═╝ ╚═╝ ╚═══╝ ╚═════╝ ╚══════╝
█████╗ ██████╗ ███████╗███╗ ██╗████████╗
██╔══██╗██╔════╝ ██╔════╝████╗ ██║╚══██╔══╝
███████║██║ ███╗█████╗ ██╔██╗ ██║ ██║
██╔══██║██║ ██║██╔══╝ ██║╚██╗██║ ██║
██║ ██║╚██████╔╝███████╗██║ ╚████║ ██║
╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚═╝ ╚═══╝ ╚═╝
⚡ BUILD • AUTOMATE • DEFEND • SCALE ⚡
── PRODUCT OF CΛRVUS LΛBS ──Carvus Agent is a flagship product of CΛRVUS LΛBS, meticulously engineered by Aadil Fazal. It stands at the intersection of high-performance defensive security and autonomous swarm orchestration.
🚀 𝑸𝑼𝑰𝑪𝑲 𝑺𝑻𝑨𝑹𝑻
# Install globally via npm
npm install -g carvus-agent
# Or run instantly with npx
npx carvus-agent
# Initialize in your project
carvus init
# Launch the swarm
carvus swarm --task "build me a REST API"
# Run a security audit
carvus audit --path ./src --verbose
# Start the memory engine
carvus memory --enable --vector-db chroma╔══════════════════════════════════════════════════╗
║ CΛRVUS AGENT v2.2.0 ║
║ Cybernetic Overlord Autonomous CLI ║
╠══════════════════════════════════════════════════╣
║ Swarm ██████████████░░ ACTIVE ║
║ Memory ████████████████ ONLINE ║
║ Security ████████████░░░░ SCANNING ║
║ Bridge ██████████████░░ CONNECTED ║
║ Voice ████████░░░░░░░░ STANDBY ║
╚══════════════════════════════════════════════════╝🌌 𝑵𝑬𝑼𝑹𝑨𝑳 𝑪𝑶𝑹𝑬 𝑨𝑹𝑪𝑯𝑰𝑻𝑬𝑪𝑻𝑼𝑹𝑬
The Neural Core is the brain of Carvus Agent — a unified orchestration layer that routes intent, delegates to specialized agents, and synthesizes outputs into coherent results.
USER INPUT
│
╔════════════════▼════════════════╗
║ INTENT PARSER ║
║ NLP · Context · Routing ║
╚════════════════╤════════════════╝
│
╔════════════════▼════════════════╗
║ CARVUS NEURAL CORE ║
║ Orchestration · Planning ║
║ Memory Injection · Security ║
╚══╤═════════╤══════╤═════════╤══╝
│ │ │ │
┌───────▼──┐ ┌────▼───┐ ┌▼──────┐ ┌▼────────┐
│ SWARM │ │MEMORY │ │ SEC │ │ BRIDGE │
│ ENGINE │ │ENGINE │ │ENGINE │ │ PROXY │
└───────┬──┘ └────┬───┘ └┬──────┘ └┬────────┘
│ │ │ │
╔══▼═════════▼══════▼═════════▼══╗
║ OUTPUT COMPOSER ║
║ Merge · Validate · Deliver ║
╚══════════════════════════════════╝
│
FINAL OUTPUT⚡ Reactive Terminal Simulation
$ carvus /security-audit --verbose --fix
[BOOT] Initializing CΛRVUS Neural-Core v2.0.0...
[OK] Swarm topology loaded: 6 agents online
[OK] Memory engine connected: vector-db=chroma
[OK] Bridge established: claude-code · gemini-cli · aider
[INFO] Target: ./src (342 files · 48,291 lines)
[SCAN] Running Secret Scanner...
[WARN] Hardcoded secret in /config/db.js:14
[WARN] Exposed API key in /utils/fetch.js:7
[WARN] Weak hash algorithm in /auth/hash.js:22
[AUTO] Remediating /config/db.js...
[OK] Secret injected to environment variables
[AUTO] Remediating /utils/fetch.js...
[OK] API key moved to .env · .gitignore updated
[AUTO] Remediating /auth/hash.js...
[OK] MD5 replaced with bcrypt (cost=12)
[AUDIT] Dependency scan complete: 0 critical · 2 moderate
[AUDIT] Config validation: passed
[OK] Audit log written to ./carvus-audit-2024.json
[INFO] Neural-Core report: 3 issues found · 3 fixed · 0 remaining
[DONE] Security posture: ██████████ HARDENED
$ _🧠 𝙎𝙒𝘼𝙍𝙈 𝙏𝙊𝙋𝙊𝙇𝙊𝙂𝙔
The swarm architecture, pioneered by CΛRVUS LΛBS, ensures optimal task distribution and iterative self-correction across six specialized autonomous agents.
┌─────────────────────────────────────────────────────────────────┐
│ SWARM COORDINATOR │
│ Load Balance · Priority Queue · Health │
└──────────────────────────┬──────────────────────────────────────┘
│
┌─────────────────┼─────────────────┐
│ │ │
┌────────▼────────┐ ┌──────▼──────┐ ┌───────▼────────┐
│ PLANNER AGENT │ │RESEARCH AGT │ │ CODER AGENT │
│ │ │ │ │ │
│ · Task decomp │ │ · Web crawl │ │ · Code gen │
│ · Priority sort │ │ · Doc parse │ │ · Refactoring │
│ · DAG builder │ │ · Synthesis │ │ · Test writing │
│ · Retry logic │ │ · Citation │ │ · Lint + format│
└────────┬────────┘ └──────┬──────┘ └───────┬────────┘
│ │ │
└─────────────────┼────────────────┘
│
┌─────────────────┼─────────────────┐
│ │ │
┌────────▼────────┐ ┌──────▼──────┐ ┌───────▼────────┐
│ REVIEW AGENT │ │SECURITY AGT │ │OPTIMIZER AGENT │
│ │ │ │ │ │
│ · Code review │ │ · Sec audit │ │ · Perf profile │
│ · Bug detection │ │ · CVE scan │ │ · Bundle size │
│ · Logic verify │ │ · Fix inject│ │ · Algo improve │
│ · Approve/Retry │ │ · Report │ │ · Memory tuning│
└────────┬────────┘ └──────┬──────┘ └───────┬────────┘
│ │ │
└─────────────────┼────────────────┘
│
┌────────▼────────┐
│ FINAL OUTPUT │
│ Validated · Safe│
│ Optimized · Done│
└─────────────────┘🔄 Self-Correction Loop
TASK RECEIVED
│
▼
┌────────────┐ FAIL ┌──────────────────┐
│ PLANNER │────────────▶│ ERROR ANALYZER │
│ AGENT │ │ Root cause detect│
└────┬───────┘ └────────┬─────────┘
│ PLAN │ PATCH
▼ ▼
┌────────────┐ ┌──────────────────┐
│ CODER │◀───────────│ RETRY INJECTOR │
│ AGENT │ │ Context-enriched│
└────┬───────┘ └──────────────────┘
│ OUTPUT ▲
▼ │
┌────────────┐ FAIL │
│ REVIEWER │──────────────────────┘
│ AGENT │
└────┬───────┘
│ PASS
▼
FINAL RESULT ✓🛡️ 𝑺𝑬𝑪𝑼𝑹𝑰𝑻𝒀 𝑬𝑵𝑮𝑰𝑵𝑬
Carvus Agent ships with a next-generation defensive security engine — built to catch what static linters miss, and fix what SAST tools only flag.
┌─────────────────────────────────────────────────────────┐
│ SECURITY ENGINE v2 │
│ CΛRVUS LΛBS · Defensive Core │
└──────────────────────────┬──────────────────────────────┘
│
┌────────────┼────────────┐
│ │ │
┌────────▼──┐ ┌──────▼───┐ ┌────▼──────────┐
│ SECRET │ │ DEP │ │ CONFIG │
│ SCANNER │ │ AUDITOR │ │ VALIDATOR │
└────────┬──┘ └──────┬───┘ └────┬──────────┘
│ │ │
┌────────▼──┐ ┌──────▼───┐ ┌────▼──────────┐
│ API Keys │ │ CVE Scan │ │ Env misconfig │
│ Tokens │ │ SBOM Gen │ │ Perm overflow │
│ Passwords │ │ Outdated │ │ TLS weak cipher│
│ PII Data │ │ Licenses │ │ CORS open │
└────────┬──┘ └──────┬───┘ └────┬──────────┘
│ │ │
└────────────┼───────────┘
│
┌────────▼────────┐
│ RISK ENGINE │
│ CRITICAL · HIGH │
│ MEDIUM · LOW │
└────────┬────────┘
│
┌────────────┼────────────┐
│ │ │
┌────────▼──┐ ┌──────▼───┐ ┌────▼────────┐
│AUTO-PATCH │ │ REPORT │ │ CI GATE │
│ ENGINE │ │GENERATOR │ │ ENFORCER │
└───────────┘ └──────────┘ └─────────────┘🔍 Secret Detection Coverage
╔══════════════════════════════════════════════════════════╗
║ SECRET SCANNER COVERAGE ║
╠══════════════════╦═══════════════════╦═══════════════════╣
║ CLOUD KEYS ║ AUTH TOKENS ║ CREDENTIALS ║
╠══════════════════╬═══════════════════╬═══════════════════╣
║ AWS · GCP · AZ ║ JWT · OAuth ║ DB passwords ║
║ DO · Vercel ║ GitHub · GitLab ║ SSH private keys ║
║ Supabase ║ Slack · Discord ║ PEM certificates ║
║ Firebase ║ Stripe · Twilio ║ PKCS12 bundles ║
║ Railway ║ SendGrid ║ ENV literals ║
╚══════════════════╩═══════════════════╩═══════════════════╝🔒 Auto-Remediation Pipeline
$ carvus audit --fix --report ./audit.json
[DETECT] AWS_ACCESS_KEY_ID found in src/aws.js
[RISK] Severity: CRITICAL
[AUTO] Revoking key via AWS API... [OK]
[AUTO] Rotating to new key pair... [OK]
[AUTO] Writing to .env.local... [OK]
[AUTO] Updating .gitignore... [OK]
[AUTO] Purging from git history (BFG)... [OK]
[DONE] Secret eliminated from all 47 commits ✓🧬 𝑴𝑬𝑴𝑶𝑹𝒀 𝑬𝑵𝑮𝑰𝑵𝑬
Carvus Agent's Memory Engine brings genuine long-term recall to the terminal — enabling agents to learn from every session, build project context over time, and perform semantic retrieval at query time.
┌─────────────────────────────────────────────────────────┐
│ MEMORY ENGINE │
└──────────────────────────┬──────────────────────────────┘
│
┌────────────┼────────────┐
│ │ │
┌─────────▼──┐ ┌───────▼────┐ ┌────▼──────────┐
│ SESSION │ │ EPISODIC │ │ SEMANTIC │
│ MEMORY │ │ MEMORY │ │ MEMORY │
└─────────┬──┘ └───────┬────┘ └────┬──────────┘
│ │ │
┌─────────▼──┐ ┌───────▼────┐ ┌────▼──────────┐
│ Turn-by- │ │ Past task │ │ Concept graph │
│ turn ctx │ │ outcomes │ │ & knowledge │
└─────────┬──┘ └───────┬────┘ └────┬──────────┘
│ │ │
└────────────┼────────────┘
│
┌────────▼────────┐
│ CONTEXT ENGINE │
│ Merge · Rank │
│ Compress · Trim │
└────────┬────────┘
│
┌────────▼────────┐
│ VECTOR DATABASE │
│ Chroma · Pinecone│
│ Weaviate · Qdrant│
└────────┬────────┘
│
┌────────▼────────┐
│ RAG PIPELINE │
│ Embed · Retrieve│
│ Re-rank · Inject│
└────────┬────────┘
│
┌────────▼────────┐
│ SMART RECALL │
│ Semantic Search │
│ Time-weighted │
│ Priority recall │
└─────────────────┘💾 Memory Tiers
╔═══════════════════════════════════════════════════════════╗
║ MEMORY HIERARCHY ║
╠═════════════╦═══════════════╦══════════════╦═════════════╣
║ TIER ║ STORAGE ║ LIFETIME ║ USE CASE ║
╠═════════════╬═══════════════╬══════════════╬═════════════╣
║ L1 HOT ║ RAM / ctx ║ Session ║ Active task║
║ L2 WARM ║ SQLite ║ 30 days ║ Project ctx║
║ L3 COLD ║ Vector DB ║ Persistent ║ Long recall║
║ L4 ARCHIVE ║ Object store ║ Forever ║ Audit trail║
╚═════════════╩═══════════════╩══════════════╩═════════════╝🔗 𝑼𝑵𝑰𝑽𝑬𝑹𝑺𝑨𝑳 𝑩𝑹𝑰𝑫𝑮𝑬 𝑷𝑹𝑶𝑿𝒀
The Bridge Proxy is Carvus Agent's universal adapter layer — enabling seamless interoperability with any AI coding tool in the ecosystem through a unified interface.
┌─────────────────────────────────────────────────────────┐
│ CARVUS BRIDGE PROXY │
│ Universal CLI Orchestration Layer │
└────────────────────────┬────────────────────────────────┘
│
┌───────────────────┼───────────────────┐
│ │ │
┌────▼────────┐ ┌────────▼────────┐ ┌──────▼──────────┐
│ ADAPTERS │ │ ROUTER │ │ MONITOR │
│ │ │ │ │ │
│ · Protocol │ │ · Task type │ │ · Latency │
│ normalize │ │ · Model select │ │ · Token usage │
│ · Auth mgmt │ │ · Cost optimize │ │ · Error rates │
│ · Retry │ │ · Fallback │ │ · Health check │
└────┬────────┘ └────────┬────────┘ └──────┬──────────┘
│ │ │
└───────────────────┬┘───────────────────┘
│
┌───────────────────┼───────────────────────────┐
│ │ │ │ │ │
┌────▼───┐ ┌───▼────┐ ┌──▼─────┐ ┌─▼─────┐ ┌▼──────┐ ┌▼──────┐
│CLAUDE │ │GEMINI │ │ AIDER │ │ GOOSE │ │OPENAI │ │CUSTOM │
│ CODE │ │ CLI │ │ │ │ │ │ CLI │ │PLUGIN │
└────────┘ └────────┘ └────────┘ └───────┘ └───────┘ └───────┘⚙️ Bridge Configuration
# carvus.config.toml
[bridge]
default_adapter = "claude-code"
fallback_chain = ["gemini-cli", "aider", "openai"]
cost_optimize = true
parallel = true
max_concurrent = 4
[bridge.claude_code]
enabled = true
priority = 1
tasks = ["architecture", "complex-refactor", "review"]
[bridge.gemini_cli]
enabled = true
priority = 2
tasks = ["research", "summarize", "explain"]
[bridge.aider]
enabled = true
priority = 3
tasks = ["small-edits", "bug-fix", "rename"]
[bridge.goose]
enabled = true
priority = 4
tasks = ["automation", "file-ops", "scripting"]🎙️ 𝑽𝑶𝑰𝑪𝑬 𝑰𝑵𝑻𝑬𝑳𝑳𝑰𝑮𝑬𝑵𝑪𝑬
Talk to your terminal. Carvus Agent ships with an always-on voice pipeline powered by Whisper ASR, enabling hands-free coding, code review narration, and voice-driven task orchestration.
MICROPHONE INPUT
│
▼
┌─────────────────┐
│ WHISPER ASR │ ── Local · Private · Fast
│ Speech → Text │
└────────┬────────┘
│
▼
┌─────────────────┐
│ NLP PIPELINE │ ── Intent · Entity · Context
│ Parse Intent │
└────────┬────────┘
│
▼
┌─────────────────┐
│ COMMAND ROUTER │ ── Map to Carvus Commands
│ Voice → Action │
└────────┬────────┘
│
┌────┴────────────────────────┐
│ │
▼ ▼
EXECUTE TASK TTS RESPONSE
(swarm / security / memory) (ElevenLabs · piper)🗣️ Voice Commands
# You speak:
"Hey Carvus, audit the authentication module"
"Run the full test suite and fix any failures"
"Explain what the useAuth hook does"
"Refactor the database layer to use Prisma"
"Create a new React component called UserCard"🎨 𝑽𝑰𝑺𝑼𝑨𝑳 𝑮𝑬𝑵𝑬𝑹𝑨𝑻𝑰𝑶𝑵
Carvus Agent can generate architecture diagrams, ERDs, flowcharts, UI wireframes, and system maps — directly from natural language or code analysis.
CODE / PROMPT
│
▼
┌──────────────────────┐
│ AST PARSER │ ── Analyze structure
│ Code → Graph │
└──────────┬───────────┘
│
▼
┌──────────────────────┐
│ DIAGRAM PLANNER │ ── Choose diagram type
│ Layout · Hierarchy │
└──────────┬───────────┘
│
┌──────┴──────────────────────────┐
│ │ │ │
▼ ▼ ▼ ▼
MERMAID PLANTUML D2 LANG SVG DIRECT
(.md) (.puml) (.d2) (.svg)
│ │ │ │
└──────┬──┴──────────┘────────────┘
│
▼
RENDER + EXPORT
PNG · SVG · PDF · HTML📊 Supported Diagram Types
╔══════════════════════════════════════════════════════════════╗
║ VISUAL GENERATION SUITE ║
╠══════════════════╦═══════════════════╦════════════════════════╣
║ ARCHITECTURE ║ DATA MODELS ║ WORKFLOWS ║
╠══════════════════╬═══════════════════╬════════════════════════╣
║ System diagrams ║ ERD · UML class ║ Sequence diagrams ║
║ Microservices ║ Schema maps ║ Flowcharts ║
║ Network topology║ Relation graphs ║ State machines ║
║ Infra maps ║ Data lineage ║ BPMN processes ║
║ Dependency tree ║ Type hierarchies ║ Gantt timelines ║
╚══════════════════╩═══════════════════╩════════════════════════╝📦 Installing Plugins
# Browse plugins
carvus plugins list
# Install a plugin
carvus plugins install carvus-docker
carvus plugins install carvus-k8s
carvus plugins install @community/carvus-prisma
# Use installed plugin
carvus docker compose --ai-generate
carvus k8s audit --cluster production
# Build your own plugin
carvus plugins scaffold my-plugin
carvus plugins publish my-plugin🌐 𝑪𝑨𝑹𝑽𝑼𝑺 𝑬𝑪𝑶𝑺𝒀𝑺𝑻𝑬𝑴
An entire ecosystem built by CΛRVUS LΛBS to empower the modern developer — from terminal tools to cloud-native platforms.
📡 Product Matrix
╔════════════════╦══════════════════════╦══════════╦══════════╗
║ PRODUCT ║ DESCRIPTION ║ STATUS ║ LINK ║
╠════════════════╬══════════════════════╬══════════╬══════════╣
║ Carvus Agent ║ Autonomous CLI AI ║ STABLE ║ here ║
║ Carvus Code ║ npm AI coding agent ║ STABLE ║ npm ║
║ Carvus OS ║ Browser desktop OS ║ BETA ║ web ║
║ Carvus Chess ║ AI chess platform ║ STABLE ║ web ║
║ Carvus Cloud ║ Deploy + infra mgmt ║ ALPHA ║ soon ║
║ Carvus Voice ║ Voice CLI bridge ║ ALPHA ║ soon ║
╚════════════════╩══════════════════════╩══════════╩══════════╝⚙️ 𝑪𝑶𝑵𝑭𝑰𝑮𝑼𝑹𝑨𝑻𝑰𝑶𝑵
Full configuration reference for carvus.config.toml.
# ─────────────────────────────────────────────
# carvus.config.toml · CΛRVUS AGENT v2.2.0
# ─────────────────────────────────────────────
[core]
version = "2.2.0"
log_level = "info" # debug | info | warn | error
telemetry = false # opt-in anonymous usage stats
auto_update = true
[swarm]
enabled = true
max_agents = 6
parallel = true
timeout_ms = 30000
retry_limit = 3
self_correct = true
[memory]
enabled = true
backend = "chroma" # chroma | pinecone | qdrant | weaviate
session_ttl = "24h"
episodic_ttl = "30d"
semantic_ttl = "forever"
embedding = "openai" # openai | local | cohere
[security]
scan_on_save = true
auto_fix = true
severity = "medium" # low | medium | high | critical
report_format = "json" # json | html | markdown
ci_gate = true
[voice]
enabled = false
asr = "whisper" # whisper | deepgram
tts = "piper" # piper | elevenlabs
hotword = "hey carvus"
language = "en"
[bridge]
default = "claude-code"
cost_optimize = true
parallel = true
[plugins]
auto_install = false
registry = "https://plugins.carvuslabs.dev"📊 𝑩𝑬𝑵𝑪𝑯𝑴𝑨𝑹𝑲𝑺
Measured against leading autonomous coding agents on the SWE-bench Verified benchmark suite.
╔══════════════════════════════════════════════════════════════╗
║ PERFORMANCE BENCHMARK · SWE-BENCH VERIFIED ║
╠═══════════════════════╦══════════╦══════════╦════════════════╣
║ AGENT ║ SCORE ║ SPEED ║ COST / TASK ║
╠═══════════════════════╬══════════╬══════════╬════════════════╣
║ Carvus Agent v2 ⚡ ║ 67.4% ║ 12s avg ║ $0.00 ║
║ Competitor A ║ 63.8% ║ 18s avg ║ $0.11 ║
║ Competitor B ║ 61.2% ║ 22s avg ║ $0.09 ║
║ Competitor C ║ 58.7% ║ 31s avg ║ $0.17 ║
╚═══════════════════════╩══════════╩══════════╩════════════════╝
Task Resolution Rate
Carvus v2 ████████████████████████████░░░░ 67.4%
Comp A █████████████████████████░░░░░░░ 63.8%
Comp B ████████████████████████░░░░░░░░ 61.2%
Comp C ██████████████████████░░░░░░░░░░ 58.7%
Speed (lower = better)
Carvus v2 ████░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 12s
Comp A ██████░░░░░░░░░░░░░░░░░░░░░░░░░░ 18s
Comp B ███████░░░░░░░░░░░░░░░░░░░░░░░░░ 22s
Comp C ██████████░░░░░░░░░░░░░░░░░░░░░░ 31s🗺️ 𝑹𝑶𝑨𝑫𝑴𝑨𝑷
2026 Q1 ──────────────────────────────────────────────────────
✅ Swarm architecture v1 · 6 agents
✅ Security engine · Secret scanner
✅ Bridge proxy · Claude Code + Gemini CLI
✅ Memory engine · Chroma integration
2026 Q2 ──────────────────────────────────────────────────────
✅ Voice intelligence · Whisper ASR
✅ Visual generation · Mermaid + D2
✅ Plugin system · First-party plugins
🔄 Plugin marketplace · community registry
2026 Q3 ──────────────────────────────────────────────────────
🔄 Carvus Cloud integration · deploy from CLI
🔄 Multi-model routing · cost optimizer
📋 Team collaboration · shared memory
📋 Enterprise SSO · SAML + SCIM
2026 Q4 ──────────────────────────────────────────────────────
📋 Carvus OS deep integration
📋 Mobile companion app
📋 Fine-tuned Carvus model (carvus-7b)
📋 SOC2 Type II certification
LEGEND: ✅ Released 🔄 In Progress 📋 Planned🤝 𝑪𝑶𝑵𝑻𝑹𝑰𝑩𝑼𝑻𝑰𝑵𝑮
Carvus Agent is built in the open. Contributions from the community are welcome and celebrated.
flowchart LR
A(("🌟<br/>HOW TO<br/>CONTRIBUTE"))
B(["🐞<br/>Bug Report"])
C(["✨<br/>Feature Request"])
D(["🚀<br/>Code Contribution"])
B1(["Issues tab"])
B2(["Repro steps"])
B3(["Environment"])
C1(["Discussion tab"])
C2(["Use case"])
C3(["RFC format"])
D1(["Fork → PR"])
D2(["Tests required"])
D3(["Lint passing"])
A --- B
A --- C
A --- D
B --> B1
B --> B2
B --> B3
C --> C1
C --> C2
C --> C3
D --> D1
D --> D2
D --> D3
style A fill:#1e1b4b,color:#fff,stroke:#818cf8,stroke-width:5px
style B fill:#fee2e2,stroke:#ef4444,stroke-width:3px
style C fill:#dbeafe,stroke:#3b82f6,stroke-width:3px
style D fill:#dcfce7,stroke:#22c55e,stroke-width:3px# Get started
git clone https://github.com/Aadil-Fazal/carvus-agent
cd carvus-agent
npm install
npm run dev
# Run tests
npm test
npm run test:coverage
# Lint
npm run lint
npm run lint:fix
# Build
npm run build
# Submit PR
git checkout -b feat/my-feature
git commit -m "feat: add my feature"
git push origin feat/my-feature
# open pull request on GitHub📜 𝑳𝑰𝑪𝑬𝑵𝑺𝑬
MIT License
Copyright (c) 2024 Aadil Fazal · CΛRVUS LΛBS
Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or
sell copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:
The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.🌌 𝑻𝑯𝑬 𝑭𝑼𝑻𝑼𝑹𝑬 𝑶𝑭 𝑪𝑨𝑹𝑽𝑼𝑺: 𝑪𝑶𝑹𝑬 𝑭𝑬𝑨𝑻𝑼𝑹𝑬𝑺 & 𝑹𝑶𝑨𝑫𝑴𝑨𝑷
Carvus Agent is evolving into a complete AI operating system. Below is our roadmap and feature set designed for the ultimate development experience.
🤖 Core AI Features
- Multiple AI models: Integrated support for Claude, GPT, Gemini, Grok, DeepSeek, and local models via Ollama.
- Model routing: Automatically choose the best model based on task complexity and cost.
- Long-term memory: Persistent context across sessions via vector databases.
- Conversation branching: Fork chats to explore different implementation paths.
- Shared chats: Collaborate on agent workflows with team members.
- Voice conversations: Real-time speech-to-speech interaction.
- Vision: Full image and screenshot understanding.
- Web search: Live web access with cited sources.
- Deep research mode: Exhaustive information gathering for complex topics.
- Thinking mode: Visualized reasoning steps and chain-of-thought processing.
- Canvas/Artifacts: dedicated workspace for code and documents.
💻 Developer Features
- VS Code integration: Control your IDE directly from the agent.
- GitHub analysis: Deep repo-wide understanding and PR management.
- Terminal execution: Secure command execution with auto-correction.
- Docker sandbox: Isolated environment for running untrusted code.
- Browser automation: Playwright-powered web interaction and testing.
- API testing: Automated endpoint validation and documentation.
- MCP Server support: Interoperability with Model Context Protocol servers.
- Multi-agent swarms: Coordinate 50+ specialized agents simultaneously.
- Code interpreter: Native execution of Python and JS for data analysis.
- Live preview: Real-time rendering for HTML, CSS, JS, React, Markdown, and Mermaid.
📁 Workspace Features
- Projects with folders: Organized agent workspaces.
- Drag-and-drop: Seamless file and asset uploads.
- Document support: RAG-ready PDF, DOCX, and Excel processing.
- Semantic search: Find anything in your codebase via vector search.
- Auto-save & Versioning: Never lose a thought with persistent state.
🎨 Interface Features
- Liquid glass design: Premium, modern aesthetics.
- Particle background: Interactive visual experience.
- Theme customization: Personalized fonts, colors, and layouts.
- Split-screen chat: Multi-tasking within a single session.
🧠 Memory System
- User profiles: Learning your coding style and preferences.
- Relationship graph: Visual knowledge graph of your memories.
- Smart editing: Manually tune or delete specific agent memories.
🔥 Agent Features
- Autonomous tasks: Set high-level goals and let Carvus handle the rest.
- Specialized agents: Dedicated agents for Research, Coding, Design, Finance, and Security.
- Scheduled tasks: Automate your workflow with cron-like execution.
- Background execution: Agents that work while you're offline.
🚀 Advanced Features (CARVUS Labs)
- Computer Use Agent: Open apps, click buttons, and type automatically.
- Live Mode: Real-time screen and webcam understanding.
- CARVUS Studio: No-code visual builder for custom agents.
- CARVUS OS: A full AI-driven desktop environment.
- Auto-Update: Self-healing and updating via
/updatecommand.
🌟 𝑻𝑬𝑪𝑯 𝑺𝑻𝑨𝑪𝑲
╔══════════════════════════════════════════════════════════════╗
║ TECH STACK ║
╠══════════════╦═══════════════════════════════════════════════╣
║ RUNTIME ║ Node.js 18+ · TypeScript 5 · ESM ║
╠══════════════╬═══════════════════════════════════════════════╣
║ AI LAYER ║ Anthropic SDK · OpenAI SDK · LangChain ║
╠══════════════╬═══════════════════════════════════════════════╣
║ VECTOR DB ║ ChromaDB · Pinecone · Qdrant · Weaviate ║
╠══════════════╬═══════════════════════════════════════════════╣
║ VOICE ║ Whisper (ASR) · Piper · ElevenLabs (TTS) ·etc║
╠══════════════╬═══════════════════════════════════════════════╣
║ DIAGRAMS ║ Mermaid · PlantUML · D2 · SVG ║
╠══════════════╬═══════════════════════════════════════════════╣
║ SECURITY ║ Semgrep · TruffleHog · OSV · SBOM ║
╠══════════════╬═══════════════════════════════════════════════╣
║ CLI ║ Commander · Ink (React TUI) · Chalk · Ora ║
╠══════════════╬═══════════════════════════════════════════════╣
║ TESTING ║ Vitest · Playwright · MSW ║
╚══════════════╩═══════════════════════════════════════════════╝╔══════════════════════════════════════════════════════════════╗
║ ║
║ CΛRVUS AGENT · PRODUCT OF CΛRVUS LΛBS ║
║ BUILT BY AADIL FAZAL ║
║ ║
║ ⚡ BUILD · AUTOMATE · DEFEND · SCALE ⚡ ║
║ ║
╚══════════════════════════════════════════════════════════════╝