JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 4402
  • Score
    100M100P100Q98708F

Package Exports

  • imhcode

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (imhcode) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

🕌 IMH-Code — Imam Hussain Coding Harness Platform

A fast-first multi-agent AI coding harness with intelligent model routing, configurable testing, and token-saving optimizations for rapid SaaS MVP development.

npm version License: MIT Agents Skills

📚 Documentation

For detailed information on how to configure and execute IMH-Code, see:

  • User Manual — Comprehensive guide on pipeline phases, stack configurations, and custom agent systems.
  • CLI Execution Guide — Command reference, usage options, aliases, and agent execution architectures.

⚡ Quick Start

1. Install Globally

npm install -g imhcode

2. Initialize a Workspace

Navigate to your project directory and run the initialization wizard:

cd your-project
imhcode

This scans your system for local engines (Claude, OpenCode, Codex, Antigravity, QwenCode, MimoCode) and sets up the Intelligent Model Routing configurations inside imhcode.config.json.

🔄 The 6-Phase Pipeline

IMH-Code enforces a fast-first software delivery pipeline:

  1. Write: Describe your product requirements in docs/start.md.
  2. Plan: Run imhcode plan to generate docs/brainstorming.md.
  3. Brainstorm: Review recommended answers in docs/brainstorming.md and run imhcode plan again.
  4. Sprint Plan: Sprints, tasks, and shell execution scripts are generated.
  5. Execute: Run imhcode execute 1 (or specify sprint). Respects your selected testing mode.
  6. Test: Run imhcode test to execute E2E browser tests, security audit, and SEO scans.

🛠️ Usability Upgrades (v2.0)

Version 2.0 introduces powerful new commands for codebase scanning, project imports, in-place changes, and interactive control:

  • Scan & Import: Run imhcode scan or imhcode import to bring existing projects (Next.js, Laravel, React, etc.) under orchestration. Maps project folders to .imhcode/import-map.json automatically.
  • In-place Modifications: Run imhcode modify "task" to auto-detect the target agent and run in-place code adjustments.
  • Feature Sprint Planning: Run imhcode feature "desc" to plan a targeted 1-3 task mini-sprint for adding a new feature.
  • Interactive Terminal TUI: Run imhcode (or imhcode gui) to launch a beautiful, interactive terminal user interface (TUI) to manage your projects, sprints, and code modifications via a simple console-based dashboard.

🔒 Configurable Testing Strategy

Unlike other frameworks that mandate slow TDD at every step, IMH-Code lets you choose:

  • Fast Mode (Default): No tests written during development sprints. A dedicated testing sprint is appended at the end to cover unit, integration, security, and browser tests. 3-5x faster development.
  • Balanced Mode: Basic smoke tests per task, full test suites at the end.
  • Strict TDD: Write failing tests first before coding on every task.

🤖 19 Generic Role-Based Agents

IMH-Code replaces individual persona names with generic agents routed to the best models:

  • planner: Sprint coordination and architecture.
  • designer: UI/UX design (prefer Mimo v2.5 Pro).
  • nextjs-executor: Next.js full-stack (prefer Mimo v2.5 Pro).
  • laravel-executor: Laravel backend (prefer DeepSeek V4 Pro).
  • tester: Unit/Integration/E2E tests (prefer GPT-5.5).
  • security-auditor: OWASP security scans (prefer GPT-5.5).
  • seo-optimizer: SEO & sitemaps (prefer GPT-5.5).
  • (Run imhcode agent list to see all 19 agents)