Antigravity CLI helped me understand a complex codebase far faster than I expected


I’ll admit it, I’m a bit of an AI-sceptic. I see how AI-powered search can perform wonders with natural-language queries, but when it comes to editing my code, I still like to have control.

However, Antigravity could be the tool to convince me otherwise, and if you’re still on the fence about AI coding agents, it may do the same for you, too. This is a tale of false assumptions, one AI pitted against another, and a minor redemption arc.

What is Antigravity CLI?

AI on the command line, with a great-looking app

The Antigravity CLI is a replacement for Gemini CLI, which made the Gemini 3 model available on the command line. It’s an interactive program that lets you query an AI agent for all manner of coding tasks:

The Antigravity welcome screen showing a color scheme selector and an example prompt and response.

Antigravity CLI supports the Gemini 3.5 Flash and Gemini 3.1 Pro models, alongside others like Claude Sonnet, Claude Opus, and GPT-OSS 120B.

When you run it and grant it access to your current directory, it will analyze the files inside, gaining deep insight about the code. Antigravity can make code edits if you allow it, but it can also help you understand a codebase and even just explain how to use a command.

Installing and using agy

A bit of one-off configuration, then usage is straightforward

You can find installation instructions for your platform on Antigravity’s download page. For Linux and macOS users, it’s a simple case of running this command:

curl -fsSL https://antigravity.google/cli/install.sh | bash

Once you’ve installed it, make sure the binary location is in your PATH, then run agy and you should see an initial welcome screen.

Sign in with your Google credentials, and complete the authentication process to continue. You’ll typically see a confirmation screen for new projects, asking you if you trust the contents of whichever directory you launched agy from.

Be aware that Antigravity can change your code and run commands on your machine. Go slowly and pay attention to the on-screen warnings!

Exploring a codebase with agy

Run it from a repo and get all the answers you need

I initially turned to Antigravity to resolve a tricky problem with eza, the modern alternative to ls. Trying to understand the tool’s –total-size option, I began with a simple DuckDuckGo query that relayed some answers using its AI summary feature:

The DuckDuckGo search assist explaining how to get the total size of a directory on Linux, using a find command piped to stat and awk.

Although AI-powered search can often be wrong, I’ve found it useful most of the time, and it’s certainly less controversial than generative AI, partly because old-school search was already doing much of the same thing anyway.

An eza command reporting a directory size of 7808B and a find command reporting a directory size of 7637B.

Something still wasn’t quite right, however: eza was reporting a size of 7,808B while the find command gave 7,637B. At this point, if I’d thought about the problem some more, I may have come to a realization of my own. But I wanted to give agy a run anyway, so I went ahead and fired it up:

The agy CLI app showing a prompt: "The -B, -l, and --total-size options show me the footprint of a directory. But when I calculates this with a find command, I get a different total. What could explain this?

Note that I’m running agy directly from the eza source directory here, so there’s no need to give any context like which tool I’m even talking about. Antigravity is clever enough to realize that I’m talking about the eza command and its –total-size option.

While the model thinks, it shows fascinating insights into the process:

Antigravity CLI showing its process while responding to a prompt, including details about directories and files it accesses, and commands it runs.

As it goes about the job of answering your question, you’ll see references to files, details about the commands it runs, and more. Above all else, being able to peek behind the curtain to see what the agent is actually doing was a revelation for me.

Initially, though, while agy offered amazing insight into some of the possible factors, I wasn’t all too sure they applied, so I went for a follow-up:

A prompt asking Antigravity to reconsider, giving details of a precise find command.

By this point, I really wanted to get to the heart of the issue: why find was reporting a different size than eza was. Giving the model additional information can, of course, improve its handling of the task, especially external information such as this.

Sure enough, after a few more seconds, agy came back with plenty of possible explanations.

An Antigravity response explaining that one reason for differences between a find command and eza's total-size option is that the latter includes non-regular files.

Using agy—or any other AI tool—can involve refinement and a back-and-forth process. You can always use it in parallel, while you explore the codebase in another terminal or a text editor.

Now, to really test Antigravity, I wanted to see if it could fix my find command to resolve the inconsistency:

A prompt asking Antigravity to fix a find command. Antigravity provides a new command along with an explanation.

In particular, I’m asking it to match eza. There’s not a lot of detail there, but in the context of the overall conversation, agy has no problem at all understanding what I’m getting at.

But there’s still a minor problem: macOS’s BSD version of stat behaves differently from the GNU version of stat. By this point, I’d gotten a bit lazy, so I just banked on Antigravity to do all the work for me:

Antigravity tweaking a command for compatibility with macOS.

After just a few minutes, Antigravity had delved into a codebase, explored the path of a specific command-line option, and helped me refine a command for my platform. That final command delivered, now matching the output from eza:

A find command printing a total size of 7808B.


Antigravity has convinced me: an AI assistant can be valuable

Even though I approached it with skepticism, Antigravity delivered. As an affirmed lover of the command line, agy is a powerful yet accessible tool that I’ll be keeping a close eye on in the future.



Source link

Leave a Reply

Subscribe to Our Newsletter

Get our latest articles delivered straight to your inbox. No spam, we promise.

Recent Reviews


