GnosysLabs/GitHop
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Install portable agent-neutral Hop skill and documentation

Browse Source 
Hop-State: A_06FN69X2VW0BAXG4A4DT6V0
Hop-Proposal: R_06FN69VET1STZNKPWK913K8
Hop-Task: T_06FN637799RW5Q7WH9H6PJR
Hop-Attempt: AT_06FN63779BJRBK1VFQ94GRR
This commit is contained in:
Hop
2026-07-11 14:48:54 -07:00
parent 2f00b2dd3f
commit 68d8bf2f7d
20 changed files with 649 additions and 124 deletions
Download Patch File Download Diff File Expand all files Collapse all files
wiki/Installation.md
+19 -8
View File
@@ -16,7 +16,11 @@ The installer:
3. downloads `checksums.txt` and verifies SHA-256 before extraction;
4. installs the CLI to `~/.local/bin/hop`;
5. adds `~/.local/bin` to `.zprofile` or `.profile` when necessary; and
6. runs `hop skill install --force` for Codex.
6. runs `hop skill install --force` to install the bundled agent integration.
The no-path skill command writes the same Hop-managed skill files to
`~/.agents/skills/hop` and `${CODEX_HOME:-~/.codex}/skills/hop`. The second path
supports Codex Desktop; compatible clients can use the shared `.agents` path.
Review before execution:
@@ -32,7 +36,7 @@ Installer options are environment variables:
|---|---|---|
| `HOP_VERSION` | `latest` | Release tag such as `v0.1.0` |
| `HOP_INSTALL_DIR` | `~/.local/bin` | Binary destination |
| `HOP_INSTALL_SKILL` | `1` | Set to `0` to skip Codex skill installation |
| `HOP_INSTALL_SKILL` | `1` | Set to `0` for a CLI-only or custom integration |
| `HOP_MODIFY_PATH` | `1` | Set to `0` to leave shell profiles unchanged |
| `HOP_GITEA_URL` | `https://githop.xyz` | Gitea instance base URL |
| `HOP_REPOSITORY` | `GnosysLabs/Hop` | Alternate Gitea owner/repository |
@@ -52,15 +56,15 @@ irm https://githop.xyz/GnosysLabs/Hop/raw/branch/main/scripts/install.ps1 | iex
```
The script verifies the Windows archive, installs to
`%LOCALAPPDATA%\Programs\Hop`, updates the user PATH, and installs the Codex
skill. To pin a version after downloading the script:
`%LOCALAPPDATA%\Programs\Hop`, updates the user PATH, and installs the shared and
Codex-compatible skill bundles. To pin a version after downloading the script:
```powershell
.\install.ps1 -Version v0.1.0
```
Use `-SkipSkill` only when another agent runtime will receive the skill. Use
`-SkipPath` when another tool manages your PATH.
Use `-SkipSkill` for a CLI-only or separately managed integration. Use `-SkipPath`
when another tool manages your PATH.
## Go install
@@ -71,7 +75,8 @@ go install githop.xyz/GnosysLabs/Hop/cmd/hop@latest
hop skill install --force
```
Put `$(go env GOPATH)/bin` on PATH if `hop` is not found.
Put `$(go env GOPATH)/bin` on PATH if `hop` is not found. The second command
installs both default skill bundles; omit it for a CLI-only installation.
## Build from source
@@ -87,6 +92,12 @@ install -m 755 hop "$HOME/.local/bin/hop"
Source builds are intended for contributors and as a pre-release fallback.
To install only one compatible runtime target, pass its parent skills directory:
```bash
hop skill install --path /path/to/agent/skills --force
```
## Verify
```bash
@@ -95,5 +106,5 @@ hop help
git --version
```
If Codex Desktop was open during installation, restart it. See
Restart any agent client that was open while its skill bundle changed. See
[Getting started](Getting-Started) next.