Documentation
Install githook, link your wallet, publish your first skill, earn tips. Everything you need in one page.
01 · quickstart
Five minutes, five steps.
From no GitHook to your first skill earning tips. You need an EVM wallet on Base and ~$0.10 of 
$ETH for gas.
01
install githook CLI
curl -fsSL https://githook.ai/install.sh | sh02
start githook
githook03
connect your wallet
/wallet link04
create & push a skill
/skill new my-skill && /skill push05
receive tips
/tips02 · install
Install githook CLI.
macOS / Linux — paste in Terminal
bash
$ curl -fsSL https://githook.ai/install.sh | sh
→ downloading githook binary...
✓ githook installed to /usr/local/bin/githook
Auto-updates on startup. Re-run any time to force upgrade.
what's included
✓Free forever — no API keys, no credit card
✓Premium coding on Claude Opus 4.7 — model bill on us
✓File editing, code execution, git integration
✓Skill marketplace integration
Windows (via WSL2)
wsl --install && curl -fsSL https://githook.ai/install.sh | sh03 · command reference
All githook commands.
live implemented and shippedphase 2 planned after $GITHOOK launch
Wallet & Identity
| Command | What it does | Status |
|---|---|---|
/wallet | Show wallet status, DID, and session info | live |
/wallet link | Connect wallet via browser (WalletConnect, MetaMask, Coinbase) | live |
/wallet balance | Check $ETH balance on Base | live |
Skills — Create & Publish
| Command | What it does | Status |
|---|---|---|
/skill new <name> | Create SKILL.md template in a new directory | live |
/skill validate [path] | Validate SKILL.md manifest (local lint) | live |
/skill push [path] | Publish skill to GitHook marketplace (signed request) | live |
/skill list | List your published skills | live |
Skills — Browse & Install
| Command | What it does | Status |
|---|---|---|
/skills | Browse skills in the marketplace | live |
/skills install <author/name> | Install a skill from the marketplace | live |
Tips & Earnings
| Command | What it does | Status |
|---|---|---|
/tip <author/skill> <amount> | Tip a skill creator in $ETH (100% to creator, 0% protocol fee) | live |
/tip-confirm <tx-hash> | Confirm a tip transaction on-chain | live |
/tips | View your tip history (sent/received) | live |
Chat & Session
| Command | What it does | Status |
|---|---|---|
/clear | Clear conversation history | live |
/save [name] | Save current conversation | live |
/load [name] | Load a saved conversation | live |
/retry | Retry the last message | live |
Git Integration
| Command | What it does | Status |
|---|---|---|
/commit [message] | Commit staged changes (AI-generated message if omitted) | live |
/diff | Show unstaged changes | live |
/status | Show git status | live |
Settings & Info
| Command | What it does | Status |
|---|---|---|
/settings | Open settings menu | live |
/model | Change AI model | live |
/provider | Change AI provider | live |
/usage | View token usage and cost stats | live |
/about | About GitHook platform | live |
/help | Show all available commands | live |
/exit | Quit githook | live |
File References
| Command | What it does | Status |
|---|---|---|
@file.ts | Include file content in your message | live |
@folder/ | Include folder structure | live |
@file.ts:10-20 | Include specific lines (10-20) | live |
Node Operator (Phase 2 — after $GITHOOK launch)
| Command | What it does | Status |
|---|---|---|
githook node register --stake <amount> | Register a node on NodeStaking.sol | phase 2 |
githook node status | Check stake, tier, uptime, pending rewards | phase 2 |
githook node claim | Claim accumulated rewards ($ETH) | phase 2 |
04 · SKILL.md format
Anatomy of a skill.
SKILL.md
---
name: code-reviewer
title: Code Reviewer Pro
version: 1.0.0
author: alice
license: MIT
description: Reviews code for bugs
category: development
tags:
- code-review
- security
tip_enabled: true
---
# Code Reviewer Pro
You are an expert code reviewer...
Required fields
name— unique identifier (lowercase, dashes)title— display nameversion— semver (1.0.0)author— your usernamedescription— one-line summarycategory— development, writing, etc.
Optional fields
license— defaults to MITtags— array for discoverytip_enabled— true by defaultpermissions— fs:read, net:fetch, etc.
Note:
wallet is automatically set from your linked wallet when you push.05 · FAQ
Frequent questions.
What is githook?▶
githook is an AI code assistant that runs in your terminal. It's free forever — no API keys, no credit card — with premium coding on Claude Opus 4.7 covered server-side, and it integrates with the GitHook skill marketplace.
Do I need crypto experience?▶
Just an EVM wallet (MetaMask, Rabby, Coinbase Wallet) and a small amount of $ETH on Base for gas (~$0.01 per tip). Wallet linking happens via browser — no complex setup.
Does GitHook take a cut of tips?▶
No. Tips are a plain wallet-to-wallet $ETH transfer on Base — straight from the tipper to the creator. There's no contract in between and no protocol fee, so 100% of every tip lands in the creator's wallet. GitHook only provides the page.
How do I get paid for my skills?▶
When someone tips your skill, 100% of it is sent directly from their wallet to yours in the same transaction, on Base. No middleman, no fee, no waiting on a payout.
Can I use githook without publishing skills?▶
Absolutely. githook is a full-featured AI code assistant. You can use it to chat, edit code, run commands, and more — without ever publishing a skill or connecting a wallet.
What if GitHook disappears?▶
The CLI is MIT-licensed and open source, and tips are direct wallet-to-wallet $ETH transfers — they never depend on GitHook's servers. Your skills live on, and your earnings always go straight to your wallet.
How does the security review work?▶
Every skill push runs through a security scanner (30+ patterns) and AI moderator. Critical findings reject immediately. Skills with high trust scores can be auto-approved; others go to admin review.