Skip to content

About

One-click GitHub repo installer — plan, clone, deps, dev run — packaged as agent skills & plugins for Claude, Cursor, Codex, Hermes & more.

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

English | 简体中文

GInstall OneClick — One-click installation of GitHub projects

One-line pitch: GInstall OneClick — Markdown skills and plugin bundles so coding agents can drive GInstall for one-click-style GitHub Node setups (plan → clone → deps → dev) across Claude Code, OpenClaw-style hosts, Codex, Cursor, and Hermes.

Agent-facing packaging for GInstall: a CLI that plans, clones, installs dependencies, and runs typical dev scripts for GitHub Node.js repositories — i.e. one-click installation of GitHub projects when wired through agents or automation.

This repository ships only skills and plugin-style bundles (Markdown + manifests). It does not include the TypeScript CLI (src/, installer package.json). Install or build ginstall from the CLI repository first, then copy these files into your agent host.


Distribution shapes

Shape Purpose Location in this repo
Skill Condensed workflow — low token use, essentials only skill/ginstall/SKILL.md
Plugin bundle Full instructions + /ginstall (or host equivalent) where commands are supported bundles/

Bundles by host

Host Path Contents
Claude Code / OpenClaw-compatible bundles/claude-ginstall/ skills/ginstall/SKILL.md (includes OpenClaw metadata.requires.bins), commands/ginstall.md
Codex bundles/codex-ginstall/ .codex-plugin/plugin.json + skills/ginstall/SKILL.md
Cursor bundles/cursor-ginstall/ .cursor-plugin/plugin.json, skills/, .cursor/commands/ginstall.md
Hermes Agent hermes/README.md Copy instructions for ~/.hermes/skills/ginstall/

Map these directories into each product’s documented skills / plugins / commands paths (vendor layouts change over time).


Quick install (examples)

Paths are relative to this repo root after clone.

Condensed skill

cp skill/ginstall/SKILL.md <your-skills-dir>/ginstall/SKILL.md

Claude-style bundle

cp -r bundles/claude-ginstall/skills/ginstall <your-claude-skills-root>/ginstall
cp bundles/claude-ginstall/commands/ginstall.md <your-commands-root>/ginstall.md

Hermes — see hermes/README.md.

Codex — copy all of bundles/codex-ginstall/ into Codex’s local plugin directory (keep .codex-plugin/plugin.json).

Cursor — copy all of bundles/cursor-ginstall/ into Cursor’s plugin directory.


CLI prerequisites & reminders

  • Private GitHub: set GITHUB_TOKEN before clone/raw fetch.
  • Monorepos: URL must include /tree/<branch>/<subpath> when the package is not at repo root.
  • Non-interactive: --yes, CI=true, or GINSTALL_NON_INTERACTIVE.

Full flags table: bundles/claude-ginstall/skills/ginstall/SKILL.md (same table in Codex/Cursor bundle skills).


Roadmap

Local installer + minimal browser UI on port 9527: ROADMAP-LOCAL-UI.md (planned only).


License

MIT — see LICENSE.


Security

This repo is documentation-only; agents plus the separate GInstall CLI introduce real execution risk (tokens, untrusted repos, hostile package.json scripts). See SECURITY.md.

About

One-click GitHub repo installer — plan, clone, deps, dev run — packaged as agent skills & plugins for Claude, Cursor, Codex, Hermes & more.

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors