SherpaBuild the right thing. Prove it works. Show why it matters.

A portable AI mentor with client-specific skill and command integrations for hackathon teams.

curl -fsSL https://github.com/Anshkaliya18/Sherpa/releases/download/v2.0.0/install.sh | bash

Sherpa 2.0.8 adds generated client distributions and a managed installer. Check release availability and compatibility notes before installing.

A good guide helps you choose a route, checks the weather, and leaves the decisions with you. Sherpa brings that rhythm to a hackathon build.

Route to the summit

Base CampDiscover the problem and compare ideas/sherpa-suggest
Camp 1Choose a feasible plan/sherpa-plan
Camp 2Build in small, reviewable steps/sherpa-build
Camp 3Verify behavior and review risks/sherpa-verify
High CampShape a clear, evidence-backed demo/sherpa-demo
SummitPrepare a complete submission/sherpa-submission

Find a command

Filter by stage Find a command

28 commands

/sherpa-statusCORE
Show evidence-backed project status.
/sherpa-nextCORE
Identify the single highest-priority next action.
/sherpa-helpCORE
List implemented sherpa commands and limitations.
/sherpa-initCORE
Initialize project-local sherpa state safely.
/sherpa-phaseCORE
Show current lifecycle phase and evidence.
/sherpa-configCONFIGURATION
Show a redacted project configuration overview.
/sherpa-config-checkCONFIGURATION
Validate project configuration and secret protections.
/sherpa-suggestINTELLIGENCE
Discover, evaluate, and red-team idea candidates; human selection required.
/sherpa-evaluateINTELLIGENCE
Evaluate and compare candidate ideas with evidence.
/sherpa-compareINTELLIGENCE
Compare candidate ideas using the existing idea-evaluation workflow.
/sherpa-redteamINTELLIGENCE
Challenge project assumptions and readiness using the red-team workflow.
/sherpa-optimizeINTELLIGENCE
Prioritize score-improving work against evidence and criteria.
/sherpa-judge-meINTELLIGENCE
Simulate judge perception using the judge-simulation workflow.
/sherpa-repoENGINEERING
Inspect repository evidence as part of project planning.
/sherpa-architectureENGINEERING
Plan architecture from the selected idea and repository evidence.
/sherpa-techstackENGINEERING
Assess technology choices within the project plan.
/sherpa-planENGINEERING
Create an implementation-ready project plan.
/sherpa-buildENGINEERING
Execute an approved implementation task using the existing implementation workflow.
/sherpa-verifyENGINEERING
Verify implementation through the existing testing and security workflow.
/sherpa-testENGINEERING
Test implemented scope using the testing and security workflow.
/sherpa-securityENGINEERING
Review security using the testing and security workflow.
/sherpa-uxENGINEERING
Review product usability and accessibility readiness.
/sherpa-accessibilityPRODUCT QUALITY
Review accessibility within the existing UX-review scope.
/sherpa-demoFINALIZATION
Prepare an evidence-backed judge-oriented demo plan.
/sherpa-auditFINALIZATION
Run the existing final-audit workflow after its prerequisites are met.
/sherpa-submissionFINALIZATION
Prepare and verify submission materials without submitting.
/sherpa-postmortemFINALIZATION
Run the final-phase evidence-based retrospective.
/sherpa-researchINTELLIGENCE
Research competitors, markets, technologies, and evidence with verifiable sources.

Why teams use Sherpa

Evidence-led

Separate facts, assumptions, and unknowns before turning them into a plan.

People keep the gates

Human approval stays explicit for consequential choices and implementation steps.

State travels with the project

Working notes and generated evidence live in the repository’s .sherpa/ directory.

Compatibility is stated plainly

Integration files and runtime verification are reported as separate things.

Agent compatibility

Agent	Integration files	Installer scope	Runtime
Claude Code	`.claude-plugin/`, `.claude/skills/`, `skills/sherpa/`	npm installer or plugin	NOT VERIFIED
Gemini CLI	`gemini-extension.json`, `.agents/skills/`	shared skill directory or extension	NOT VERIFIED
Qwen Code	`qwen-extension.json`, `.agents/skills/`	shared skill directory or extension	NOT VERIFIED
OpenCode	`.opencode/commands/`, `.agents/skills/`, package metadata	npm installer or shared skill	NOT VERIFIED
Kilo Code	`kilo.jsonc`, `.kilo/`, `.agents/skills/`	shared skill directory	NOT VERIFIED
Generic	Manually load root `SKILL.md` if host supports instruction files	Host-dependent	Host-dependent

See the full agent compatibility notes for scope and evidence.

Keep exploring

Your first ascent — a short walkthrough using real commands.
Command reference — manifest-backed command and CLI details.
Architecture — how the skill, core, workflows, and project state fit together.

GitHub repository · MIT License · version 2.0.8

SherpaBuild the right thing. Prove it works. Show why it matters.

Route to the summit ​

Find a command ​

Why teams use Sherpa ​