++ English | 中文 | Español | Français | Português | Українська | Deutsch +
+ +
+
+
+ Community-Fork & gehärtete Offline-Version von google-antigravity/antigravity-cli mit automatischer Konfiguration von Statuszeile und Fenstertitel +
+ +
+ 
+ 🤖 KI-Codierungsagent direkt in Ihrem Terminal. Versteht den Kontext Ihrer Codebasis, erstellt und bearbeitet Dateien, führt sichere Befehle in einer Sandbox aus und löst komplexe architektonische Aufgaben mit einem einzigen Prompt. +
+ +--- + +## ⚡ Schnellstart + +### Sofortige Installation (Offline-first & Zero-dependency) +Dieser Fork lädt vorkompilierte Binärdateien direkt aus den **GitHub Release Assets** herunter (anstatt von Google-API-Servern). Eine vollständig autonome Offline-Installation wird ebenfalls unterstützt, wenn die erforderlichen Archive zuvor in den Ordner `packages/binaries/` heruntergeladen wurden. + +#### 🐧 Linux und 🍎 macOS +```bash +# Netzwerkinstallation aus dem Fork-Repository: +curl -fsSL https://raw.githubusercontent.com/weby-homelab/antigravity-cli/main/install.sh | bash + +# ODER Offline-Installation aus einem lokalen Repository: +git clone https://github.com/weby-homelab/antigravity-cli.git +cd antigravity-cli +# (Optional: Laden Sie Plattform-Archive nach packages/binaries/ herunter) +make install +``` + +#### 🪟 Windows PowerShell +```powershell +# Netzwerkinstallation: +irm https://raw.githubusercontent.com/weby-homelab/antigravity-cli/main/install.ps1 | iex + +# ODER Offline-Installation aus einem geklonten Repository: +.\install.ps1 +``` + +#### 🪟 Windows CMD +```cmd +# Netzwerkinstallation: +curl -fsSL https://raw.githubusercontent.com/weby-homelab/antigravity-cli/main/install.cmd -o install.cmd && install.cmd && del install.cmd + +# ODER Offline-Installation aus einem geklonten Repository: +install.cmd +``` + +--- + +## 📋 Hauptfunktionen + +> [!NOTE] +> Im Gegensatz zur Originalversion ist dieser Fork für den stabilen Betrieb in Headless-/SSH-Sitzungen und lokalen Home-Labs angepasst. + +* 📂 **Bearbeitung mehrerer Dateien** — Bearbeitet mehrere Dateien gleichzeitig in Ihrem Arbeitsbereich mit vorheriger Bestätigung der Änderungen. +* 🔒 **Sichere Shell-Befehle** — Führt beliebige Terminalbefehle im integrierten Docker-Container (Sandbox) oder auf dem Hostsystem aus. +* 🧠 **Mehrstufiges Denken (PAV)** — Erstellt selbstständig einen Plan zur Aufgabenausführung, testet Code und behebt eigene Fehler. +* 💾 **Persistenter Konversationsverlauf** — Speichert den vollständigen Konversationskontext und den Zustand des Arbeitsbereichs zwischen den Sitzungen. +* 🔌 **Plugin-System** — Erweitern Sie die Fähigkeiten des Agenten mit benutzerdefinierten *Skills* und MCP-Servern (Model Context Protocol). + +--- + +## ⚙️ Konfiguration + +### 1. Projektkonfiguration (`GEMINI.md`) +Erstellen Sie eine `GEMINI.md`-Datei im Stammverzeichnis Ihres Projekts, um dem KI-Agenten spezifischen Kontext und Entwicklungsregeln bereitzustellen: + +```markdown +# Projektkontext + +- Dieses Projekt verwendet FastAPI und Pydantic v2. +- Verwenden Sie immer `model_dump()` anstelle des veralteten `dict()`. +- STRIKTE REGEL: Keine fest codierten Passwörter im Code. Importieren Sie alle Geheimnisse aus `.env`. +``` + +### 2. Globale Einstellungen (`~/.gemini/antigravity-cli/settings.json`) +Die globale Einstellungsdatei steuert Berechtigungen zur Tool-Ausführung, Statuszeilen-/Titel-Skripte und MCP-Server: + +- **Linux/Unix**: `~/.gemini/antigravity-cli/settings.json` +- **macOS**: `~/Library/Application Support/antigravity-cli/settings.json` +- **Windows**: `%APPDATA%\antigravity-cli\settings.json` + +```json +{ + "toolPermission": "always-proceed", + "statusLine": { + "enabled": true, + "command": "/home/user/.gemini/antigravity-cli/statusline.sh" + }, + "title": { + "enabled": true, + "command": "/home/user/.gemini/antigravity-cli/title.sh" + }, + "mcpServers": { + "github": { + "command": "npx", + "args": ["-y", "@modelcontextprotocol/server-github"] + } + } +} +``` + +> [!TIP] +> Für eine erweiterte, reaktionsschnelle Statuszeile mit Echtzeit-Git-Status, Token-Zählern, Modellquoten und Strom-/Batteriestatus verwenden Sie das Plugin **[Antigravity CLI Statusline (Max Edition)](https://github.com/weby-homelab/antigravity-cli-statusline)**. + + +### 3. Spezialisierte Agenten +Sie können benutzerdefinierte Rollen und Anweisungen für KI-Agenten im JSON-Format beschreiben. Jeder Agent muss sein eigenes Verzeichnis haben, das eine `agent.json`-Datei enthält: + +- **Globale Agenten (Linux/Unix)**: `~/.gemini/antigravity-cli/agents/{agent_name}/agent.json` +- **Globale Agenten (macOS)**: `~/Library/Application Support/antigravity-cli/agents/{agent_name}/agent.json` +- **Globale Agenten (Windows)**: `%APPDATA%\antigravity-cli\agents\{agent_name}\agent.json` +- **Lokale Agenten (Projektarbeitsbereich)**: `{workspace_root}/.agents/agents/{agent_name}/agent.json` + +```json +{ + "name": "security-reviewer", + "description": "Analysiert Code vor dem Commit auf Schwachstellen", + "instructions": "Änderungen überprüfen auf:\n- OWASP Top 10 Schwachstellen\n- Durchsickern von API-Schlüsseln oder Geheimnissen\n- Richtigkeit der Firewall-/nftables-Konfiguration" +} +``` + +--- + +## 🔐 Authentifizierungsmethoden + +| Methode | Befehl / Variable | Einschränkungen & Funktionen | +| :--- | :--- | :--- | +| **Google Auth (Browser)** | Automatisch bei der ersten Ausführung von `agy` | Standard-Login. Kostenloses Limit: 60 Anfr./Min., 1000 Anfr./Tag | +| **API-Schlüssel (Offline)** | `export GEMINI_API_KEY="X"` | Empfohlen für Server und Automatisierung | +| **Vertex AI** | `export GOOGLE_GENAI_USE_VERTEXAI=true` | Enterprise-Level mit Google Cloud Cloud-Infrastruktur | +| **Abmelden** | `/logout` | Löschen lokaler Sitzungstoken | + +--- + +## 🔧 Befehlsreferenz + +### Befehlszeile +```bash +agy # Eine interaktive Sitzung starten +agy -p "Prompt" # Einmalige Ausführung ohne Chat-Eingabe +agy -c # Letzte unvollständige Konversation fortsetzen +agy --conversation+ English | 中文 | Español | Français | Português | Українська | Deutsch +
+ +
+
+
+ Bifurcación de la comunidad y versión fuera de línea de google-antigravity/antigravity-cli con configuración automática de statusline y título de ventana +
+ +
+
+ 🤖 Agente de codificación de IA directamente en su terminal. Comprende el contexto de su código base, crea y edita archivos, ejecuta comandos seguros en un entorno aislado y resuelve tareas arquitectónicas complejas en una sola instrucción. +
+ +--- + +## ⚡ Inicio rápido + +### Instalación instantánea (Primero fuera de línea y sin dependencias) +Esta bifurcación descarga archivos binarios precompilados directamente desde los **activos de lanzamiento de GitHub (GitHub Release Assets)** (en lugar de los servidores de la API de Google). También se admite la instalación completamente fuera de línea (offline) si los archivos requeridos se cargaron previamente en la carpeta `packages/binaries/`. + +#### 🐧 Linux y 🍎 macOS +```bash +# Instalación a través de la red desde el repositorio de la bifurcación: +curl -fsSL https://raw.githubusercontent.com/weby-homelab/antigravity-cli/main/install.sh | bash + +# O instalación fuera de línea desde un repositorio local: +git clone https://github.com/weby-homelab/antigravity-cli.git +cd antigravity-cli +# (Opcional: descargue los archivos de la plataforma en packages/binaries/) +make install +``` + +#### 🪟 Windows PowerShell +```powershell +# Instalación a través de la red: +irm https://raw.githubusercontent.com/weby-homelab/antigravity-cli/main/install.ps1 | iex + +# O instalación fuera de línea desde un repositorio clonado: +.\install.ps1 +``` + +#### 🪟 Windows CMD +```cmd +# Instalación a través de la red: +curl -fsSL https://raw.githubusercontent.com/weby-homelab/antigravity-cli/main/install.cmd -o install.cmd && install.cmd && del install.cmd + +# O instalación fuera de línea desde un repositorio clonado: +install.cmd +``` + +--- + +## 📋 Características principales + +> [!NOTE] +> A diferencia de la versión original, esta bifurcación está adaptada para un funcionamiento estable en sesiones sin interfaz gráfica (headless)/SSH y laboratorios domésticos locales. + +* 📂 **Edición de archivos múltiples** — Edita varios archivos simultáneamente en su espacio de trabajo con confirmación previa de los cambios. +* 🔒 **Comandos de shell seguros** — Ejecuta cualquier comando de terminal en el contenedor Docker incorporado (entorno aislado/sandbox) o en el sistema host. +* 🧠 **Razonamiento de múltiples pasos (PAV)** — Construye de forma independiente un plan de ejecución de tareas, prueba el código y depura sus propios errores. +* 💾 **Historial de conversación persistente** — Guarda el contexto completo de la conversación y el estado del espacio de trabajo entre sesiones. +* 🔌 **Sistema de complementos** — Amplíe las capacidades del agente con *habilidades (Skills)* personalizadas y servidores MCP (Model Context Protocol). + +--- + +## ⚙️ Configuración + +### 1. Configuración del proyecto (`GEMINI.md`) +Cree un archivo `GEMINI.md` en la raíz de su proyecto para proporcionar un contexto específico y reglas de desarrollo al agente de IA: + +```markdown +# Contexto del proyecto + +- Este proyecto utiliza FastAPI y Pydantic v2. +- Utilice siempre `model_dump()` en lugar del obsoleto `dict()`. +- REGLA ESTRICTA: No use contraseñas hardcoded en el código. Importe todos los secretos desde `.env`. +``` + +### 2. Configuración global (`~/.gemini/antigravity-cli/settings.json`) +El archivo de configuración global controla los permisos de ejecución de herramientas, los scripts de statusline/título y los servidores MCP: + +- **Linux/Unix**: `~/.gemini/antigravity-cli/settings.json` +- **macOS**: `~/Library/Application Support/antigravity-cli/settings.json` +- **Windows**: `%APPDATA%\antigravity-cli\settings.json` + +```json +{ + "toolPermission": "always-proceed", + "statusLine": { + "enabled": true, + "command": "/home/user/.gemini/antigravity-cli/statusline.sh" + }, + "title": { + "enabled": true, + "command": "/home/user/.gemini/antigravity-cli/title.sh" + }, + "mcpServers": { + "github": { + "command": "npx", + "args": ["-y", "@modelcontextprotocol/server-github"] + } + } +} +``` + +> [!TIP] +> Para obtener una línea de estado avanzada y adaptable con seguimiento de estado de Git en tiempo real, contadores de tokens, cuotas de modelos y estado de energía/batería, use el complemento **[Antigravity CLI Statusline (Max Edition)](https://github.com/weby-homelab/antigravity-cli-statusline)**. + + +### 3. Agentes especializados +Puede describir roles e instrucciones personalizados para agentes de IA en formato JSON. Cada agente debe tener su propio directorio que contenga un archivo `agent.json`: + +- **Agentes Globales (Linux/Unix)**: `~/.gemini/antigravity-cli/agents/{agent_name}/agent.json` +- **Agentes Globales (macOS)**: `~/Library/Application Support/antigravity-cli/agents/{agent_name}/agent.json` +- **Agentes Globales (Windows)**: `%APPDATA%\antigravity-cli\agents\{agent_name}\agent.json` +- **Agentes Locales (Espacio de Trabajo)**: `{workspace_root}/.agents/agents/{agent_name}/agent.json` + +```json +{ + "name": "security-reviewer", + "description": "Analiza el código en busca de vulnerabilidades antes de confirmar", + "instructions": "Buscar en los cambios:\n- Vulnerabilidades OWASP Top 10\n- Filtración de claves de API o secretos\n- Corrección de la configuración del firewall/nftables" +} +``` + +--- + +## 🔐 Métodos de autenticación + +| Método | Comando / Variable | Limitaciones y características | +| :--- | :--- | :--- | +| **Autenticación de Google (Navegador)** | Automáticamente en el primer `agy` | Inicio de sesión estándar. Límite gratuito: 60 sol./min, 1000 sol./día | +| **Clave de API (Fuera de línea)** | `export GEMINI_API_KEY="X"` | Recomendado para servidores y automatización | +| **Vertex AI** | `export GOOGLE_GENAI_USE_VERTEXAI=true` | Nivel empresarial con la infraestructura en la nube de Google Cloud | +| **Cerrar sesión** | `/logout` | Borrado de tokens de sesión local | + +--- + +## 🔧 Referencia de comandos + +### Línea de comandos +```bash +agy # Iniciar una sesión interactiva +agy -p "Mensaje de petición" # Ejecución única sin ingresar al chat +agy -c # Continuar la última conversación incompleta +agy --conversation+ English | 中文 | Español | Français | Português | Українська | Deutsch +
+ +
+
+
+ Fork communautaire et version hors ligne renforcée de google-antigravity/antigravity-cli avec configuration automatique de la ligne d'état et du titre de la fenêtre +
+ +
+
+ 🤖 Agent de codage IA directement dans votre terminal. Comprend le contexte de votre base de code, crée et modifie des fichiers, exécute des commandes sécurisées dans un bac à sable et résout des tâches architecturales complexes en un seul prompt. +
+ +--- + +## ⚡ Démarrage rapide + +### Installation instantanée (Hors ligne d'abord & Sans dépendance) +Ce fork télécharge des fichiers binaires précompilés directement depuis les **GitHub Release Assets** (au lieu des serveurs de l'API Google). Une installation complètement hors ligne est également prise en charge si les archives requises ont été préalablement chargées dans le dossier `packages/binaries/`. + +#### 🐧 Linux et 🍎 macOS +```bash +# Installation réseau à partir du dépôt du fork : +curl -fsSL https://raw.githubusercontent.com/weby-homelab/antigravity-cli/main/install.sh | bash + +# OU installation hors ligne à partir d'un dépôt local : +git clone https://github.com/weby-homelab/antigravity-cli.git +cd antigravity-cli +# (Optionnel : téléchargez les archives de la plateforme dans packages/binaries/) +make install +``` + +#### 🪟 Windows PowerShell +```powershell +# Installation réseau : +irm https://raw.githubusercontent.com/weby-homelab/antigravity-cli/main/install.ps1 | iex + +# OU installation hors ligne à partir d'un dépôt cloné : +.\install.ps1 +``` + +#### 🪟 Windows CMD +```cmd +# Installation réseau : +curl -fsSL https://raw.githubusercontent.com/weby-homelab/antigravity-cli/main/install.cmd -o install.cmd && install.cmd && del install.cmd + +# OU installation hors ligne à partir d'un dépôt cloné : +install.cmd +``` + +--- + +## 📋 Principales fonctionnalités + +> [!NOTE] +> Contrairement à la version originale, ce fork est adapté pour un fonctionnement stable dans les sessions sans écran (headless)/SSH et les laboratoires locaux. + +* 📂 **Édition multi-fichiers** — Modifie plusieurs fichiers simultanément dans votre espace de travail avec confirmation préalable des modifications. +* 🔒 **Commandes shell sécurisées** — Exécute toutes les commandes du terminal dans le conteneur Docker intégré (bac à sable/sandbox) ou sur le système hôte. +* 🧠 **Raisonnement en plusieurs étapes (PAV)** — Construit de manière indépendante un plan d'exécution des tâches, teste le code et débogue ses propres erreurs. +* 💾 **Historique persistant des conversations** — Enregistre le contexte complet de la conversation et l'état de l'espace de travail entre les sessions. +* 🔌 **Système de plug-ins** — Étendez les capacités de l'agent avec des *compétences (Skills)* personnalisées et des serveurs MCP (Model Context Protocol). + +--- + +## ⚙️ Configuration + +### 1. Configuration du projet (`GEMINI.md`) +Créez un fichier `GEMINI.md` à la racine de votre projet pour fournir un contexte spécifique et des règles de développement à l'agent IA : + +```markdown +# Contexte du projet + +- Ce projet utilise FastAPI et Pydantic v2. +- Utilisez toujours `model_dump()` à la place de la méthode obsolète `dict()`. +- RÈGLE STRICTE : Pas de mots de passe codés en dur dans le code. Importez tous les secrets depuis le fichier `.env`. +``` + +### 2. Paramètres globaux (`~/.gemini/antigravity-cli/settings.json`) +Le fichier de configuration globale contrôle les autorisations d'exécution des outils, les scripts de statusline/titre et les serveurs MCP : + +- **Linux/Unix** : `~/.gemini/antigravity-cli/settings.json` +- **macOS** : `~/Library/Application Support/antigravity-cli/settings.json` +- **Windows** : `%APPDATA%\antigravity-cli\settings.json` + +```json +{ + "toolPermission": "always-proceed", + "statusLine": { + "enabled": true, + "command": "/home/user/.gemini/antigravity-cli/statusline.sh" + }, + "title": { + "enabled": true, + "command": "/home/user/.gemini/antigravity-cli/title.sh" + }, + "mcpServers": { + "github": { + "command": "npx", + "args": ["-y", "@modelcontextprotocol/server-github"] + } + } +} +``` + +> [!TIP] +> Pour une ligne de statut avancée et réactive avec suivi du statut Git en temps réel, compteurs de jetons, quotas de modèles et état d'alimentation/batterie, utilisez le plugin **[Antigravity CLI Statusline (Max Edition)](https://github.com/weby-homelab/antigravity-cli-statusline)**. + + +### 3. Agents spécialisés +Vous pouvez décrire des rôles et des instructions personnalisés pour les agents IA au format JSON. Chaque agent doit avoir son propre répertoire contenant un fichier `agent.json` : + +- **Agents Globaux (Linux/Unix)** : `~/.gemini/antigravity-cli/agents/{agent_name}/agent.json` +- **Agents Globaux (macOS)** : `~/Library/Application Support/antigravity-cli/agents/{agent_name}/agent.json` +- **Agents Globaux (Windows)** : `%APPDATA%\antigravity-cli\agents\{agent_name}\agent.json` +- **Agents Locaux (Espace de Travail)** : `{workspace_root}/.agents/agents/{agent_name}/agent.json` + +```json +{ + "name": "security-reviewer", + "description": "Analyse le code à la recherche de vulnérabilités avant le commit", + "instructions": "Vérifier les modifications pour :\n- Les 10 vulnérabilités majeures de l'OWASP\n- Les fuites de clés API ou de secrets\n- L'exactitude de la configuration du pare-feu/nftables" +} +``` + +--- + +## 🔐 Méthodes d'authentification + +| Méthode | Commande / Variable | Limites et fonctionnalités | +| :--- | :--- | :--- | +| **Authentification Google (Navigateur)** | Automatiquement lors du premier `agy` | Connexion standard. Limite gratuite : 60 requêtes/minute, 1000 requêtes/jour | +| **Clé API (Hors ligne)** | `export GEMINI_API_KEY="X"` | Recommandé pour les serveurs et l'automatisation | +| **Vertex AI** | `export GOOGLE_GENAI_USE_VERTEXAI=true` | Niveau entreprise avec l'infrastructure cloud Google Cloud | +| **Déconnexion** | `/logout` | Effacement des jetons de session locale | + +--- + +## 🔧 Référence des commandes + +### Ligne de commande +```bash +agy # Démarrer une session interactive +agy -p "Prompt" # Exécution unique sans entrer dans le chat +agy -c # Continuer la dernière conversation incomplète +agy --conversation+ English | 中文 | Español | Français | Português | Українська | Deutsch +
+ +
+
+
+ Fork da comunidade e versão offline de google-antigravity/antigravity-cli com configuração automática de statusline e título de janela +
+ +
+
+ 🤖 Agente de codificação de IA diretamente no seu terminal. Compreende o contexto da sua base de código, cria e edita arquivos, executa comandos seguros em uma sandbox e resolve tarefas arquitetônicas complexas em um único prompt. +
+ +--- + +## ⚡ Início Rápido + +### Instalação Instantânea (Foco em Offline e Sem Dependências) +Este fork faz o download de binários pré-compilados diretamente dos **GitHub Release Assets** (em vez dos servidores de API da Google). A instalação totalmente offline também é suportada se os arquivos necessários tiverem sido previamente carregados na pasta `packages/binaries/`. + +#### 🐧 Linux e 🍎 macOS +```bash +# Instalação via rede a partir do repositório do fork: +curl -fsSL https://raw.githubusercontent.com/weby-homelab/antigravity-cli/main/install.sh | bash + +# OU instalação offline a partir de um repositório local: +git clone https://github.com/weby-homelab/antigravity-cli.git +cd antigravity-cli +# (Opcional: baixe os arquivos da plataforma em packages/binaries/) +make install +``` + +#### 🪟 Windows PowerShell +```powershell +# Instalação via rede: +irm https://raw.githubusercontent.com/weby-homelab/antigravity-cli/main/install.ps1 | iex + +# OU instalação offline a partir de um repositório clonado: +.\install.ps1 +``` + +#### 🪟 Windows CMD +```cmd +# Instalação via rede: +curl -fsSL https://raw.githubusercontent.com/weby-homelab/antigravity-cli/main/install.cmd -o install.cmd && install.cmd && del install.cmd + +# OU instalação offline a partir de um repositório clonado: +install.cmd +``` + +--- + +## 📋 Recursos Principais + +> [!NOTE] +> Ao contrário da versão original, este fork é adaptado para uma operação estável em sessões headless/SSH e laboratórios domésticos locais. + +* 📂 **Edição de Múltiplos Arquivos** — Edita vários arquivos simultaneamente no seu espaço de trabalho com confirmação prévia das alterações. +* 🔒 **Comandos de Shell Seguros** — Executa qualquer comando de terminal no container Docker integrado (sandbox) ou no sistema host. +* 🧠 **Raciocínio em Várias Etapas (PAV)** — Constrói de forma independente um plano de execução de tarefas, testa o código e depura os seus próprios erros. +* 💾 **Histórico de Conversa Persistente** — Salva o contexto completo da conversa e o estado do espaço de trabalho entre as sessões. +* 🔌 **Sistema de Plugins** — Estenda as capacidades do agente com *habilidades (Skills)* personalizadas e servidores MCP (Model Context Protocol). + +--- + +## ⚙️ Configuração + +### 1. Configuração do Projeto (`GEMINI.md`) +Crie um arquivo `GEMINI.md` na raiz do seu projeto para fornecer contexto específico e regras de desenvolvimento ao agente de IA: + +```markdown +# Contexto do Projeto + +- Este projeto usa FastAPI e Pydantic v2. +- Sempre use `model_dump()` em vez do obsoleto `dict()`. +- REGRA ESTRITA: Sem senhas expostas no código (hardcoded). Importe todos os segredos do `.env`. +``` + +### 2. Configurações Globais (`~/.gemini/antigravity-cli/settings.json`) +O arquivo de configuração global controla as permissões de execução de ferramentas, scripts de statusline/título e servidores MCP: + +- **Linux/Unix**: `~/.gemini/antigravity-cli/settings.json` +- **macOS**: `~/Library/Application Support/antigravity-cli/settings.json` +- **Windows**: `%APPDATA%\antigravity-cli\settings.json` + +```json +{ + "toolPermission": "always-proceed", + "statusLine": { + "enabled": true, + "command": "/home/user/.gemini/antigravity-cli/statusline.sh" + }, + "title": { + "enabled": true, + "command": "/home/user/.gemini/antigravity-cli/title.sh" + }, + "mcpServers": { + "github": { + "command": "npx", + "args": ["-y", "@modelcontextprotocol/server-github"] + } + } +} +``` + +> [!TIP] +> Para obter uma linha de status avançada e responsiva com rastreamento de status Git em tempo real, medidores de tokens, cotas de modelos e estado de energia/batería, use o plugin **[Antigravity CLI Statusline (Max Edition)](https://github.com/weby-homelab/antigravity-cli-statusline)**. + + +### 3. Agentes Especializados +Você pode descrever funções e instruções personalizadas para agentes de IA no formato JSON. Cada agente deve ter seu próprio diretório contendo um arquivo `agent.json`: + +- **Agentes Globais (Linux/Unix)**: `~/.gemini/antigravity-cli/agents/{agent_name}/agent.json` +- **Agentes Globais (macOS)**: `~/Library/Application Support/antigravity-cli/agents/{agent_name}/agent.json` +- **Agentes Globais (Windows)**: `%APPDATA%\antigravity-cli\agents\{agent_name}\agent.json` +- **Agentes Locais (Espaço de Trabalho)**: `{workspace_root}/.agents/agents/{agent_name}/agent.json` + +```json +{ + "name": "security-reviewer", + "description": "Analisa o código em busca de vulnerabilidades antes do commit", + "instructions": "Verificar alterações para:\n- Vulnerabilidades OWASP Top 10\n- Vazamento de chaves de API ou segredos\n- Correção da configuração do firewall/nftables" +} +``` + +--- + +## 🔐 Métodos de Autenticação + +| Método | Comando / Variável | Limitações e Recursos | +| :--- | :--- | :--- | +| **Google Auth (Navegador)** | Automaticamente no primeiro `agy` | Login padrão. Limite gratuito: 60 req/min, 1000 req/dia | +| **Chave de API (Offline)** | `export GEMINI_API_KEY="X"` | Recomendado para servidores e automação | +| **Vertex AI** | `export GOOGLE_GENAI_USE_VERTEXAI=true` | Nível corporativo com infraestrutura em nuvem do Google Cloud | +| **Sair (Sign Out)** | `/logout` | Limpeza de tokens de sessão local | + +--- + +## 🔧 Referência de Comandos + +### Linha de Comando +```bash +agy # Iniciar uma sessão interativa +agy -p "Prompt" # Execução única sem entrar no chat +agy -c # Continuar a última conversa incompleta +agy --conversation+ English | 中文 | Español | Français | Português | Українська | Deutsch +
+ +
+
+
+ Ком'юніті-форк та покращена офлайн-версія google-antigravity/antigravity-cli з автоналаштуванням статуслайну та заголовка вікна +
+ +
+ 
+ 🤖 ШІ-кодинг агент прямо у вашому терміналі. Розуміє контекст вашої кодової бази, створює та редагує файли, виконує безпечні команди в пісочниці та вирішує комплексні архітектурні завдання за один промпт. +
+ +--- + +## ⚡ Швидкий старт + +### Миттєве встановлення (Offline-first & Zero-dependency) +Цей форк завантажує попередньо скомпільовані бінарні файли прямо з **GitHub Release Assets** (замість серверів Google API). Також підтримується повністю автономне офлайн-встановлення, якщо потрібні архіви було попередньо завантажено в папку `packages/binaries/`. + +#### 🐧 Linux та 🍎 macOS +```bash +# Мережеве встановлення з репозиторію форку: +curl -fsSL https://raw.githubusercontent.com/weby-homelab/antigravity-cli/main/install.sh | bash + +# АБО автономне офлайн-встановлення з локального репозиторію: +git clone https://github.com/weby-homelab/antigravity-cli.git +cd antigravity-cli +# (Опціонально: завантажте архіви платформ у packages/binaries/) +make install +``` + +#### 🪟 Windows PowerShell +```powershell +# Мережеве встановлення: +irm https://raw.githubusercontent.com/weby-homelab/antigravity-cli/main/install.ps1 | iex + +# АБО офлайн-встановлення з клонованого репозиторію: +.\install.ps1 +``` + +#### 🪟 Windows CMD +```cmd +# Мережеве встановлення: +curl -fsSL https://raw.githubusercontent.com/weby-homelab/antigravity-cli/main/install.cmd -o install.cmd && install.cmd && del install.cmd + +# АБО офлайн-встановлення з клонованого репозиторію: +install.cmd +``` + +--- + +## 📋 Основні можливості + +> [!NOTE] +> На відміну від оригінальної версії, цей форк адаптований для стабільної роботи в headless/SSH-сесіях та локальних home-лабораторіях. + +* 📂 **Мультифайлове редагування** — Редагує декілька файлів одночасно у вашому робочому просторі з попереднім підтвердженням змін. +* 🔒 **Безпечні Shell-команди** — Виконує будь-які термінальні команди у вбудованому Docker-контейнері (пісочниці) або на хост-системі. +* 🧠 **Багатокрокові міркування (PAV)** — Самостійно будує план виконання завдання, тестує код і виправляє власні помилки. +* 💾 **Постійна історія розмов** — Зберігає повний контекст розмови та стан робочого простору між сесіями. +* 🔌 **Система плагінів** — Розширюйте можливості агента за допомогою кастомних *Skills* та MCP-серверів (Model Context Protocol). + +--- + +## ⚙️ Конфігурація + +### 1. Конфігурація проєкту (`GEMINI.md`) +Створіть файл `GEMINI.md` у корені вашого проєкту, щоб передати ШІ-агенту специфічний контекст та правила розробки: + +```markdown +# Контекст проєкту + +- Цей проєкт використовує FastAPI та Pydantic v2. +- Завжди використовуйте `model_dump()` замість застарілого `dict()`. +- СУВОРЕ ПРАВИЛО: Жодних хардкод-паролів у коді. Всі секрети імпортувати з `.env`. +``` + +### 2. Глобальні налаштування (`~/.gemini/antigravity-cli/settings.json`) +Глобальний файл налаштувань керує дозволами на виконання інструментів, скриптами статуслайну/заголовка та MCP-серверами: + +- **Linux/Unix**: `~/.gemini/antigravity-cli/settings.json` +- **macOS**: `~/Library/Application Support/antigravity-cli/settings.json` +- **Windows**: `%APPDATA%\antigravity-cli\settings.json` + +```json +{ + "toolPermission": "always-proceed", + "statusLine": { + "enabled": true, + "command": "/home/user/.gemini/antigravity-cli/statusline.sh" + }, + "title": { + "enabled": true, + "command": "/home/user/.gemini/antigravity-cli/title.sh" + }, + "mcpServers": { + "github": { + "command": "npx", + "args": ["-y", "@modelcontextprotocol/server-github"] + } + } +} +``` + +> [!TIP] +> Для отримання просунутого та адаптивного статус-бару з відстеженням Git-статусу в реальному часі, лічильником токенів, квотами моделей та станом живлення/батареї, скористайтеся плагіном **[Antigravity CLI Statusline (Max Edition)](https://github.com/weby-homelab/antigravity-cli-statusline)**. + + +### 3. Спеціалізовані агенти +Ви можете описувати кастомні ролі та інструкції для ШІ-агентів у форматі JSON. Кожен агент повинен мати власну директорію, яка містить файл `agent.json`: + +- **Глобальні агенти (Linux/Unix)**: `~/.gemini/antigravity-cli/agents/{agent_name}/agent.json` +- **Глобальні агенти (macOS)**: `~/Library/Application Support/antigravity-cli/agents/{agent_name}/agent.json` +- **Глобальні агенти (Windows)**: `%APPDATA%\antigravity-cli\agents\{agent_name}\agent.json` +- **Локальні агенти (Робочий простір)**: `{workspace_root}/.agents/agents/{agent_name}/agent.json` + +```json +{ + "name": "security-reviewer", + "description": "Аналізує код на вразливості перед комітом", + "instructions": "Перевіряти зміни на:\n- OWASP Top 10 вразливості\n- Витік API ключів чи секретів\n- Правильність налаштування firewall/nftables" +} +``` + +--- + +## 🔐 Способи авторизації + +| Метод | Команда / Змінна | Обмеження та особливості | +| :--- | :--- | :--- | +| **Google Auth (Browser)** | Автоматично при першому `agy` | Стандартний вхід. Безкоштовний ліміт: 60 з/хв, 1000 з/добу | +| **API Key (Offline)** | `export GEMINI_API_KEY="X"` | Рекомендовано для серверів та автоматизації | +| **Vertex AI** | `export GOOGLE_GENAI_USE_VERTEXAI=true` | Enterprise-рівень з хмарною інфраструктурою Google Cloud | +| **Вихід з профілю** | `/logout` | Очищення локальних токенів сесії | + +--- + +## 🔧 Довідка команд + +### Командний рядок +```bash +agy # Запустити інтерактивну сесію +agy -p "Запит" # Одноразове виконання без входу в чат +agy -c # Продовжити останню незавершену розмову +agy --conversation+ English | 中文 | Español | Français | Português | Українська | Deutsch +
+ +
+
+
+ 社区分叉与硬化离线版 google-antigravity/antigravity-cli，支持状态栏和窗口标题的自动设置 +
+ +
+
+ 🤖 直接在您的终端中运行 of AI 编码智能体。理解您的代码库上下文，创建和编辑文件，在沙箱中执行安全命令，并在单个提示词中解决复杂的架构任务。 +
+ +--- + +## ⚡ 快速开始 + +### 即时安装（离线优先与零依赖） +此分叉版本直接从 **GitHub Release Assets**（而不是 Google API 服务器）下载预编译的二进制文件。如果预先将所需的归档文件加载到 `packages/binaries/` 文件夹中，则同样支持完全自治的离线安装。 + +#### 🐧 Linux 和 🍎 macOS +```bash +# 从分叉存储库进行网络安装： +curl -fsSL https://raw.githubusercontent.com/weby-homelab/antigravity-cli/main/install.sh | bash + +# 或者从本地存储库进行离线安装： +git clone https://github.com/weby-homelab/antigravity-cli.git +cd antigravity-cli +# （可选：将对应平台的归档文件下载到 packages/binaries/ 中） +make install +``` + +#### 🪟 Windows PowerShell +```powershell +# 网络安装： +irm https://raw.githubusercontent.com/weby-homelab/antigravity-cli/main/install.ps1 | iex + +# 或者从克隆的存储库进行离线安装： +.\install.ps1 +``` + +#### 🪟 Windows CMD +```cmd +# 网络安装： +curl -fsSL https://raw.githubusercontent.com/weby-homelab/antigravity-cli/main/install.cmd -o install.cmd && install.cmd && del install.cmd + +# 或者从克隆的存储库进行离线安装： +install.cmd +``` + +--- + +## 📋 核心功能 + +> [!NOTE] +> 与原始版本不同，此分叉版本经过特别优化，适用于无头（headless）环境、SSH 会话以及本地家庭实验室（Home Labs）中的稳定运行。 + +* 📂 **多文件编辑** — 在您的工作区中同时编辑多个文件，并在应用更改前进行确认。 +* 🔒 **安全 Shell 命令** — 在内置的 Docker 容器（沙箱）或主机系统上执行任意终端命令。 +* 🧠 **多步推理 (PAV)** — 独立构建任务执行计划，测试代码并调试自身的错误。 +* 💾 **持久化会话历史记录** — 在会话之间保存完整的对话上下文和工作区状态。 +* 🔌 **插件系统** — 使用自定义 *技能 (Skills)* 和 MCP（Model Context Protocol，模型上下文协议）服务器扩展智能体的能力。 + +--- + +## ⚙️ 配置方式 + +### 1. 项目配置 (`GEMINI.md`) +在项目的根目录下创建一个 `GEMINI.md` 文件，为 AI 智能体提供特定的项目上下文和开发规则： + +```markdown +# 项目上下文 + +- 本项目使用 FastAPI 和 Pydantic v2。 +- 请始终使用 `model_dump()` 代替已废弃的 `dict()`。 +- 严格规则：严禁在代码中硬编码任何密码。所有机密信息必须从 `.env` 文件导入。 +``` + +### 2. 全局设置 (`~/.gemini/antigravity-cli/settings.json`) +全局配置文件控制工具执行权限、状态栏/窗口标题脚本以及 MCP 服务器： + +- **Linux/Unix**: `~/.gemini/antigravity-cli/settings.json` +- **macOS**: `~/Library/Application Support/antigravity-cli/settings.json` +- **Windows**: `%APPDATA%\antigravity-cli\settings.json` + +```json +{ + "toolPermission": "always-proceed", + "statusLine": { + "enabled": true, + "command": "/home/user/.gemini/antigravity-cli/statusline.sh" + }, + "title": { + "enabled": true, + "command": "/home/user/.gemini/antigravity-cli/title.sh" + }, + "mcpServers": { + "github": { + "command": "npx", + "args": ["-y", "@modelcontextprotocol/server-github"] + } + } +} +``` + +> [!TIP] +> 如需具有实时 Git 状态跟踪、Token 计数器、模型配额以及电源/电池状态的高级响应式状态栏，请使用 **[Antigravity CLI Statusline (Max Edition)](https://github.com/weby-homelab/antigravity-cli-statusline)** 插件。 + + +### 3. 专业智能体 +您可以使用 JSON 格式定义 AI 智能体的自定义角色和说明。每个智能体必须有自己的目录，其中包含一个 `agent.json` 文件： + +- **全局智能体 (Linux/Unix)**: `~/.gemini/antigravity-cli/agents/{agent_name}/agent.json` +- **全局智能体 (macOS)**: `~/Library/Application Support/antigravity-cli/agents/{agent_name}/agent.json` +- **全局智能体 (Windows)**: `%APPDATA%\antigravity-cli\agents\{agent_name}\agent.json` +- **本地智能体 (项目工作区)**: `{workspace_root}/.agents/agents/{agent_name}/agent.json` + +```json +{ + "name": "security-reviewer", + "description": "在提交前分析代码漏洞", + "instructions": "检查更改内容：\n- OWASP Top 10 漏洞\n- API 密钥或凭证泄露\n- 防火墙/nftables 配置正确性" +} +``` + +--- + +## 🔐 身份验证方式 + +| 方法 | 命令 / 环境变量 | 限制与特点 | +| :--- | :--- | :--- | +| **Google 身份验证（浏览器）** | 首次运行 `agy` 时自动触发 | 标准登录。免费限制：60 次请求/分钟，1000 次请求/天 | +| **API 密钥（离线）** | `export GEMINI_API_KEY="X"` | 推荐用于服务器环境和自动化工作流 | +| **Vertex AI** | `export GOOGLE_GENAI_USE_VERTEXAI=true` | 企业级方案，使用 Google Cloud 云基础设施 | +| **注销登录** | `/logout` | 清除本地会话令牌 | + +--- + +## 🔧 常用命令参考 + +### 命令行工具 +```bash +agy # 启动交互式会话 +agy -p "提示词" # 单次执行，不进入聊天界面 +agy -c # 继续上一次未完成的对话 +agy --conversation+ English | 中文 | Español | Français | Português | Українська | Deutsch +
-Antigravity CLI understands your codebase, makes edits with your permission, and executes commands — right from your terminal. +
+
+
+ Official Docs · Official Website +
- ++ Community-Fork & Hardened Offline Version of google-antigravity/antigravity-cli with automatic statusline & window title setup +
---- - -Antigravity CLI brings the core capabilities of Antigravity 2.0 (multi-step reasoning, multi-file editing, tool calling, and persistent history) directly to your terminal. It is optimized for keyboard-driven workflows and remote SSH sessions with minimal resource overhead. - ---- +
+
+ 🤖 AI coding agent directly in your terminal. Understands the context of your codebase, creates and edits files, executes secure commands in a sandbox, and solves complex architectural tasks in a single prompt. +
--- -## Integration +## ⚡ Quick Start -- **Shared Agent Engine**: Both interfaces run on the same core agent engine. Improvements automatically apply to both. -- **Shared Settings**: Preferences and permissions sync bidirectionally. -- **Session Export**: Export terminal sessions to the Antigravity 2.0 GUI to continue working. - ---- +### Instant Installation (Offline-first & Zero-dependency) +This fork downloads precompiled binaries directly from **GitHub Release Assets** (instead of Google API servers). Completely offline installation is also supported if the required archives were preloaded into the `packages/binaries/` folder. -## Installation - -### macOS / Linux +#### 🐧 Linux and 🍎 macOS ```bash -curl -fsSL https://antigravity.google/cli/install.sh | bash +# Network installation from the fork repository: +curl -fsSL https://raw.githubusercontent.com/weby-homelab/antigravity-cli/main/install.sh | bash + +# OR offline installation from a local repository: +git clone https://github.com/weby-homelab/antigravity-cli.git +cd antigravity-cli +# (Optional: download platform archives to packages/binaries/) +make install ``` -### Windows PowerShell +#### 🪟 Windows PowerShell ```powershell -irm https://antigravity.google/cli/install.ps1 | iex +# Network installation: +irm https://raw.githubusercontent.com/weby-homelab/antigravity-cli/main/install.ps1 | iex + +# OR offline installation from a cloned repository: +.\install.ps1 ``` -### Windows CMD +#### 🪟 Windows CMD ```cmd -curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd +# Network installation: +curl -fsSL https://raw.githubusercontent.com/weby-homelab/antigravity-cli/main/install.cmd -o install.cmd && install.cmd && del install.cmd + +# OR offline installation from a cloned repository: +install.cmd ``` ## Usage @@ -59,27 +73,184 @@ agy --- -## Authentication +## 📋 Key Features -The CLI authenticates via the system keyring, falling back to Google Sign-In if no active session exists. +> [!NOTE] +> Unlike the original version, this fork is adapted for stable operation in headless/SSH sessions and local home labs. -- **Local**: Automatically opens your default browser. -- **Remote / SSH**: Detects SSH sessions and prints an authorization URL to complete login locally. -- **Sign Out**: Run `/logout` to clear saved credentials. +* 📂 **Multi-file Editing** — Edits multiple files simultaneously in your workspace with prior confirmation of changes. +* 🔒 **Secure Shell Commands** — Executes any terminal commands in the built-in Docker container (sandbox) or on the host system. +* 🧠 **Multi-step Reasoning (PAV)** — Independently builds a task execution plan, tests code, and debugs its own errors. +* 💾 **Persistent Conversation History** — Saves the complete conversation context and workspace state between sessions. +* 🔌 **Plugin System** — Extend the agent's capabilities with custom *Skills* and MCP (Model Context Protocol) servers. -> [!NOTE] -> For enterprise access, connect your GCP project during onboarding. See the Enterprise page for details. +--- + +## ⚙️ Configuration + +### 1. Project Configuration (`GEMINI.md`) +Create a `GEMINI.md` file in the root of your project to provide specific context and development rules to the AI agent: + +```markdown +# Project Context + +- This project uses FastAPI and Pydantic v2. +- Always use `model_dump()` instead of the deprecated `dict()`. +- STRICT RULE: No hardcoded passwords in code. Import all secrets from `.env`. +``` + +### 2. Global Settings (`~/.gemini/antigravity-cli/settings.json`) +The global settings file controls tool execution permissions, statusline/title scripts, and MCP servers: + +- **Linux/Unix**: `~/.gemini/antigravity-cli/settings.json` +- **macOS**: `~/Library/Application Support/antigravity-cli/settings.json` +- **Windows**: `%APPDATA%\antigravity-cli\settings.json` + +```json +{ + "toolPermission": "always-proceed", + "statusLine": { + "enabled": true, + "command": "/home/user/.gemini/antigravity-cli/statusline.sh" + }, + "title": { + "enabled": true, + "command": "/home/user/.gemini/antigravity-cli/title.sh" + }, + "mcpServers": { + "github": { + "command": "npx", + "args": ["-y", "@modelcontextprotocol/server-github"] + } + } +} +``` + +> [!TIP] +> For an advanced, responsive statusline with real-time Git status, token meters, model quotas, and power/battery state, check out the **[Antigravity CLI Statusline (Max Edition)](https://github.com/weby-homelab/antigravity-cli-statusline)** plugin. + + +### 3. Specialized Agents +You can describe custom roles and instructions for AI agents in JSON format. Each agent must have its own directory containing an `agent.json` file: + +- **Global Agents (Linux/Unix)**: `~/.gemini/antigravity-cli/agents/{agent_name}/agent.json` +- **Global Agents (macOS)**: `~/Library/Application Support/antigravity-cli/agents/{agent_name}/agent.json` +- **Global Agents (Windows)**: `%APPDATA%\antigravity-cli\agents\{agent_name}\agent.json` +- **Local Agents (Project Workspace)**: `{workspace_root}/.agents/agents/{agent_name}/agent.json` + +```json +{ + "name": "security-reviewer", + "description": "Analyzes code for vulnerabilities before commit", + "instructions": "Check changes for:\n- OWASP Top 10 vulnerabilities\n- Leakage of API keys or secrets\n- Correctness of firewall/nftables configuration" +} +``` --- -## Terms of Service & Data Use +## 🔐 Authentication Methods + +| Method | Command / Variable | Limitations & Features | +| :--- | :--- | :--- | +| **Google Auth (Browser)** | Automatically on first `agy` | Standard login. Free limit: 60 req/min, 1000 req/day | +| **API Key (Offline)** | `export GEMINI_API_KEY="X"` | Recommended for servers and automation | +| **Vertex AI** | `export GOOGLE_GENAI_USE_VERTEXAI=true` | Enterprise level with Google Cloud cloud infrastructure | +| **Sign Out** | `/logout` | Clearing local session tokens | + +--- + +## 🔧 Command Reference + +### Command Line +```bash +agy # Start an interactive session +agy -p "Prompt" # One-time execution without entering chat +agy -c # Continue the last incomplete conversation +agy --conversation