@liangmi/mo 0.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present, Liang Mi <https://github.com/liangmiQwQ> and contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,156 @@
+# mo
+
+**M**anage your **O**pensource projects!
+
+It just keeps your repos organized like this:
+
+```text
+
+~/code
+├── vitejs
+│   ├── vite
+│   └── devtools
+└── vuejs
+    ├── core
+    └── vue
+
+```
+
+## Install
+
+```bash
+
+vp install -g @liangmi/mo
+
+```
+
+## Requirements
+
+- macOS or Linux (Windows is not supported)
+- global install (local install is not supported for runtime usage)
+- `git`
+- GitHub CLI `gh` authenticated (`gh auth status`)
+
+## Quick Start
+
+Run setup once:
+
+```bash
+mo setup
+```
+
+`mo setup` will:
+
+1. check `git`
+2. check `gh` authentication
+3. ask for your projects root directory
+4. ask which shell(s) you use (`zsh`, `bash`, `fish`)
+5. optionally collect aliases for `mo clone`, `mo list`, and `mo cd`
+6. write `~/.config/morc.json`
+7. sync managed shellrc blocks
+
+After setup:
+
+```bash
+mo clone vitejs/vite
+mo list
+mo cd
+```
+
+## Commands
+
+### `mo setup`
+
+Initialize config and shell integration.
+
+### `mo clone <owner>/<repo>`
+
+Clone a GitHub repository into `<root>/<owner>/<repo>`.
+
+Alias: `mo c <owner>/<repo>`
+
+Example:
+
+```bash
+mo clone vuejs/core
+```
+
+### `mo list`
+
+List repositories under your configured root.
+
+Alias: `mo ls`
+
+### `mo cd [target]`
+
+Resolve and jump to a managed path in your shell integration function.
+
+Without `target`, it opens an interactive selector for:
+
+- root
+- owner directory
+- repository directory
+
+With `target`, supported forms are:
+
+- `root` or `.`
+- `<owner>`
+- `<owner>/<repo>`
+
+Alias: `mo d`
+
+## Config
+
+Default config path:
+
+```text
+~/.config/morc.json
+```
+
+Example:
+
+```json
+{
+  "$schema": "https://raw.githubusercontent.com/liangmiQwQ/mo/main/config_schema.json",
+  "root": "~/code",
+  "shells": ["zsh"],
+  "alias": {
+    "clone": ["k"],
+    "list": ["li"],
+    "cd": ["i"]
+  }
+}
+```
+
+### Fields
+
+- `root` (required): absolute path or `~` path for your projects directory
+- `shells` (required): one or more of `zsh`, `bash`, `fish`
+- `alias` (optional): alias arrays for `clone`, `list`, `cd`
+
+Alias names must match:
+
+```text
+[A-Za-z_][A-Za-z0-9_-]*
+```
+
+## Shell Integration
+
+`mo` manages shell integration blocks in your shellrc files:
+
+- `~/.zshrc`
+- `~/.bashrc`
+- `~/.config/fish/config.fish`
+
+## Notes
+
+- If you run config-required commands without config, `mo` prompts you to run `mo setup`.
+- `mo list` only shows repositories that are Git repos with a GitHub remote.
+
+## Contribution
+
+We're really excited to receive your contributions! Please see [ROADMAP.md](./ROADMAP.md) for details!
+
+## License
+
+[MIT](./LICENSE) © Liang Mi

package/bin/mo-inner.mjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+'use strict'
+import '../dist/mo-inner.mjs'

package/bin/mo.mjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+'use strict'
+import '../dist/mo.mjs'

package/config_schema.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Morc",
+  "description": "Configuration file for mo - Project manager for opensource developers on Github.",
+  "type": "object",
+  "required": ["root", "shells"],
+  "properties": {
+    "root": {
+      "type": "string",
+      "description": "The root directory where all your GitHub repositories are stored. Relative to the config file location.",
+      "examples": ["~/code", "/Users/username/code", "C:\\Users\\username\\code"]
+    },
+    "editor": {
+      "type": "string",
+      "description": "The default editor command to open repositories",
+      "examples": ["code", "cursor", "agy", "zed"]
+    },
+    "shells": {
+      "type": "array",
+      "description": "Shells whose shellrc files should be managed by mo. At least one shell is required.",
+      "items": {
+        "type": "string",
+        "enum": ["zsh", "bash", "fish"]
+      },
+      "minItems": 1,
+      "uniqueItems": true,
+      "examples": [["zsh"], ["zsh", "fish"]]
+    },
+    "alias": {
+      "type": "object",
+      "description": "Optional shell aliases for mo commands.",
+      "properties": {
+        "clone": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[A-Za-z_][A-Za-z0-9_-]*$"
+          },
+          "uniqueItems": true
+        },
+        "list": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[A-Za-z_][A-Za-z0-9_-]*$"
+          },
+          "uniqueItems": true
+        },
+        "cd": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[A-Za-z_][A-Za-z0-9_-]*$"
+          },
+          "uniqueItems": true
+        }
+      },
+      "additionalProperties": false
+    },
+    "$schema": {
+      "type": "string",
+      "description": "The schema URL for this config file."
+    }
+  },
+  "additionalProperties": false,
+  "allowComments": true,
+  "allowTrailingCommas": true
+}