When Encanto was released, it was something of a cultural phenomenon. You couldn’t escape the song “We Don’t Talk About Bruno,” and the soundtrack went to the top of the charts. If you loved Encanto, there’s another overlooked Lin-Manuel Miranda animated musical on Netflix that’s better in many ways.

Vivo is another Lin-Manuel Miranda musical

He’s also the voice of the lead character

Vivo the kinkajou from the movie Vivo. Credit: Sony Pictures Animation

Vivo is a 2021 animated musical comedy from Sony Pictures Animation, the same studio behind smash-hit movies such as Spider-Man: Into the Spider-Verse and KPop Demon Hunters. Directed by Kirk DeMicco, who co-wrote it with Quiara Alegría Hudes, it features original songs written by Lin-Manuel Miranda, the musical genius who shot to superstardom on the back of Hamilton.

Miranda also plays the title character of Vivo, a kinkajou (a small, nocturnal mammal) whose days are spent earning money by playing music in the plaza with his aging owner, Andrés. When Andrés dies, Vivo makes it his mission to deliver a song that Andrés wrote to his old friend Marta Sandoval, a famous singer played by Gloria Estefan. The song reveals Andrés’ true feelings for Marta, but he could never bring himself to give it to her.

Vivo is helped on his quest by Gabi, a young misfit and the daughter of Andrés’ niece. The movie follows their journey through the Florida Everglades to reach Miami and deliver the song.

Why Vivo flew under the radar

The big theatrical release never happened

Gabi and Vivo on a raft in the movie Vivo. Credit: Sony Pictures Animation

Vivo is an animated musical from a major animation studio, with a cast of big names including Miranda, Gloria Estefan, and Zoe Saldaña. It features music from one of the most in-demand songwriters in the world, who also stars in it. Why isn’t it more well-known?

Perhaps the biggest reason is that Vivo never got its expected theatrical release. After the global pandemic disrupted Sony’s plans for a wide theatrical release, the rights were sold to Netflix. Instead of a major theatrical run, it joined the huge catalog of Netflix, where shows and movies all too often get buried by the churn of new content.

It meant that, unlike Encanto, Vivo never really got the chance to enter the zeitgeist or become a TikTok staple. Its fairly quiet release on a streaming service meant that it never got the attention that it deserved.

Subscription with ads

Yes, $8/month

Simultaneous streams

Two or four

Stream licensed and original programming with a monthly Netflix subscription.


Vivo’s music hits different

Gloria Estefan still has it

When Encanto came out, people raved about the music. The song “We Don’t Talk About Bruno” went viral, with an endless stream of TikTok videos. To my mind, however, the music in Vivo is just so much better.

I never really got the hype about “We Don’t Talk About Bruno.” It’s not bad, but it’s not even the best song in Encanto. While the music in Encanto is good, none of the songs really stand out as being classics. I listen to a lot of Disney movie soundtracks with my kids, and Encanto very rarely makes the playlist, while Moana, which also includes songs written by Lin-Manuel Miranda, gets played far more often.​​​​​​​


The Pixar Logo featured before their movies


Pixar’s best movie isn’t one of the old classics, it’s this blockbuster from 2017

I’m sorry, Toy Story, but a new winner has entered the chat

What gets played a lot is the Vivo soundtrack because it’s genuinely brilliant. There’s something for everyone, too; there are four of us in the family, and each of us has a different favorite song from the soundtrack. That’s how good it is.

“One of a Kind” is the song that introduces us to Vivo and Andrés, and it’s a great mix of classic Cuban mambo and clave rhythms combined with Lin-Manuel Miranda’s trademark hip-hop flow. “My Own Drum” is an absolute banger sung by Gabi featuring possibly the greatest recorder solo of all time. My personal favorite, “Keep The Beat,” is a gorgeous song about keeping going when things start to change.

The most beautiful song in the movie is “Inside Your Heart,” performed by the legendary Gloria Estefan. This is the song that Andrés wrote for Marta, expressing his feelings for her. It’s a stunning song, and Estefan’s voice still sounds incredible. For me, it lands far harder than anything in Encanto.

What Vivo offers that Encanto doesn’t

There’s more than just the awesome music

2D animation of a young Andres and Marta dancing from the movie Vivo. Credit: Sony Pictures Animation

While both movies have music written by Lin-Manuel Miranda, only one of them features the songwriter in the main cast. Some of the fast-paced rhymes in Vivo are so distinctive that you can’t imagine anyone else doing them justice, as Dwayne Johnson proved in Moana.

Vivo also has a more dynamic story, with the action involving a race from Cuba to Miami rather than being set entirely within one location like Encanto. It also includes some interesting stylized 2D sequences that mix up the look of the movie. The emotional stakes are also much higher in Vivo, with a story that touches on death, regret, lost love, and finding your place in the world.

That’s not to say it’s a perfect movie. The plot does dip a little in the middle, but the stunning music and bittersweet ending make up for the flaws.


A woman watching Netflix with two kids, a 'Kids' icon in the background, and the Netflix logo.


My Kids Love These 10 Netflix Shows—And Shockingly, So Do I

Are you a parent tired of watching awful kids’ shows? Give yourself a break with these Netflix series that will entertain both you and your children.


Check out Vivo if you haven’t already

If you loved Encanto and you haven’t watched Vivo, you should definitely check it out. It’s a movie that really deserves more attention than it gets. I guarantee it will be the best kinkajou-based animated musical you’ll ever see.



Source link