thought-cabinet 0.2.0 → 0.2.1

package/README.md

@@ -21,30 +21,52 @@ Thought Cabinet solves these by providing:
 ## Quick Start
 
 ```bash
-cd your-project
-
 # 1. Install
 pnpm install -g thought-cabinet
 
-# 2. Initialize thoughts in your project
-thc init
-
-# 3. Install skills to your AI agent
+# 2. Install skills to your AI agent
+cd your-project
 thc skill install
 
-# 4. Use skills in your agent session (e.g. Claude Code)
+# 3. Onboard the project (in your agent session)
+> /onboard
+```
+
+The `/onboard` skill initializes thoughts, creates agent memory (`AGENTS.md`), and installs git hooks — all in one step.
+
+Once onboarded, use the workflow skills:
+
+```bash
 > /research-codebase How does the authentication system work?
 > /creating-plan Add OAuth2 support based on the research
 > /implementing-plan thoughts/shared/plans/add-oauth.md
 > /validating-plan thoughts/shared/plans/add-oauth.md
 ```
 
+<details>
+<summary>Manual setup (without the onboard skill)</summary>
+
+If you prefer to set up manually instead of using `/onboard`:
+
+```bash
+cd your-project
+
+# Initialize thoughts
+thc init
+
+# Install skills to your AI agent
+thc skill install
+```
+
+</details>
+
 ## Skills
 
 Skills are installed by `thc skill install` and invoked as slash commands in your agent session:
 
 | Skill                | Description                                                           |
 | -------------------- | --------------------------------------------------------------------- |
+| `/onboard`           | Initialize thoughts and bootstrap agent memory for a new project      |
 | `/research-codebase` | Deep-dive into codebase, save findings to `thoughts/shared/research/` |
 | `/creating-plan`     | Create implementation plan with phases and success criteria           |
 | `/iterating-plan`    | Refine existing plans based on feedback                               |

package/dist/index.js

@@ -1095,81 +1095,92 @@ async function thoughtsInitCommand(options) {
     }
     let config = loadThoughtsConfig(options);
     if (!config) {
-      p.intro(chalk5.blue("Initial Thoughts Setup"));
-      p.log.info("First, let's configure your global thoughts system.");
-      const defaultRepo = getDefaultThoughtsRepo();
-      p.log.message(
-        chalk5.gray("This is where all your thoughts across all projects will be stored.")
-      );
-      const thoughtsRepoInput = await p.text({
-        message: "Thoughts repository location:",
-        initialValue: defaultRepo,
-        placeholder: defaultRepo
-      });
-      if (p.isCancel(thoughtsRepoInput)) {
-        p.cancel("Operation cancelled.");
-        process.exit(0);
-      }
-      const thoughtsRepo = thoughtsRepoInput || defaultRepo;
-      p.log.message(chalk5.gray("Your thoughts will be organized into two main directories:"));
-      p.log.message(chalk5.gray("- Repository-specific thoughts (one subdirectory per project)"));
-      p.log.message(chalk5.gray("- Global thoughts (shared across all projects)"));
-      const reposDirInput = await p.text({
-        message: "Directory name for repository-specific thoughts:",
-        initialValue: "repos",
-        placeholder: "repos"
-      });
-      if (p.isCancel(reposDirInput)) {
-        p.cancel("Operation cancelled.");
-        process.exit(0);
-      }
-      const reposDir2 = reposDirInput || "repos";
-      const globalDirInput = await p.text({
-        message: "Directory name for global thoughts:",
-        initialValue: "global",
-        placeholder: "global"
-      });
-      if (p.isCancel(globalDirInput)) {
-        p.cancel("Operation cancelled.");
-        process.exit(0);
-      }
-      const globalDir = globalDirInput || "global";
-      const defaultUser = process.env.USER || "user";
-      let user = "";
-      while (!user || user.toLowerCase() === "global") {
-        const userInput = await p.text({
-          message: "Your username:",
-          initialValue: defaultUser,
-          placeholder: defaultUser,
-          validate: (value) => {
-            if (value.toLowerCase() === "global") {
-              return `Username cannot be "global" as it's reserved for cross-project thoughts.`;
-            }
-            return void 0;
-          }
+      if (options.directory) {
+        const thoughtsRepo = getDefaultThoughtsRepo();
+        const reposDir2 = "repos";
+        const globalDir = "global";
+        const user = process.env.USER || "user";
+        config = { thoughtsRepo, reposDir: reposDir2, globalDir, user, repoMappings: {} };
+        ensureThoughtsRepoExists(thoughtsRepo, reposDir2, globalDir);
+        saveThoughtsConfig(config, options);
+        p.log.success("Global thoughts configuration created with defaults");
+      } else {
+        p.intro(chalk5.blue("Initial Thoughts Setup"));
+        p.log.info("First, let's configure your global thoughts system.");
+        const defaultRepo = getDefaultThoughtsRepo();
+        p.log.message(
+          chalk5.gray("This is where all your thoughts across all projects will be stored.")
+        );
+        const thoughtsRepoInput = await p.text({
+          message: "Thoughts repository location:",
+          initialValue: defaultRepo,
+          placeholder: defaultRepo
         });
-        if (p.isCancel(userInput)) {
+        if (p.isCancel(thoughtsRepoInput)) {
           p.cancel("Operation cancelled.");
           process.exit(0);
         }
-        user = userInput || defaultUser;
-      }
-      config = {
-        thoughtsRepo,
-        reposDir: reposDir2,
-        globalDir,
-        user,
-        repoMappings: {}
-      };
-      p.note(
-        `${chalk5.cyan(thoughtsRepo)}/
+        const thoughtsRepo = thoughtsRepoInput || defaultRepo;
+        p.log.message(chalk5.gray("Your thoughts will be organized into two main directories:"));
+        p.log.message(chalk5.gray("- Repository-specific thoughts (one subdirectory per project)"));
+        p.log.message(chalk5.gray("- Global thoughts (shared across all projects)"));
+        const reposDirInput = await p.text({
+          message: "Directory name for repository-specific thoughts:",
+          initialValue: "repos",
+          placeholder: "repos"
+        });
+        if (p.isCancel(reposDirInput)) {
+          p.cancel("Operation cancelled.");
+          process.exit(0);
+        }
+        const reposDir2 = reposDirInput || "repos";
+        const globalDirInput = await p.text({
+          message: "Directory name for global thoughts:",
+          initialValue: "global",
+          placeholder: "global"
+        });
+        if (p.isCancel(globalDirInput)) {
+          p.cancel("Operation cancelled.");
+          process.exit(0);
+        }
+        const globalDir = globalDirInput || "global";
+        const defaultUser = process.env.USER || "user";
+        let user = "";
+        while (!user || user.toLowerCase() === "global") {
+          const userInput = await p.text({
+            message: "Your username:",
+            initialValue: defaultUser,
+            placeholder: defaultUser,
+            validate: (value) => {
+              if (value.toLowerCase() === "global") {
+                return `Username cannot be "global" as it's reserved for cross-project thoughts.`;
+              }
+              return void 0;
+            }
+          });
+          if (p.isCancel(userInput)) {
+            p.cancel("Operation cancelled.");
+            process.exit(0);
+          }
+          user = userInput || defaultUser;
+        }
+        config = {
+          thoughtsRepo,
+          reposDir: reposDir2,
+          globalDir,
+          user,
+          repoMappings: {}
+        };
+        p.note(
+          `${chalk5.cyan(thoughtsRepo)}/
   \u251C\u2500\u2500 ${chalk5.cyan(reposDir2)}/     ${chalk5.gray("(project-specific thoughts)")}
   \u2514\u2500\u2500 ${chalk5.cyan(globalDir)}/    ${chalk5.gray("(cross-project thoughts)")}`,
-        "Creating thoughts structure"
-      );
-      ensureThoughtsRepoExists(thoughtsRepo, reposDir2, globalDir);
-      saveThoughtsConfig(config, options);
-      p.log.success("Global thoughts configuration created");
+          "Creating thoughts structure"
+        );
+        ensureThoughtsRepoExists(thoughtsRepo, reposDir2, globalDir);
+        saveThoughtsConfig(config, options);
+        p.log.success("Global thoughts configuration created");
+      }
     }
     if (options.profile) {
       if (!validateProfile(config, options.profile)) {
@@ -1261,18 +1272,16 @@ async function thoughtsInitCommand(options) {
     if (!mappedName) {
       if (options.directory) {
         const sanitizedDir = sanitizeDirectoryName(options.directory);
-        if (!existingRepos.includes(sanitizedDir)) {
-          p.log.error(`Directory "${sanitizedDir}" not found in thoughts repository.`);
-          p.log.error("In non-interactive mode (--directory), you must specify a directory");
-          p.log.error("name that already exists in the thoughts repository.");
-          p.log.warn("Available directories:");
-          existingRepos.forEach((repo) => p.log.message(chalk5.gray(`  - ${repo}`)));
-          process.exit(1);
+        if (existingRepos.includes(sanitizedDir)) {
+          p.log.success(
+            `Using existing: ${tempProfileConfig.thoughtsRepo}/${tempProfileConfig.reposDir}/${sanitizedDir}`
+          );
+        } else {
+          p.log.success(
+            `Will create: ${tempProfileConfig.thoughtsRepo}/${tempProfileConfig.reposDir}/${sanitizedDir}`
+          );
         }
         mappedName = sanitizedDir;
-        p.log.success(
-          `Using existing: ${tempProfileConfig.thoughtsRepo}/${tempProfileConfig.reposDir}/${mappedName}`
-        );
       } else {
         p.intro(chalk5.blue("Repository Setup"));
         p.log.info(`Setting up thoughts for: ${chalk5.cyan(currentRepo)}`);