@nolrm/contextkit 0.12.3 → 0.12.4

package/README.md

@@ -32,15 +32,19 @@ Each platform gets auto-loaded bridge files (`CLAUDE.md`, `AGENTS.md`, `GEMINI.m
 **Requirements:** Node.js 14.x+ (16.x+ recommended) and npm/yarn. Optional: Git for hooks, AI tools for usage.
 
 ```bash
-# Step 1: Install globally (recommended)
+# Step 1: Install the CLI globally (one-time, any machine)
 npm i -g @nolrm/contextkit
 
-# Step 2: Navigate to your project and install
+# Step 2: Initialize in your project (once per project)
 cd your-project
 contextkit install          # interactive — prompts "Which AI tool?"
 contextkit install claude   # or specify your platform directly
 ```
 
+> **Project-level only.** `ck install` creates `.contextkit/` in your current directory and commits it with your project. There is no global mode — your standards live in git, not on your machine. This keeps them portable, CI-compatible, and shared with your team.
+
+> **Tip:** Need to share standards across projects? Push your `.contextkit/` to a shared repo and pull it with `ck pull`.
+
 This creates `.contextkit/` with skeleton context files (blank templates to be filled by AI):
 
 ```

package/bin/contextkit.js

@@ -22,7 +22,7 @@ program
 // Install command
 program
   .command('install [platform]')
-  .description('Install ContextKit in current project')
+  .description('Initialize ContextKit in the current project directory (run once per project, not global)')
   .option('--no-hooks', 'Skip Git hooks installation')
   .option('--non-interactive', 'Skip interactive prompts')
   .action(async (platform, options) => {

package/lib/commands/install.js

@@ -36,6 +36,15 @@ class InstallCommand {
       console.log(chalk.yellow('🧹 Removed legacy pre-commit hook (replaced by pre-push)'));
     }
 
+    // Warn if run outside a project directory
+    const hasGit = await this._findFileUpward('.git', 3);
+    const hasPkg = await fs.pathExists('package.json');
+    if (!hasGit && !hasPkg) {
+      console.log(chalk.yellow('⚠️  No project detected (no .git or package.json found in this directory).'));
+      console.log(chalk.yellow('   Make sure you are inside your project before running `ck install`.'));
+      console.log('');
+    }
+
     const requestedPlatform = options.platform;
     const isFullInstall = !!options.fullInstall;
 
@@ -1574,6 +1583,17 @@ If standards are still skeletons, warn that @imports in CLAUDE.md are loading em
     console.log(chalk.magenta('✨ Done! Your AI now understands your project.'));
     console.log('');
   }
+
+  async _findFileUpward(name, maxLevels) {
+    let dir = process.cwd();
+    for (let i = 0; i <= maxLevels; i++) {
+      if (await fs.pathExists(path.join(dir, name))) return true;
+      const parent = path.dirname(dir);
+      if (parent === dir) break;
+      dir = parent;
+    }
+    return false;
+  }
 }
 
 async function install(options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nolrm/contextkit",
-  "version": "0.12.3",
+  "version": "0.12.4",
   "description": "ContextKit - Context Engineering for AI Development. Provide rich context to AI through structured MD files with standards, code guides, and documentation. Works with Cursor, Claude, Aider, VS Code Copilot, and more.",
   "main": "lib/index.js",
   "bin": {