DEV Community

Cover image for Meet Gravhub: Per-profile isolated workspace manager for Antigravity CLI (agy)
Hugo Pedro
Hugo Pedro

Posted on

Meet Gravhub: Per-profile isolated workspace manager for Antigravity CLI (agy)

Hey everyone! 👋

If you use the Antigravity CLI (agy), you've probably faced the challenge of managing multiple environments (e.g., work, freelance projects, and personal profiles) on the same machine. Sharing the same local credentials and keyring can easily lead to mistakes or messy configurations.

To solve this, I built Gravhub — a lightweight, cross-platform per-profile isolated workspace manager.


🌌 What is Gravhub?

Gravhub acts as a secure sandbox for your agy CLI sessions. It temporarily redirects system paths and manages independent keyring entries for each profile, ensuring your workspaces are completely isolated.

  • Runs seamlessly on Windows (PowerShell) and Linux (Bash).
  • Keeps configuration files, system paths, and keyring logins isolated in profile-specific directories.
  • Prompts change dynamically to show you which profile is currently active.

🚀 Quick Start in 3 Steps

Here is how easily you can get started:

1. Installation

Windows (PowerShell):

irm https://raw.githubusercontent.com/hugopedro/gravhub/main/install.ps1 | iex
Enter fullscreen mode Exit fullscreen mode

Linux (Bash):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/hugopedro/gravhub/main/install.sh)"
Enter fullscreen mode Exit fullscreen mode

2. Create a Profile

Create a profile for your work projects:

gravhub new work
Enter fullscreen mode Exit fullscreen mode

3. Enter the Profile

Activate the workspace and run your standard commands:

gravhub work
Enter fullscreen mode Exit fullscreen mode

Now, everything you execute will run securely inside your isolated work sandbox!


🛠️ Main Features

  • 📂 Management: Easily clone, rename, list, or delete profiles.
  • 💾 Portability: Save profiles as templates, export them, or import them on other machines.
  • 🔑 Security: Isolates authentication keyring state automatically, keeping credentials safe.

Check out the full repository and let me know your thoughts! ⭐ Star the project if it makes your daily CLI workflows easier!

👉 GitHub Repository: https://github.com/hugopedro/gravhub

Top comments (0)