superdev

All-in-one AI-powered developer super tool. Self-evolving, infinite memory, zero dependencies.

Features

| Module | What it does | |--------|-------------| | Code Review | AI slop detection, bugs, security, performance, dead code (19 detectors) | | Infinite Memory | Hierarchical persistent memory with TF-IDF search, auto-compression, tier management | | Codebase Mapper | Auto-generates architecture map, dependency graph, entry points, hotspots | | Onboarding Guide | Instant markdown guide for any codebase — for new team members | | Self-Evolution | Learns skills from interactions, evolves over time (hermes-agent inspired) | | Test Health | Finds broken imports, stale mocks, missing tests, estimates coverage | | Cost Monitor | Tracks AI API costs, budget alerts, spike detection, monthly projections | | Config Validator | Finds exposed secrets, missing env vars, insecure defaults | | MCP Server | 9 tools for Claude Code / AI agent integration |

Install

npm install superdev

CLI

# Review code for bugs, security, AI slop
superdev review src/app.ts

# Review git diff
git diff | superdev review-diff

# Map codebase architecture
superdev map .

# Generate onboarding guide
superdev onboard .

# Check test health
superdev test-health .

# Validate config/env files
superdev config .

# AI cost report
superdev cost

# Search memory
superdev memory search "authentication flow"

# List learned skills
superdev skills

# Full project status
superdev status

MCP Server (Claude Code)

{
  "mcpServers": {
    "superdev": {
      "command": "npx",
      "args": ["superdev-mcp"]
    }
  }
}

MCP Tools

| Tool | Description | |------|-------------| | superdev_review | Review a file for quality issues | | superdev_map | Map codebase architecture | | superdev_onboard | Generate onboarding guide | | superdev_test_health | Check test suite health | | superdev_config | Validate config files | | superdev_memory_search | Search persistent memory | | superdev_memory_save | Save to persistent memory | | superdev_skills | List learned skills | | superdev_learn | Teach a new skill |

Library API

import { reviewCode, mapCodebase, createMemoryStore, createSkillManager } from "superdev";

// Review code
const result = reviewCode(sourceCode, "app.ts");
console.log(result.score, result.findings);

// Map codebase
const map = await mapCodebase({ root: "." });
console.log(map.entryPoints, map.hotspots);

// Persistent memory
const store = createMemoryStore(".superdev");
store.add({ content: "auth uses JWT", tags: ["auth"], tier: "working" });
const results = store.search({ query: "authentication" });

// Self-evolving skills
const skills = createSkillManager(".superdev");
skills.learn({ input: "fix lint errors", output: "ran eslint --fix", success: true });

Architecture

superdev
├── memory/        Infinite hierarchical memory (working → short → long → archive)
├── review/        Code review engine (19 detectors, AI slop, security, bugs)
├── codebase/      Architecture mapper + onboarding guide generator
├── evolution/     Self-evolving skill manager
├── testing/       Test health checker + fix suggestions
├── cost/          AI API cost tracker + budget alerts
├── config/        Environment/config validator
├── cli/           Command-line interface
└── mcp/           MCP server (9 tools)

License

MIT