LitGravity plugin
A plugin for Antigravity CLI: the word lit at the start of a prompt starts a plan, row-by-row builds with tests, review, handoff
- 167 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Hooks run scripts on every agent step and the installer writes a rule into `~/.gemini/config/rules/`
- The tool call ledger is stored in the project and can contain paths and command text
Install
- Works in
Manual install
npx @litfamily/litgravity installRequires Node.js 20+ and Antigravity CLI. The `--dry-run` flag previews with no writes.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Hooks run scripts on every agent step and the installer writes a rule into `~/.gemini/config/rules/`
- The tool call ledger is stored in the project and can contain paths and command text
This is third-party code. Review the repository files before installing.
What it does
LitGravity runs on top of Google Antigravity CLI, the `agy` command. It installs with `npx @litfamily/litgravity install`: by default the plugin is copied to `~/.gemini/config/plugins/litgravity`, and with `--scope project` to `./.agents/plugins/litgravity`. The installer shows every path first, and `doctor` checks the copy, the six hook events and a run of each script. If a prompt starts with `lit`, a hook before the first model call tells the agent which skill to read. `lit plan` writes a plan with ordered tasks and checks into `plans/`, `lit start plans/<slug>.md` builds it row by row with tests, and there are also `lit review`, `lit research`, `lit debug`, `lit brainstorm`, `lit handoff` and `lit recap`. Before stopping, `lit handoff` leaves a note in `.litgravity/`, and on the next start `lit recap` reads it. The set includes 42 skills, 11 agents and 6 hooks. Hooks route the prompt, hold an unfinished turn until a plan file exists, forbid child agents from writing during planning and keep a tool call ledger with keys masked. Document, diagram, scientific figure and motion skills install separate engines into `~/.local/share/litgravity/runtime/`. A status line under the prompt shows the model, context, quota and route stage.
Who it is for. Antigravity CLI users who want a repeatable routine: a plan, test-driven build, review and handoff between conversations.
Good fit when
- A long conversation fills its context and the next one starts without the last one lessons, and `lit handoff` with `lit recap` close the gap
- Before a big edit you want a plan in `plans/` with ordered tasks and checks
- Research proceeds with sources, and the `lit research` skill shows where each conclusion came from
- Installation is done by telling an agent to run it, checking the plan through `--dry-run` and the result through `doctor`
Not a fit when
- The agent is not Antigravity CLI: the plugin is built for `agy` and its plugin directory
- You have no Node.js 20 or newer: installation runs through npx
- You need one quick prompt with no plan: the `lit` word adds stages that are excessive for small tasks
Example request
lit plan a small todo app: write the plan and wait for my approval before lit startLimitations
Node.js 20 or newer and Antigravity CLI signed in once are needed. The installer places one rule in `~/.gemini/config/rules/litgravity.md` that agy reads at every session start. Antigravity loads only the first 24,000 bytes of a `SKILL.md`, so long material sits in `references/` folders. Some checks cannot run in advance: the PostInvocation and Stop hooks perform them after a turn. Document and graphics engines install separately and only into `~/.local/share/litgravity/runtime/`. The tool call ledger in `.litgravity/ledger/` masks key shapes but remains a project file.
How to disable. Run `npx @litfamily/litgravity uninstall`, which removes the plugin and its own rule in `~/.gemini/config/rules/`. Delete the `plans/` and `.litgravity/` directories in projects by hand if you no longer need them.
FAQ
How do I install LitGravity?
Run `npx @litfamily/litgravity install`. The `--dry-run` flag only previews, `--scope project` installs into the project and `--yes` allows installation from a shell without a terminal. Check with `npx @litfamily/litgravity doctor`.
What does the lit word at the start of a prompt mean?
A hook reads it and tells the agent which LitGravity skill to read before working. A bare `lit` runs the default loop and the next word picks the route: `lit plan`, `lit review`, `lit research`, `lit debug`, `lit handoff`.
How do I hand work to the next conversation?
Before stopping, run `lit handoff` and it writes a note in `.litgravity/`. In a new conversation `lit recap` reads it and shows where you stopped. The session start hook points to a fresh note.
What does the set include?
42 skills, 11 agents and 6 hooks. Agents: lit-planner, lit-executor, lit-verifier, qa-runner, quality-reviewer, librarian-researcher and five Korean prose agents.
How do I see the state of the work?
The optional `--status-line` row under the prompt shows the model, effort tier, context fill, quota and a route map with the current stage lit.
Discussion
No questions or reviews yet.
Related
PluginsAn Antigravity CLI plugin for engineering work: a separate design turn, documentation agents and edits only within a sealed plan
Installer of a working setup for Google Antigravity that puts rules, skills and workflows into a project with one npx command
Superpowers for Google Antigravity: a fork of the methodology with native agy tools and no translation layer.
Writ turns workflow rules into checks at tool-call time: Claude Code writes no code until you approve the plan and tests
planr keeps agent-driven development tasks in Git Markdown files and shows what is ready, blocked and waiting on you
Agentic OS adds a five-step workflow and checks in git hooks and CI so that a step without evidence does not count as done
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| LitGravity (this card) | no | 167 | |
| Antigravity for Claude Code | no | 484 | a Claude Code plugin that delegates work to Gemini through Antigravity CLI, while this lives inside Antigravity CLI itself |
| agy-staff | no | 860 | delegation to an intern: Antigravity CLI for Claude Code and Codex, while this adds its own plan and handoff loop inside agy |
README in short
The README shows a hook demo and sample results, explains what Antigravity CLI lacks in long conversations and gives stepwise installation with `doctor`. A quick start with `lit` routes, the status line, the set of 42 skills, 11 agents and 6 hooks and Antigravity limits follow.