planmode 0.1.3 → 0.1.5

package/README.md

@@ -0,0 +1,72 @@
+# planmode
+
+The open source package manager for AI plans, rules, and prompts.
+
+**Website:** [planmode.org](https://planmode.org)
+**Repository:** [github.com/kaihannonen/planmode.org](https://github.com/kaihannonen/planmode.org)
+
+## Install
+
+```bash
+npm install -g planmode
+```
+
+## Quick start
+
+```bash
+# Search for packages
+planmode search nextjs
+
+# Install a plan (adds to plans/ and updates CLAUDE.md)
+planmode install nextjs-tailwind-starter
+
+# Install a rule (goes to .claude/rules/)
+planmode install typescript-strict
+
+# Run a templated prompt
+planmode run rest-api-generator --resource users --framework express
+
+# See what's installed
+planmode list
+```
+
+## Package types
+
+| Type | What it is | Where it lives | Lifecycle |
+|------|-----------|---------------|-----------|
+| **Plan** | Multi-step implementation guide | `plans/*.md` | Active during task |
+| **Rule** | Always-on constraint | `.claude/rules/*.md` | Permanent |
+| **Prompt** | Fire-once instruction | `prompts/*.md` | Single use |
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `planmode install <pkg>` | Install a package |
+| `planmode uninstall <pkg>` | Remove a package |
+| `planmode search <query>` | Search the registry |
+| `planmode run <prompt>` | Run a templated prompt |
+| `planmode list` | List installed packages |
+| `planmode info <pkg>` | Show package details |
+| `planmode update [pkg]` | Update packages |
+| `planmode init` | Create a new package |
+| `planmode publish` | Publish to the registry |
+| `planmode login` | Configure GitHub auth |
+
+## How it works
+
+Planmode leverages Claude Code's native `@import` system. When you install a plan:
+
+1. The CLI fetches `.md` files from the registry
+2. Drops them into the correct directory (`plans/`, `.claude/rules/`, or `prompts/`)
+3. Adds `@plans/<name>.md` to your `CLAUDE.md`
+
+Claude Code is already the runtime. Planmode handles discovery, versioning, and distribution.
+
+## Browse packages
+
+Visit [planmode.org/packages](https://planmode.org/packages) to discover plans, rules, and prompts.
+
+## License
+
+MIT

package/dist/index.js

@@ -616,6 +616,15 @@ var logger = {
   }
 };
 
+// src/lib/analytics.ts
+var API_BASE = "https://api.planmode.org";
+function trackDownload(packageName) {
+  fetch(`${API_BASE}/downloads/${encodeURIComponent(packageName)}`, {
+    method: "POST"
+  }).catch(() => {
+  });
+}
+
 // src/lib/installer.ts
 function getInstallDir(type) {
   switch (type) {
@@ -689,6 +698,7 @@ async function installPackage(packageName, options = {}) {
   fs7.mkdirSync(path7.dirname(fullPath), { recursive: true });
   fs7.writeFileSync(fullPath, content, "utf-8");
   logger.success(`Installed ${packageName}@${version} \u2192 ${installPath}`);
+  trackDownload(packageName);
   if (type === "plan") {
     addImport(packageName, projectDir);
     logger.dim(`Added @import to CLAUDE.md`);
@@ -1294,7 +1304,7 @@ var loginCommand = new Command10("login").description("Configure GitHub authenti
 
 // src/index.ts
 var program = new Command11();
-program.name("planmode").description("The open source package manager for AI plans, rules, and prompts.").version("0.1.3");
+program.name("planmode").description("The open source package manager for AI plans, rules, and prompts.").version("0.1.5");
 program.addCommand(installCommand);
 program.addCommand(uninstallCommand);
 program.addCommand(searchCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "planmode",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "The open source package manager for AI plans, rules, and prompts.",
   "type": "module",
   "bin": {

package/src/index.ts

@@ -15,7 +15,7 @@ const program = new Command();
 program
   .name("planmode")
   .description("The open source package manager for AI plans, rules, and prompts.")
-  .version("0.1.3");
+  .version("0.1.5");
 
 program.addCommand(installCommand);
 program.addCommand(uninstallCommand);

package/src/lib/analytics.ts

@@ -0,0 +1,12 @@
+const API_BASE = "https://api.planmode.org";
+
+/**
+ * Fire-and-forget download tracking. Never throws, never blocks.
+ */
+export function trackDownload(packageName: string): void {
+  fetch(`${API_BASE}/downloads/${encodeURIComponent(packageName)}`, {
+    method: "POST",
+  }).catch(() => {
+    // Silently ignore — analytics should never affect the install flow
+  });
+}

package/src/lib/installer.ts

@@ -10,6 +10,7 @@ import { addImport, removeImport } from "./claude-md.js";
 import { parseManifest, readPackageContent } from "./manifest.js";
 import { renderTemplate, collectVariableValues } from "./template.js";
 import { logger } from "./logger.js";
+import { trackDownload } from "./analytics.js";
 
 function getInstallDir(type: PackageType): string {
   switch (type) {
@@ -116,6 +117,7 @@ export async function installPackage(
   fs.mkdirSync(path.dirname(fullPath), { recursive: true });
   fs.writeFileSync(fullPath, content, "utf-8");
   logger.success(`Installed ${packageName}@${version} → ${installPath}`);
+  trackDownload(packageName);
 
   // Update CLAUDE.md for plans
   if (type === "plan") {