termix-antigravity

Termix CLI Skill for the Google Antigravity Agent Harness Manage and automate remote servers, SSH, SFTP, Docker containers, fleets, and tunnels using the Termix CLI (termix).

⚡ Quick Start

Install the Termix CLI skill directly into your current workspace's Antigravity harness:

npx termix-antigravity

Or install globally so all Antigravity agent sessions can access it:

npx termix-antigravity --global

🎯 What is Termix CLI on Antigravity?

Termix CLI (termix) enables command-line and automated interaction with Termix-managed SSH infrastructure.

Equipping your Antigravity agent with the Termix skill allows the agent to:

• 💻 Remote Command Execution: Run non-interactive commands over SSH (termix exec <hostId> <command...>).
• 📁 File Management over SFTP: Transfer, inspect, and synchronize remote files (termix files ls/cat/get/put/rm).
• 🐳 Remote Docker Control: Inspect container health and manage container lifecycles (termix docker ps/logs/restart/stop).
• 🚀 Fleet-Wide Orchestration: Execute batch commands across server fleets (termix fleets exec <fleetId> <cmd...>).
• 🔒 Credentials & Tunnels: Manage stored credentials, key vaults, and SSH port forwarding tunnels (termix tunnel list/start/stop).

💻 CLI Usage & Flags

# Default: Installs skill into .agents/skills/termix-cli in current directory
npx termix-antigravity

# Global install: Installs into ~/.gemini/config/skills/termix-cli
npx termix-antigravity --global

# Multi-harness install: Installs to Antigravity (.agents), Claude (.claude), and global
npx termix-antigravity --all

# Custom directory install:
npx termix-antigravity --target ./my-custom-skills/termix-cli

# Preview the SKILL.md in the terminal:
npx termix-antigravity --view

# List all included skill files, references, and scripts:
npx termix-antigravity --list

# Simulate installation (dry run):
npx termix-antigravity --dry-run

📂 Included Skill Structure

When installed into your harness (.agents/skills/termix-cli/), the skill includes:

.agents/skills/termix-cli/
├── SKILL.md                          # Main Termix CLI Agent Guide
├── references/
│   ├── commands.md                   # Full CLI command syntax, flags & options
│   ├── auth-and-config.md            # Environment variables, API keys & sessions
│   ├── scripting-and-json.md         # JSON recipes, jq parsing & exit codes
│   └── troubleshooting.md            # Error codes, lock states & resolutions
└── examples/
    ├── server-diagnostics.sh         # Ready-to-run automated diagnostic script
    └── fleet-orchestration.sh        # Multi-server update script

🛠️ Programmatic Node.js API

const { installSkill, getSkillContent, getSkillMetadata } = require('termix-antigravity');

// Inspect skill frontmatter
console.log(getSkillMetadata());

// Install skill into custom path
installSkill({ targetDir: './.agents/skills/termix-cli' });

🚀 Publishing to NPM

# 1. Verify package files
npm pack --dry-run

# 2. Publish to npm registry
npm publish --access public

📄 License

MIT © 2026. Designed for Google Antigravity & AI Agent Ecosystems.