🚀 Overview
ggsrun is an enterprise-grade CLI application and Model Context Protocol (MCP) Server designed to relentlessly orchestrate Google Drive I/O operations and statefully execute Google Apps Script (GAS) natively from your local terminal or via autonomous Large Language Model (LLM) agents.
Built on Go 1.26.4+, ggsrun transitions legacy single-threaded processing into a state-of-the-art, channel-based concurrent streaming architecture. It delivers maximum network throughput, native Shared Drives (Omni-Drive) support, advanced MIME resolution, resilient self-healing retries, and a native Security Sandbox to restrict Google Workspace APIs during autonomous executions.
🗺️ Documentation Directory Index
To make onboarding, development, and advanced operations as seamless as possible, our documentation is fully modularized. Navigate directly to your area of interest:
| Guide / Manual | Description | Link |
|---|---|---|
| 🚀 Setup & Onboarding Guide | Step-by-step instructions to configure GCP, generate OAuth2 client secrets, link Google Apps Script, and deploy gateway endpoints. | Setup Guide |
| 📖 Command Reference Manual | In-depth breakdown of all 15+ subcommands (e.g. exe1, exe2, download, upload), recipes, and Mermaid architectural diagrams. |
Command Reference |
| 🛡️ Security Sandbox Guide | Explains the memory-based wrapper injection, whitelist configuration schemas (sandbox_config.json), and security validation scenarios. |
Sandbox Guide |
| 🔄 Stateful Execution Lifecycle | Deep-dive explanation of the backup, sandboxing, upload, execution, and resilient rollback phases of the exe1 command. |
Execution Lifecycle |
| 🤖 MCP Server Guide | Configuration to run ggsrun as an autonomous tool provider in AI environments (like Claude Desktop or Antigravity), schemas, and scenarios. |
MCP Server Guide |
| 💻 Interactive TUI Filer Guide | All keyboard shortcuts, search highlighter rules, clipboard integration, and history for the split-screen Japanese PC-98 Filer Mode (ggsrun fd). |
TUI Filer Guide |
| 🧪 Local Development & Testing | Detailed guide for configuring environment variables (.env), understanding CLI/TUI mock tests, and running automated test suites. |
Development Guide |
| 🔬 Manual Integration Tests Suite | Guided verification commands to manually test authorization, sandbox policies, tool schemas, and local file operations. | Manual Tests Suite |
| 📚 Detailed User Manual | Comprehensive manual detailing all commands, advanced options, custom editor integrations (Sublime Text), and legacy parameters. | Detailed Manual |
| 📜 Version Update History | Chronological record of all updates, bug fixes, features, and refactoring milestones from v1.0.0 to the latest release. | Update History |
No comments yet.