Global Projects

Global Projects

Use this skill to follow the user's project organization standard. The project CLI is installed as either moi(try first) or mo; the skill is mainly about the directory standard and when to use the selected command. The document will use mo as an example.

Standard layout:

<rootPath>/<github-owner-or-org>/<repo>

Examples:

~/code/vuejs/core
~/code/vitejs/vite
~/code/liangmiQwQ/mo

First Step

Skill loading does not automatically execute commands. When a task needs the project root, select the CLI and run its paired resolver first:

if command -v moi-get-root >/dev/null 2>&1; then
  moi-get-root
elif command -v mo-get-root >/dev/null 2>&1; then
  mo-get-root
else
  echo "Install @liangmi/moi or @liangmi/mo before resolving global projects." >&2
  exit 1
fi

Prefer moi when both resolver commands exist. The resolver only reads ~/.config/morc.json and prints JSON with rootPath. If rootPath is missing, ask the user before creating or cloning anything; they may need to run moi setup or mo setup for the selected CLI.

Use the command paired with the resolver for the rest of the task: moi-get-root selects moi, while mo-get-root selects mo. Never identify the project CLI from the mo command alone because another tool may own that name. The examples below use mo; substitute moi when moi-get-root was selected.

Project Path Rules

After resolving rootPath, infer paths yourself.

For a GitHub repo identifier, join the pieces directly:

owner/repo -> <rootPath>/owner/repo

For a GitHub URL:

https://github.com/vitejs/vite -> <rootPath>/vitejs/vite
git@github.com:vuejs/core.git -> <rootPath>/vuejs/core

For a bare project name or fuzzy query:

1. Run the selected CLI's list command or inspect one level under rootPath.
2. Prefer exact repo-name matches.
3. Prefer exact owner/repo matches when the user gave an owner.
4. If multiple owners match, ask the user to choose.
5. Use the resolved path directly for file operations.

Pay attention, the codebase may be not up to dated or even not in the main branch so please take care and use tricks to check.

Project CLI Command Usage

Use the selected project CLI when you need to clone/fork/create a project. Once you know the local path, use normal shell and editor tooling for ordinary file reads, edits, builds, and tests.

Use mo list to discover existing managed repositories:

mo list

Use mo clone <owner>/<repo> when the user wants a GitHub project locally and it is not already under <rootPath>/<owner>/<repo>. This preserves the owner/repo layout:

mo clone vitejs/vite

Use mo init to make a local project initialized using git and create a GitHub repo, only when the user explicitly asks to create/init a project:

mo init [options]

# Options, at least one of them should be provided if you
# --public    Create as public repository
# --private   Create as private repository

mo init can change remote GitHub state. Treat it as a dangerous command.

Use mo fork only when the user explicitly asks to fork or create a fork:

mo fork vitejs/vite
mo fork vitejs/vite --org my-org
mo fork vitejs/vite --name my-vite

Forking also changes remote GitHub state. Treat it as a dangerous command. Do not fork for inspection, editing, testing, cloning, opening, or convenience. It also includes some prompts you need to answer.

Working Standard

• Search under rootPath before broad filesystem scans.
• Preserve the <owner>/<repo> organization when cloning projects.
• Avoid creating project directories outside rootPath unless the user asks.
• Name both owner and repo in status updates for cross-project work.
• Use the selected project CLI for repository discovery and placement; use normal shell and editor tooling once the local path is known.