Installation Guide¶
ExtraSuite supports multiple AI coding assistants and operating systems. Choose the guide that matches your setup.
Supported Platforms¶
AI Agents¶
| Platform | Status | Installation Guide |
|---|---|---|
| Claude Code | Supported | View Guide |
| Codex CLI | Supported | View Guide |
| Gemini CLI | Supported | View Guide |
| Claude Coworks | Supported | View Guide |
| Cursor | Supported | View Guide |
Operating Systems¶
| OS | Installation Method |
|---|---|
| macOS | curl \| bash |
| Linux | curl \| bash |
| Windows (PowerShell) | irm \| iex - View Guide |
| Windows (WSL) | curl \| bash - View Guide |
Universal Install Process¶
Regardless of which AI agent you use, the installation process is the same:
Step 1: Sign In to ExtraSuite¶
Visit extrasuite.think41.com and sign in with your Google Workspace account.
Step 2: Copy Your Install Command¶
After signing in, you'll see a personalized install command. The command includes a token that:
- Is unique to your account
- Is valid for 5 minutes
- Installs the skill for all supported AI agents at once
Step 3: Run the Command¶
Step 4: Verify Installation¶
The installer will confirm which skills were installed and where.
What Gets Installed¶
The installer creates skill files in the standard locations for each AI agent:
| Agent | Skill Location |
|---|---|
| Claude Code | ~/.claude/skills/gsheets/ |
| Codex CLI | ~/.codex/skills/gsheets/ |
| Gemini CLI | ~/.gemini/skills/gsheets/ |
| Cursor | ~/.cursor/skills/gsheets/ |
Each skill directory contains:
SKILL.md- Instructions for the AI agentchecks.py- Environment verification scriptverify_access.py- Spreadsheet access verificationgsheet_utils.py- Utility functionsrequirements.txt- Python dependencies
Troubleshooting¶
Token Expired¶
If you see an error about an invalid or expired token, refresh the ExtraSuite homepage to get a new install command.
Permission Denied¶
On macOS/Linux, you may need to ensure curl has execute permissions:
Firewall Issues¶
Make sure your firewall allows HTTPS connections to extrasuite.think41.com.
Multiple Agents¶
The install script automatically detects and installs for all supported agents on your system. If you only want to install for specific agents, see the platform-specific guides.
Choose your platform for detailed instructions: