antigravity-workspace-manager
amartelr · amartelr/antigravity-workspace-manager
A CLI to manage AI coding agent workspaces and dynamically inject specific skills tailored to project tech stacks.
A powerful CLI to orchestrate workspaces and dynamically inject specialized skills into AI coding agents.
Preview
What you can do with it
- Set up a new project workspace and automatically load relevant Claude Code skills for React development.
- Switch between different project contexts, ensuring your AI agent uses the correct toolset for each.
- Keep all your AI agent skills synchronized from a central repository across multiple local projects.
Safety check
Usable, but read the notes first.
- ●Installer downloads a remote script and pipes it to the shell.
README.md
Automated scan of the repo files. Always review code you run.
From the README
🚀 Antigravity Workspace Manager
Read this in other languages: English, Español
⚡ The ultimate companion CLI for the viral
antigravity-awesome-skillslibrary.
A complete management system to structure your projects (workspaces) and dynamically inject skills using the famous antigravity-awesome-skills repository. While the original repository provides specialized knowledge (+250 skills), this manager brings the orchestration needed for your AI assistants (Antigravity, Claude Code, Cursor) to load exclusively the necessary context into each project.
✨ Key Features
- Dynamic Location: Intelligent detection of the base project path, allowing you to invoke the script from any subdirectory within your environment.
- Smart Wizard: A step-by-step terminal interface to easily create workspaces and auto-enable recommended skills tailored to your tech stack.
- Environment Isolation: Each project (workspace) maintains its own
skill-config.jsonconfiguration file and a symbolic link (symlink) environment routing only to the designated skills. - Transparent Synchronization: Integrated system to safely sync (clone/update) the global folder from the official GitHub repository, including automatic backups.
- Auto-Repair: Detection and cleanup of orphaned or broken skills in case they are removed from the parent repository.
🚀 Quick Start
1. Installation (Recommended)
Get the wsm alias and initialize everything in one command:
curl -sSL https://raw.githubusercontent.com/amartelr/antigravity-workspace-manager/main/install.sh | bash
Restart your terminal after installation to enable the wsm command.
2. Manual Installation (Alternative)
If you prefer to do it manually:
# 1. Clone the repository
git clone https://github.com/amartelr/antigravity-workspace-manager.git
cd antigravity-workspace-manager
# 2. Initialize
wsm init
💡 Portability Tip: You can move the folder wherever you prefer (e.g.,
~/MyProjects). The script will auto-detect its new location.
2. Create Your First Workspace (Assisted Mode)
The highly recommended workflow is to use the interactive wizard:
wsm wizard
The completely redesigned wizard will guide you through 5 steps to define your environment:
- The Name and Description of the workspace.
- The Project Type (14 detailed options):
- From classics like API Backend, Web Frontend, Mobile App, to new flows like Microservices, AI/ML, Data Engineering, DevOps/Infra, Game Dev, SEO/Marketing, Security/Pentesting and Blockchain/Web3.
- The Primary Language (15 options):
- Python, JavaScript/TypeScript, Go, Dart/Flutter, Rust, Java/Kotlin, C#/.NET, C/C++, Swift/SwiftUI, Ruby, PHP, Elixir, Scala, Julia or Haskell.
- The Database (11 options):
- PostgreSQL, Supabase, MongoDB/NoSQL, MySQL, SQLite, Redis, Firebase, Neon Postgres, Google Sheets, Elasticsearch or DynamoDB.
- Intelligent Skill Recommendation (Multi-select):
- Based on your previous selections, the wizard will suggest highly relevant categories to inject into your project.
- Examples of dynamic suggestions:
- 🏗️ Architecture & Quality:
architecture,microservices-patterns,clean-code... - 🧪 Testing & Debugging:
tdd-workflow,playwright-skill... - 🚀 DevOps & Deploy:
docker-expert,github-actions-templates... - 🔒 Security:
api-security-best-practices... - 🤖 AI/ML:
prompt-engineering,rag-implementation... - 📈 SEO & Marketing:
seo-fundamentals,analytics-tracking... - ⚡ Automation:
workflow-automation,n8n-mcp-tools-expert...
- 🏗️ Architecture & Quality:
🛠️ Essential Commands
| Action | Command |
|---|---|
| Initialize Structure | wsm init |
| Assisted Setup | wsm wizard |
| Manual Creation | wsm create project-name |
| View Active Workspaces | wsm list |
| View Full Skills Catalog | wsm list-skills |
| View Project Skills | wsm list-skills project-name |
| Enable Skill | wsm enable project-name skill-name |
| Disable Skill | wsm disable project-name skill-name |
| Recommend Skills | wsm reco-skills project-name |
| View Skill Detail | wsm show skill-name [--lang es] |
| Sync and Repair Skills | wsm sync --auto-fix |
📂 Generated Structure Organization
After executing the init command, the script will automatically deploy a robust hierarchy for yo