@united-robotics/cli 0.4.2 → 0.4.3

package/dist/index.js

@@ -2,7 +2,7 @@
 
 // src/index.ts
 import { Command } from "commander";
-import { chmodSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "fs";
+import { chmodSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync, writeFileSync } from "fs";
 import { homedir, tmpdir } from "os";
 import { basename, join } from "path";
 import { spawnSync } from "child_process";
@@ -41,14 +41,16 @@ program.command("team").argument("<cmd>").action(async (cmd) => {
 var project = program.command("project");
 project.command("ls").option("--team <teamId>").action(async (opts) => console.log(JSON.stringify(await api(`/api/projects${opts.team ? `?team=${encodeURIComponent(opts.team)}` : ""}`), null, 2)));
 project.command("show").argument("<projectId>").action(async (projectId) => console.log(JSON.stringify({ projectId, repos: await projectRepos(projectId) }, null, 2)));
-project.command("clone").argument("<projectId>").option("--dest <path>").option("--no-submodules", "clone primary repo only").option("--name <name>", "Git user.name for Vercel-compatible commits", "exis[ai]").option("--email <email>", "Git user.email for Vercel-compatible commits", "gotexis@gmail.com").action(async (projectId, opts) => {
+project.command("clone").argument("<projectId>").option("--dest <path>").option("--in-place", "clone into the current directory so AGENTS.md and workspace files land at the project root").option("--no-submodules", "clone primary repo only").option("--name <name>", "Git user.name for Vercel-compatible commits", "exis[ai]").option("--email <email>", "Git user.email for Vercel-compatible commits", "gotexis@gmail.com").action(async (projectId, opts) => {
   const repos = await projectRepos(projectId);
   const primary = repos.find((r) => r.kind === "primary") ?? repos[0];
   if (!primary) throw new Error("No repo found");
   const token = await projectGithubToken(projectId);
   const credentials = createGitAskpass(token.token);
   try {
-    const dest = opts.dest;
+    if (opts.inPlace && opts.dest) throw new Error("Use either --in-place or --dest, not both.");
+    const dest = opts.inPlace ? "." : opts.dest;
+    if (opts.inPlace) assertInPlaceCloneTarget(process.cwd());
     const cloneArgs = ["clone", primary.url];
     if (dest) cloneArgs.push(dest);
     runGit(cloneArgs, { cwd: process.cwd(), env: credentials.env, authHint: true });
@@ -113,9 +115,12 @@ program.command("codex").argument("<cmd>").option("--project <projectId>", "proj
   if (cmd !== "onboard") throw new Error("supported: ur codex onboard");
   const cfg = load();
   const loginToken = opts.includeToken ? cfg.token ?? "<TOKEN>" : "<TOKEN>";
-  console.log(`Establish new agent workspace by globally installing \`@united-robotics/cli\` module (ensuring there is a working node, nvm and git) and authenticate using token "ur login --token ${loginToken}". Then run \`ur project ls\` and \`ur project clone ${opts.project}\`; clone now internally obtains the short-lived project-wide GitHub token, initializes private submodules, and applies the Vercel-compatible git identity. When GitHub write access is needed manually, use \`ur github token --project ${opts.project}\` for a short-lived GitHub App token, but avoid printing that token in logs unless necessary. Use that project as codex project base from now on, and familiarize yourself.`);
+  console.log(`Establish new agent workspace in the current empty Codex project root by globally installing \`@united-robotics/cli\` module (ensuring there is a working node, nvm and git) and authenticate using token "ur login --token ${loginToken}". Then run \`ur project ls\` and \`ur project clone ${opts.project} --in-place\`; in-place clone puts AGENTS.md and workspace files at the Codex project root, while internally obtaining the short-lived project-wide GitHub token, initializing private submodules, and applying the Vercel-compatible git identity. When GitHub write access is needed manually, use \`ur github token --project ${opts.project}\` for a short-lived GitHub App token, but avoid printing that token in logs unless necessary. Use that project root as codex project base from now on, and familiarize yourself.`);
+});
+program.parseAsync().catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
 });
-program.parseAsync();
 async function projectRepos(projectId) {
   return await api(`/api/projects/${projectId}/repos`);
 }
@@ -162,12 +167,18 @@ function runGit(args, options = { cwd: process.cwd() }) {
   if (status !== 0 && !options.allowFailure) {
     if (options.authHint && /repository not found|authentication failed|could not read username|terminal prompts disabled/i.test(`${result.stdout}
 ${result.stderr}`)) {
-      throw new Error("GitHub authentication failed while accessing a private repo. The repo may exist, but GitHub credentials were unavailable or rejected. Re-run `ur login`, then `ur project clone <projectId>` so the CLI can inject a short-lived GitHub App token internally.");
+      throw new Error("GitHub authentication failed while accessing a private repo. The repo may exist, but GitHub credentials were unavailable or rejected. Re-run `ur login`, then `ur project clone <projectId> --in-place` from an empty project root so the CLI can inject a short-lived GitHub App token internally.");
     }
     throw new Error(`git ${safeArgs(args)} failed with exit ${status}`);
   }
   return { status, stdout: result.stdout ?? "", stderr: result.stderr ?? "" };
 }
+function assertInPlaceCloneTarget(cwd) {
+  const entries = readdirSync(cwd).filter((entry) => ![".DS_Store"].includes(entry));
+  if (entries.length > 0) {
+    throw new Error(`Cannot in-place clone into a non-empty directory (${cwd}). Start from an empty Codex project root, or use --dest <path> intentionally.`);
+  }
+}
 function gitBin() {
   return process.env.UR_GIT_BIN || (process.platform === "darwin" ? "/usr/bin/git" : "git");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@united-robotics/cli",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "type": "module",
   "bin": {
     "ur": "dist/index.js"