Documentation
Getting Started
Install GRID, configure your AI environment, and start building in minutes.
Installation
Mobile Companion
Monitor builds and manage agents from your phone.
Command Line Interface
Prefer the terminal? Install the GRID CLI to run AI-assisted commands, manage projects, and automate workflows.
View CLI Installation Guide →Installation Notes (Unsigned Code)
GRID releases are not yet code-signed. Your operating system may show a warning. Here's how to bypass:
- • SmartScreen warning → Click "More info" → "Run anyway"
- • If blocked: Right-click the installer → Properties → Check "Unblock"
- • Gatekeeper warning → Open System Settings → Privacy & Security → "Open Anyway"
- • Or run in Terminal:
xattr -d com.apple.quarantine /Applications/GRID.app
- • Make AppImage executable:
chmod +x GRID-*.AppImage - • Then run:
./GRID-*.AppImage
Running GRID
Launch the application and sign in with your account to sync your settings.
➜ ~ Launch GRID...
info Initializing environment (v1.0.0)
info Connecting to AI Gateway...
success Ready to build.
AI Provider Setup
To unlock the full power of GRID, you need to configure at least one AI provider.
| Provider | Best For | Setup |
|---|---|---|
| Anthropic (Claude) | Complex reasoning & code gen | Settings > AI > Anthropic |
| OpenAI (GPT-4) | General purpose | Settings > AI > OpenAI |
| Ollama | Local, private, free | Run `ollama serve` |
Project Configuration
To get the most out of GRID's AI features, create these configuration files in your project root. They help the AI understand your project context and coding standards. Learn more in the Project Rules guide.
.gridrulesRequiredDefine project-specific rules and preferences for the AI. Similar to .cursorrules or IDE-specific rule files.
# Example .gridrules
- Use TypeScript strict mode
- Prefer functional components with hooks
- Always use async/await over .then()
- Write JSDoc comments for public APIs
grid.mdRecommendedA markdown file describing your project architecture, conventions, and context. Similar to .cursorrules or project README files for AI context.
# Example grid.md
## Project Overview
This is a Next.js 14 app with a PostgreSQL backend...
## Tech Stack
- Frontend: React, TailwindCSS
- Backend: PostgreSQL, Edge Functions
.gridignoreOptionalExclude specific files or directories from AI analysis and Auto-Debug. Works just like .gitignore.
# Example .gridignore
node_modules/
dist/
*.env
Pro Tip: Ask the AI chat to "create a .gridrules and grid.md for this project" and it will generate them based on your codebase!