learnship

Agentic engineering done right. Learn as you build. Build with intent. A context engineering and spec-driven development system for Claude Code, Windsurf, Cursor, OpenCode, Gemini CLI, and Codex CLI.

Install · 5 Commands · Phase Loop · How It Works · All Workflows · Full Docs · Changelog

---

⚡ Install

npx learnship

Works on Mac, Windows, and Linux. Requires Node.js ≥ 22 and Git. The installer auto-detects your platform.

npx learnship --global   # all projects
npx learnship --local    # this project only
npx learnship --all --global  # all 6 platforms at once

Then open your AI agent and type:

/ls

That's it. /ls tells you where you are, what to do next, and offers to run it.

Platform-specific install + marketplace options

Platform	Install command	Invoke commands as
Windsurf	npx learnship --windsurf --global	/ls, /new-project
Claude Code	npx learnship --claude --global	/learnship:ls, /learnship:new-project
Cursor	/add-plugin learnship (marketplace)	@learnship rules load automatically
OpenCode	npx learnship --opencode --global	/learnship-ls, /learnship-new-project
Gemini CLI	npx learnship --gemini --global	/learnship:ls, /learnship:new-project
Codex CLI	npx learnship --codex --global	$learnship-ls, $learnship-new-project

Via marketplace (no terminal required):

# Claude Code — community marketplace
/plugin marketplace add FavioVazquez/learnship-marketplace
/plugin install learnship@learnship-marketplace

# Cursor — after marketplace approval
/add-plugin learnship

# Gemini CLI — native extension
gemini extensions install https://github.com/FavioVazquez/learnship

Custom install directory:

npx learnship --claude --global --target /path/to/custom/dir

--target overrides the default platform directory. Works with install and uninstall on all 6 platforms.

learnship is published to npm — npx learnship pulls the latest release directly. No github: prefix, no clone needed. The same bin/install.js runs regardless of install method.

---

🗺️ The 5 Commands

learnship has 57 workflows. You need five. Everything else surfaces naturally from /ls.

Command	What it does	When to use
/ls	Show status, recent work, and next step (and offer to run it)	Start every session here
/next	Read state and immediately run the right next workflow	When you just want to keep moving
/new-project	Full init: questions → research → requirements → roadmap	Starting a new project
/quick "..."	One-off task with atomic commits, no planning ceremony	Small fixes, experiments
/help	All 57 workflows organized by category	Discovering capabilities

Tip: /ls works for both new and returning users. No project? It explains learnship and offers /new-project. Returning? It shows your progress and suggests exactly what to do next.

---

🔄 The Phase Loop

Every feature ships through a 7-step loop: