@oh-my-pi/cli 0.3.0 → 0.5.0

package/README.md

@@ -18,6 +18,17 @@
 
 ---
 
+## Plugins
+
+| Plugin                                                                       | Description                                                                    |
+| ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| **[@oh-my-pi/subagents](https://npmjs.com/package/@oh-my-pi/subagents)**     | Task delegation with specialized sub-agents (task, planner, explore, reviewer) |
+| **[@oh-my-pi/exa](https://npmjs.com/package/@oh-my-pi/exa)**                 | Exa AI-powered web search, company/people lookup, and websets                  |
+| **[@oh-my-pi/user-prompt](https://npmjs.com/package/@oh-my-pi/user-prompt)** | Interactive user prompting for gathering input during execution                |
+| **[@oh-my-pi/metal-theme](https://npmjs.com/package/@oh-my-pi/metal-theme)** | A metal theme 🤘                                                               |
+
+---
+
 **Oh My Pi won't make Claude write better code...** but it might make _you_ feel like it does.
 
 Install community plugins with a single command. Themes, custom agents, slash commands, tools — all managed through npm, all a `omp install` away.
@@ -33,18 +44,15 @@ npm install -g @oh-my-pi/cli
 ## Quick Start
 
 ```bash
-# Initialize a project-local plugin config (optional)
-omp init
-
-# Search for plugins
-omp search agents
-
 # Install a plugin
 omp install @oh-my-pi/subagents
 
 # See what you've got
 omp list
 
+# Search for more
+omp search agents
+
 # Check for updates
 omp outdated
 
@@ -74,10 +82,10 @@ Plugins declare which files to install via the `omp.install` field in their `pac
 
 omp supports both global and project-local plugin configurations:
 
-| Scope | Config Location | Agent Directory | Use Case |
-|-------|-----------------|-----------------|----------|
-| Global | `~/.pi/plugins/` | `~/.pi/agent/` | Personal defaults |
-| Local | `.pi/` | `.pi/agent/` | Project-specific plugins |
+| Scope  | Config Location  | Agent Directory | Use Case                 |
+| ------ | ---------------- | --------------- | ------------------------ |
+| Global | `~/.pi/plugins/` | `~/.pi/agent/`  | Personal defaults        |
+| Local  | `.pi/`           | `.pi/agent/`    | Project-specific plugins |
 
 ```bash
 # Explicit scope
@@ -92,25 +100,25 @@ Initialize a project-local config with `omp init`.
 
 ## Commands
 
-| Command | Alias | Description |
-|---------|-------|-------------|
-| `omp install [pkg...]` | `i` | Install plugin(s). No args = install from plugins.json |
-| `omp uninstall <pkg>` | `rm` | Remove plugin and its symlinks |
-| `omp update [pkg]` | `up` | Update to latest within semver range |
-| `omp list` | `ls` | Show installed plugins |
-| `omp search <query>` | | Search npm for plugins |
-| `omp info <pkg>` | | Show plugin details before install |
-| `omp outdated` | | List plugins with newer versions |
-| `omp doctor` | | Check for broken symlinks, conflicts |
-| `omp link <path>` | | Symlink local plugin (dev mode) |
-| `omp create <name>` | | Scaffold new plugin from template |
-| `omp init` | | Create .pi/plugins.json in current project |
-| `omp why <file>` | | Show which plugin installed a file |
-| `omp enable <name>` | | Enable a disabled plugin |
-| `omp disable <name>` | | Disable plugin without uninstalling |
-| `omp features <name>` | | List or configure plugin features |
-| `omp config <name>` | | Get or set plugin configuration variables |
-| `omp env` | | Print environment variables for shell eval |
+| Command                | Alias | Description                                            |
+| ---------------------- | ----- | ------------------------------------------------------ |
+| `omp install [pkg...]` | `i`   | Install plugin(s). No args = install from plugins.json |
+| `omp uninstall <pkg>`  | `rm`  | Remove plugin and its symlinks                         |
+| `omp update [pkg]`     | `up`  | Update to latest within semver range                   |
+| `omp list`             | `ls`  | Show installed plugins                                 |
+| `omp search <query>`   |       | Search npm for plugins                                 |
+| `omp info <pkg>`       |       | Show plugin details before install                     |
+| `omp outdated`         |       | List plugins with newer versions                       |
+| `omp doctor`           |       | Check for broken symlinks, conflicts                   |
+| `omp link <path>`      |       | Symlink local plugin (dev mode)                        |
+| `omp create <name>`    |       | Scaffold new plugin from template                      |
+| `omp init`             |       | Create .pi/plugins.json in current project             |
+| `omp why <file>`       |       | Show which plugin installed a file                     |
+| `omp enable <name>`    |       | Enable a disabled plugin                               |
+| `omp disable <name>`   |       | Disable plugin without uninstalling                    |
+| `omp features <name>`  |       | List or configure plugin features                      |
+| `omp config <name>`    |       | Get or set plugin configuration variables              |
+| `omp env`              |       | Print environment variables for shell eval             |
 
 Most commands accept `-g`/`--global` or `-l`/`--local` flags to override scope auto-detection.
 
@@ -190,16 +198,16 @@ Plugins are npm packages with an `omp` field in `package.json`:
 
 ```json
 {
-  "name": "my-cool-plugin",
-  "version": "1.0.0",
-  "keywords": ["omp-plugin"],
-  "omp": {
-    "install": [
-      { "src": "agents/researcher.md", "dest": "agent/agents/researcher.md" },
-      { "src": "commands/research.md", "dest": "agent/commands/research.md" }
-    ]
-  },
-  "files": ["agents", "commands", "tools", "themes"]
+	"name": "my-cool-plugin",
+	"version": "1.0.0",
+	"keywords": ["omp-plugin"],
+	"omp": {
+		"install": [
+			{ "src": "agents/researcher.md", "dest": "agent/agents/researcher.md" },
+			{ "src": "commands/research.md", "dest": "agent/commands/research.md" }
+		]
+	},
+	"files": ["agents", "commands", "tools", "themes"]
 }
 ```
 
@@ -209,44 +217,38 @@ Plugins can define optional features and configurable variables:
 
 ```json
 {
-  "name": "@oh-my-pi/exa",
-  "version": "1.0.0",
-  "keywords": ["omp-plugin"],
-  "omp": {
-    "install": [
-      { "src": "tools/core.ts", "dest": "agent/tools/exa/core.ts" }
-    ],
-    "variables": {
-      "apiKey": {
-        "type": "string",
-        "env": "EXA_API_KEY",
-        "description": "Exa API key",
-        "required": true
-      }
-    },
-    "features": {
-      "search": {
-        "description": "Web search capabilities",
-        "default": true,
-        "install": [
-          { "src": "tools/search.ts", "dest": "agent/tools/exa/search.ts" }
-        ]
-      },
-      "websets": {
-        "description": "Curated content collections",
-        "default": false,
-        "install": [
-          { "src": "tools/websets.ts", "dest": "agent/tools/exa/websets.ts" }
-        ],
-        "variables": {
-          "defaultCollection": {
-            "type": "string",
-            "default": "general"
-          }
-        }
-      }
-    }
-  }
+	"name": "@oh-my-pi/exa",
+	"version": "1.0.0",
+	"keywords": ["omp-plugin"],
+	"omp": {
+		"install": [{ "src": "tools/core.ts", "dest": "agent/tools/exa/core.ts" }],
+		"variables": {
+			"apiKey": {
+				"type": "string",
+				"env": "EXA_API_KEY",
+				"description": "Exa API key",
+				"required": true
+			}
+		},
+		"features": {
+			"search": {
+				"description": "Web search capabilities",
+				"default": true,
+				"install": [{ "src": "tools/search.ts", "dest": "agent/tools/exa/search.ts" }]
+			},
+			"websets": {
+				"description": "Curated content collections",
+				"default": false,
+				"install": [{ "src": "tools/websets.ts", "dest": "agent/tools/exa/websets.ts" }],
+				"variables": {
+					"defaultCollection": {
+						"type": "string",
+						"default": "general"
+					}
+				}
+			}
+		}
+	}
 }
 ```
 
@@ -297,13 +299,6 @@ omp list
 cd my-plugin && npm publish
 ```
 
-## Bundled Plugins
-
-- **[@oh-my-pi/subagents](https://npmjs.com/package/@oh-my-pi/subagents)**: Task delegation with specialized sub-agents (task, planner, explore, reviewer)
-- **[@oh-my-pi/metal-theme](https://npmjs.com/package/@oh-my-pi/metal-theme)**: A metal theme
-- **[@oh-my-pi/exa](https://npmjs.com/package/@oh-my-pi/exa)**: Exa AI-powered web search and websets tools
-- **[@oh-my-pi/user-prompt](https://npmjs.com/package/@oh-my-pi/user-prompt)**: Interactive user prompting for gathering input during agent execution
-
 ## Troubleshooting
 
 ```bash