@montytools/cli 0.1.1 → 0.1.2

package/bin/monty.mjs

@@ -128,6 +128,72 @@ function openInBrowser(url) {
   }
 }
 
+
+// ── monty current / select / apps ───────────────────────────────────────────
+// Folder management users never think about: every app lives in ~/Monty,
+// `current` says where you are, `select` prints the folder for cd $(...).
+function findAppRoot(start) {
+  let d = start;
+  for (;;) {
+    if (existsSync(join(d, "monty.config.ts"))) return d;
+    const parent = dirname(d);
+    if (parent === d) return null;
+    d = parent;
+  }
+}
+
+function readSlugFromConfig(dir) {
+  try {
+    return /slug:\s*"([^"]+)"/.exec(readFileSync(join(dir, "monty.config.ts"), "utf8"))?.[1] ?? null;
+  } catch {
+    return null;
+  }
+}
+
+function listLocalApps() {
+  if (!existsSync(MONTY_HOME)) return [];
+  return readdirSync(MONTY_HOME)
+    .map((name) => join(MONTY_HOME, name))
+    .filter((p) => existsSync(join(p, "monty.config.ts")))
+    .map((p) => ({ path: p, slug: readSlugFromConfig(p) ?? basename(p) }));
+}
+
+function current() {
+  const root = findAppRoot(process.cwd());
+  if (!root) {
+    fail("NOT_IN_APP", `You are not inside a Monty app. \`monty apps\` lists local apps; cd "$(monty select <slug>)" jumps to one.`);
+  }
+  console.log(`app: ${readSlugFromConfig(root) ?? "?"}`);
+  console.log(`path: ${root}`);
+  if (!root.startsWith(MONTY_HOME)) {
+    console.log(`note: outside ${MONTY_HOME} (fine, but apps normally live there)`);
+  }
+}
+
+function select() {
+  const slug = rest.find((a) => !a.startsWith("--"));
+  if (!slug) {
+    fail("MISSING_SLUG", `Usage: cd "$(monty select <slug>)" — prints the app's folder.`);
+  }
+  const apps = listLocalApps();
+  const hit = apps.find((a) => a.slug === slug || basename(a.path) === slug);
+  if (!hit) {
+    const known = apps.map((a) => a.slug).join(", ") || "(none)";
+    fail("APP_NOT_LOCAL", `No local source for "${slug}" in ${MONTY_HOME}. Local apps: ${known}. Create it with \`monty create ${slug}\`.`);
+  }
+  // Bare path on stdout so command substitution works: cd "$(monty select x)"
+  console.log(hit.path);
+}
+
+function apps() {
+  const local = listLocalApps();
+  if (!local.length) {
+    console.log(`no local apps in ${MONTY_HOME} — create one with \`monty create <slug>\``);
+    return;
+  }
+  for (const a of local) console.log(`${a.slug}\t${a.path}`);
+}
+
 // ── monty create ───────────────────────────────────────────────────────────
 async function create() {
   const slug = rest.find((a) => !a.startsWith("--"));
@@ -460,17 +526,29 @@ switch (command) {
   case "docs":
     await docs();
     break;
+  case "current":
+    current();
+    break;
+  case "select":
+    select();
+    break;
+  case "apps":
+    apps();
+    break;
   case "deploy":
     await deploy();
     break;
   default:
-    console.log("usage: monty <login|create|dev|add|components|docs|deploy>");
+    console.log("usage: monty <login|create|current|select|apps|dev|add|components|docs|deploy>");
     console.log("  login       [--host <url>] [--key <mk_...>]  sign in (opens your browser to authorize)");
     console.log("  create      <slug> [--name N] [--icon I]   stamp a new app into ~/Monty/<slug>");
     console.log("  dev         [--port 5173]                  run the app locally (sandboxed data)");
     console.log("  add         <name...>                      install curated UI components (see `monty components`)");
     console.log("  components  [query]                        list the curated component catalog");
     console.log("  docs        <name>                         view a component's source before installing");
+    console.log("  current                                     which app folder am I in?");
+    console.log("  select      <slug>                          print an app's folder — cd \"$(monty select x)\"");
+    console.log("  apps                                        list local apps in ~/Monty");
     console.log("  deploy                                      build + upload this app");
     process.exit(command ? 1 : 0);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@montytools/cli",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "type": "module",
   "bin": {
     "monty": "./bin/monty.mjs"

package/template/AGENTS.md

@@ -4,6 +4,8 @@ Monty is a work OS: your app runs inside a team's workspace, on shared reactive
 data, with auth and deployment handled by the platform. **You only write product
 logic.** Everything below is the complete contract.
 
+Folders are managed for you: this app lives in `~/Monty/<slug>`. `monty current` confirms where you are; `cd "$(monty select <slug>)"` jumps to any app; never create app folders by hand.
+
 ## The three files that matter
 
 | File | What it is |