Installation
Gravity ships as a single portable .exe (Windows) or AppImage (Linux). No installer required.
Windows
- Download
Gravity.exefrom the releases page - Place in a folder of your choice (e.g.,
C:\Tools\Gravity\) - Optional: Add folder to
PATHfor globalgravitycommand
Linux
- Download
Gravity.AppImage - Make executable:
chmod +x Gravity.AppImage - Run:
./Gravity.AppImage
Note: Windows Defender may flag the unsigned executable on first run. Click "More info" → "Run anyway".
First Run
Launch Gravity.exe. On first start:
- License prompt appears — Enter your license key or start 7-day trial
- Workspace selector — Choose or create a workspace folder (stores config, knowledge base, indexes)
- Theme selection — Light / Dark / System (persisted)
- Agent onboarding — Quick tour of the agent panel (optional)
After setup, the main window opens with:
- Agent Chat — Central command interface (natural language)
- File Explorer — Workspace tree with git status badges
- Terminal — Integrated shell (PowerShell / Bash / CMD)
- Output / Problems — Roslyn diagnostics, build output, test results
License Activation
Gravity uses a per-seat license model. Trial: 7 days, full features.
| Tier | Seats | Support | Updates |
|---|---|---|---|
| Trial | 1 | Community | 7 days |
| Pro | 1 | Email (48h) | 1 year |
| Team | 5+ | Priority (24h) | 1 year |
| Enterprise | Unlimited | SLA + Slack | Perpetual |
Activate via Help → Enter License Key or CLI: gravity license activate <key>
UI Overview
| Region | Shortcut | Purpose |
|---|---|---|
| Agent Chat | Ctrl+L | Natural language commands, code gen, analysis |
| File Explorer | Ctrl+Shift+E | Workspace navigation, git status, search |
| Terminal | Ctrl+` | Integrated shell, task runners |
| Command Palette | Ctrl+Shift+P | Fuzzy search all commands |
| Quick Open | Ctrl+P | Fuzzy file open |
All panels are dockable, resizable, and persist layout per workspace.