package/dist/mo-inner.mjs

@@ -0,0 +1,86 @@
+import { S as cac, _ as buildAliasLines, c as supportedShells, l as error, o as getDefaultConfigPath, s as loadConfig, t as innerBinName } from "./runner-BDAeQY-R.mjs";
+import { existsSync } from "node:fs";
+//#region src/inner/shell.ts
+function generateShellIntegration(shell) {
+	if (!isValidShell(shell)) error(`Invalid shell "${shell}". Supported: ${supportedShells.join(", ")}`);
+	const aliases = loadAliasConfig();
+	if (shell === "bash" || shell === "zsh") return generateBashZshIntegration(aliases);
+	else return generateFishIntegration(aliases);
+}
+function generateBashZshIntegration(aliases) {
+	return [
+		"# mo shell integration script",
+		"mo() {",
+		"  if [ \"$1\" = \"cd\" ] || [ \"$1\" = \"d\" ]; then",
+		"    shift",
+		"    local mo_cd_target",
+		"    mo_cd_target=\"$(command mo cd \"$@\")\" || return $?",
+		"    export MO_CD_TARGET=\"$mo_cd_target\"",
+		"  else",
+		"    command mo \"$@\" || return $?",
+		"  fi",
+		"",
+		"  local mo_cd_result",
+		"  mo_cd_result=\"$(mo-inner cd)\" || return $?",
+		"  if [ -n \"$mo_cd_result\" ] && [ \"$mo_cd_result\" != \".\" ]; then",
+		"    cd \"$mo_cd_result\" || return $?",
+		"  fi",
+		"",
+		"  unset MO_CD_TARGET",
+		"}",
+		...buildAliasLines(aliases, (name, target) => `alias ${name}='${target}'`),
+		""
+	].join("\n");
+}
+function generateFishIntegration(aliases) {
+	return [
+		"# mo shell integration script",
+		"function mo",
+		"  if test (count $argv) -gt 0; and begin; test \"$argv[1]\" = \"cd\"; or test \"$argv[1]\" = \"d\"; end",
+		"    set -l mo_cd_target (command mo cd $argv[2..-1])",
+		"    or return $status",
+		"    set -gx MO_CD_TARGET \"$mo_cd_target\"",
+		"  else",
+		"    command mo $argv",
+		"    or return $status",
+		"  end",
+		"",
+		"  set -l mo_cd_result (mo-inner cd)",
+		"  or return $status",
+		"  if test -n \"$mo_cd_result\"; and test \"$mo_cd_result\" != \".\"",
+		"    cd \"$mo_cd_result\"",
+		"    or return $status",
+		"  end",
+		"",
+		"  set -e MO_CD_TARGET",
+		"end",
+		...buildAliasLines(aliases, (name, target) => `alias ${name} '${target}'`),
+		""
+	].join("\n");
+}
+function isValidShell(shell) {
+	return supportedShells.includes(shell);
+}
+function loadAliasConfig() {
+	if (!existsSync(getDefaultConfigPath())) return {};
+	try {
+		return loadConfig().alias ?? {};
+	} catch {
+		return {};
+	}
+}
+//#endregion
+//#region src/mo-inner.ts
+const cli = cac(innerBinName);
+cli.command("shell <shell>", "Generate shell integration code").action((shell) => console.log(generateShellIntegration(shell)));
+cli.command("cd", "Print pending directory path from shell state").action(() => {
+	const pending = process.env.MO_CD_TARGET;
+	if (typeof pending !== "string" || !pending.trim()) {
+		console.log(".");
+		return;
+	}
+	console.log(pending);
+});
+cli.parse();
+//#endregion
+export {};