ai-max  by zhukunpenglinyutong

AI-powered CLI for enhanced Claude Code development

Created 3 months ago
257 stars

Top 98.3% on SourcePulse

GitHubView on GitHub
Project Summary

AI MAX is a set of production-grade agents, skills, hooks, commands, and MCP configurations designed to significantly enhance the capabilities and user experience of Claude Code. It targets users of Claude Code seeking to boost its intelligence and streamline development workflows, offering an out-of-the-box solution for advanced AI-assisted coding.

How It Works

This project is a fork and enhancement of everything-claude-code, providing a modular system installable via npm. It introduces specialized agents for delegated tasks, reusable skills for defining workflows and domain knowledge, hooks for triggering actions on tool events, and commands (accessed via slash commands like /aimax:plan) for specific operations. Rules enforce coding standards and best practices. This layered approach allows for deep customization and efficient management of Claude Code's extended functionalities.

Quick Start & Requirements

  • Install: npm install -g aimax
  • Run: Execute aimax for interactive installation or use slash commands within Claude Code (e.g., /aimax:auto 你的问题).
  • Prerequisites: Claude Code.
  • Links: README serves as primary documentation.

Highlighted Details

  • Offers a comprehensive suite of slash commands including /aimax:auto (intelligent command selection), /aimax:plan (feature planning), /aimax:tdd (test-driven development), /aimax:code-review, /aimax:build-fix, /aimax:e2e (end-to-end testing), /aimax:test-coverage, /aimax:refactor-clean, /aimax:update-docs, and /aimax:update-codemaps.
  • Core concepts include specialized Agents (e.g., code-reviewer), Skills (e.g., TDD workflow definitions), Hooks (e.g., console.log detection), and Rules (e.g., security, coding style).
  • A recommended workflow guides users through planning, TDD, code review, and build fixing stages.
  • Organized directory structure for agents, skills, commands, rules, hooks, MCP configurations, plugins, and examples.

Maintenance & Community

No specific details regarding maintainers, community channels, or sponsorships were found in the provided README.

Licensing & Compatibility

Licensed under MIT, allowing for free use and modification. Contributions are encouraged. The license is permissive for commercial use.

Limitations & Caveats

A critical limitation is context window management. Enabling numerous MCP configurations can significantly reduce the effective context window (e.g., from 200k to 70k tokens). Recommendations include configuring 20-30 MCPs, enabling no more than 10 per project, and limiting active tools to 80. Users should utilize disabledMcpServers to manage and disable unused tools.

Health Check
Last Commit

2 months ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
36 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.