McGravity

What is McGravity?

McGravity is a fast, opinionated terminal UI (TUI) for AI-assisted coding. It orchestrates AI coding tools (Claude Code, Codex, Gemini) in a tight feedback loop: plan small tasks, execute one at a time, review, and replan. The tool is built for developers who want controlled, iterative AI assistance rather than dumping a large prompt.

How to use McGravity?

Install McGravity globally via npm (npm install -g mcgravity), then install at least one supported AI CLI tool (Claude Code, Codex, or Gemini CLI). Navigate to your project directory and run mcgravity. On first run it detects available AI tools and asks which to use for planning and execution. Type a task description and press Enter to start the flow. Settings are saved automatically to .mcgravity/settings.json.

Key features of McGravity

• Breaks work into atomic, verifiable tasks.
• Supports multiple AI backends: Claude Code, Codex, Gemini.
• File mentions with fuzzy search via @ syntax.
• Slash commands for settings, clear, and exit.
• Runs entirely locally; no code or keys transmitted.
• Configurable max iterations and enter behavior.

Use cases of McGravity

• Break a large feature request into small, sequential tasks.
• Review and course-correct after each AI-generated change.
• Build a new endpoint by planning, implementing, and testing incrementally.
• Fix bugs with controlled, iterative AI suggestions.

FAQ from McGravity

Which AI tools does McGravity support?

McGravity supports Claude Code, Codex (OpenAI), and Gemini CLI (Google). You need at least one installed.

How do I install McGravity?

Install it with npm install -g mcgravity, or build from source using cargo install --path . after cloning the repository.

Does McGravity send my code anywhere?

No. McGravity runs AI CLI tools locally on your machine and never collects, stores, or transmits your code or API keys.

Where are settings stored?

Settings are saved automatically to .mcgravity/settings.json in your project directory.

How do I insert a newline in the task input?

Use Ctrl+J (works on all terminals), Shift+Enter, or a backslash escape (\ then Enter). You can also set "Enter Behavior" to "Newline" in settings.