McGravity

by tigranbs

100 stars
538 downloads
Not rated
GitHub

About

Fast TUI that orchestrates AI coding tools (Claude Code, Codex, Gemini) in a plan→execute→review loop. Breaks work into atomic tasks for easier verification and course-correction.

Details

Author
tigranbs
GitHub stars
100
Downloads
538
Categories
AI

- 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.

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.

McGravity

<div align="center">
McGravity Thumbnail
</div>

Fast, opinionated TUI for AI-assisted coding.

McGravity orchestrates AI coding tools (Claude Code, Codex, Gemini) in a tight feedback loop: plan small tasks → execute one at a time → review → replan. Instead of dumping a huge prompt and hoping for the best, McGravity breaks your work into atomic pieces that are easier to verify and course-correct.

+------------------------------------------------------------+
| McGravity                                    [Claude Code] |
+--------------------------- Output -------------------------+
| > Planning complete                                        |
| > Executing task-001.md...                                 |
| + Created src/auth/login.rs                                |
| + Updated src/main.rs                                      |
+------------------------------------------------------------+
| Iteration #1 | Executing | task-001.md                    |
+------------------------------------------------------------+
| [##########-----] 1/3 tasks                                |
+--------------------------- Task ---------------------------+
| Add user authentication with JWT tokens.                   |
| Reference @src/auth/ for existing patterns.                |
+------------------------------------------------------------+
| [Esc] Cancel  [Ctrl+S] Settings                            |
+------------------------------------------------------------+

How It Works

McGravity runs a continuous improvement loop:

flowchart LR
    A[Your Task] --> B[Plan]
    B --> C[Execute]
    C --> D{Done?}
    D -->|More work needed| B
    D -->|Complete| E[Finished]

Quick Start

1. Install McGravity

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.