GInstall OneClick — GitHub installer
You help the user run GInstall OneClick (ginstall) — a CLI that one-click installs GitHub projects (typically Node.js): generate a plan, clone, install dependencies, and start a dev-oriented script.
When to trigger
- User pastes
owner/repo, a fullgithub.comURL, or a monorepo/tree/<branch>/<subpath>URL. - User asks to “install this repo”, “clone and run dev”, or
/ginstall-style wording.
Prerequisites
ginstallavailable on PATH (install from the upstream GInstall / GInstall OneClick CLI project).nodeandgiton PATH (declared in skill metadata).
Procedure
- Normalize URL — accept
owner/repo,owner/repo@branch, fullgithub.comURLs,/tree/<branch>/<subpath>for monorepos. - Secrets — for private repos or 401/403/404 on fetch/clone, tell the user to set
GITHUB_TOKEN(minimumcontents:read), then retry. Never paste tokens into chat or save them into shared plan files. - Run
ginstallwith quoted repo URL — prefer:
ginstall "<repo-url>" --mode guided --env-mode scan
CI / non-interactive:
ginstall "<repo-url>" --yes --mode assisted --env-mode scan
Plan-only (no execute):
ginstall "<repo-url>" --mode manual --env-mode plan
- After run — point the user to printed plan Markdown and report paths from the CLI output.
Flags reference
| Flag / env | Role |
|---|---|
--yes, CI, GINSTALL_NON_INTERACTIVE, GINSTALL_YES |
Non-interactive; auto-approve steps |
--mode / GINSTALL_MODE |
manual | guided | assisted | auto |
--env-mode / GINSTALL_ENV_MODE |
manual | scan | plan |
--run-timeout / GINSTALL_RUN_TIMEOUT |
Dev/run step cap (seconds) |
--work-dir / -w |
Workspace root for clone + logs |
GITHUB_TOKEN |
Private GitHub + authenticated HTTPS clone |
Verification
- Plan includes clone, install, run with correct
workingDir(monorepo subpath when applicable). - Warn on engines.node mismatch, optional native toolchain for packages like
sharp.
Usage examples (ClawHub)
-
Interactive: User says “Install https://github.com/microsoft/TypeScript locally with GInstall.” → run
ginstall "https://github.com/microsoft/TypeScript" --mode guided --env-mode scan -
Monorepo: User provides
https://github.com/org/mono/tree/main/packages/app→ quote the full tree URL inginstall "<url>". -
Automation: User wants CI setup with no prompts →
ginstall "owner/repo" --yes --mode assisted --env-mode scan
Upstream CLI
This file is the OpenClaw skill only. Install or build ginstall from the GInstall OneClick CLI repository:
