@oh-my-pi/cli 0.1.0 → 0.3.0

package/dist/paths.d.ts

@@ -3,15 +3,27 @@ export declare const PLUGINS_DIR: string;
 export declare const NODE_MODULES_DIR: string;
 export declare const GLOBAL_PACKAGE_JSON: string;
 export declare const GLOBAL_LOCK_FILE: string;
-export declare const LEGACY_MANIFEST_PATH: string;
 export declare const PROJECT_PI_DIR = ".pi";
 export declare const PROJECT_PLUGINS_JSON: string;
+export declare const PROJECT_PACKAGE_JSON: string;
 export declare const PROJECT_PLUGINS_LOCK: string;
 export declare const PROJECT_NODE_MODULES: string;
 /**
- * Get the agent directory (where symlinks are installed)
+ * Find the project root by walking up parent directories looking for .pi/plugins.json.
+ * Similar to how git finds .git directories.
+ *
+ * @returns The absolute path to the project root, or null if not found
  */
-export declare function getAgentDir(global?: boolean): string;
+export declare function findProjectRoot(): string | null;
+/**
+ * Check if a project-local .pi/plugins.json exists in the current directory or any parent
+ */
+export declare function hasProjectPlugins(): boolean;
+/**
+ * Get the project .pi directory path.
+ * Uses findProjectRoot() to locate the project, or falls back to cwd.
+ */
+export declare function getProjectPiDir(): string;
 /**
  * Get the plugins directory for the given scope
  */
@@ -24,4 +36,23 @@ export declare function getNodeModulesDir(global?: boolean): string;
  * Get the package.json path for the given scope
  */
 export declare function getPackageJsonPath(global?: boolean): string;
+/**
+ * Get the agent directory (where symlinks are installed)
+ */
+export declare function getAgentDir(global?: boolean): string;
+/**
+ * Resolve whether to use global or local scope based on CLI flags and auto-detection.
+ *
+ * Logic:
+ * - If --global is passed: use global mode
+ * - If --local is passed: use local mode
+ * - If neither: check if .pi/plugins.json exists in cwd, if so use local, otherwise use global
+ *
+ * @param options - CLI options containing global and local flags
+ * @returns true if global scope should be used, false for local
+ */
+export declare function resolveScope(options: {
+    global?: boolean;
+    local?: boolean;
+}): boolean;
 //# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,aAAa,QAAyB,CAAC;AAGpD,eAAO,MAAM,WAAW,QAAiC,CAAC;AAG1D,eAAO,MAAM,gBAAgB,QAAoC,CAAC;AAGlE,eAAO,MAAM,mBAAmB,QAAoC,CAAC;AAGrE,eAAO,MAAM,gBAAgB,QAAyC,CAAC;AAGvE,eAAO,MAAM,oBAAoB,QAAqC,CAAC;AAGvE,eAAO,MAAM,cAAc,QAAQ,CAAC;AAGpC,eAAO,MAAM,oBAAoB,QAAuC,CAAC;AAGzE,eAAO,MAAM,oBAAoB,QAA4C,CAAC;AAG9E,eAAO,MAAM,oBAAoB,QAAuC,CAAC;AAEzE;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,UAAO,GAAG,MAAM,CAKjD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,UAAO,GAAG,MAAM,CAKnD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,UAAO,GAAG,MAAM,CAKvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,UAAO,GAAG,MAAM,CAKxD"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,aAAa,QAAyB,CAAC;AAGpD,eAAO,MAAM,WAAW,QAAiC,CAAC;AAG1D,eAAO,MAAM,gBAAgB,QAAoC,CAAC;AAGlE,eAAO,MAAM,mBAAmB,QAAoC,CAAC;AAGrE,eAAO,MAAM,gBAAgB,QAAyC,CAAC;AAGvE,eAAO,MAAM,cAAc,QAAQ,CAAC;AAGpC,eAAO,MAAM,oBAAoB,QAAuC,CAAC;AAGzE,eAAO,MAAM,oBAAoB,QAAuC,CAAC;AAGzE,eAAO,MAAM,oBAAoB,QAA4C,CAAC;AAG9E,eAAO,MAAM,oBAAoB,QAAuC,CAAC;AAEzE;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAc/C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAOxC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,UAAO,GAAG,MAAM,CAKnD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,UAAO,GAAG,MAAM,CAKvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,UAAO,GAAG,MAAM,CAKxD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,UAAO,GAAG,MAAM,CAKjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CASpF"}

package/dist/runtime.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Get all environment variables for enabled plugins
+ */
+export declare function getPluginEnvVars(global?: boolean): Promise<Record<string, string>>;
+/**
+ * Generate shell export statements
+ * omp env > ~/.pi/env.sh && source ~/.pi/env.sh
+ */
+export declare function generateEnvScript(global?: boolean, shell?: "sh" | "fish"): Promise<string>;
+/**
+ * Get environment variables as a JSON object for programmatic use
+ */
+export declare function getEnvJson(global?: boolean): Promise<Record<string, string>>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AA8CA;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,UAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAiCrF;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,UAAO,EAAE,KAAK,GAAE,IAAI,GAAG,MAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAanG;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,UAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAE/E"}

package/dist/symlinks.d.ts

@@ -1,18 +1,54 @@
-import type { OmpInstallEntry, PluginPackageJson } from "./manifest.js";
+import type { OmpFeature, OmpInstallEntry, PluginPackageJson, PluginRuntimeConfig } from "@omp/manifest";
+/**
+ * Get all install entries from package.json.
+ * Features no longer have install entries - all files are always installed.
+ */
+export declare function getInstallEntries(pkgJson: PluginPackageJson): OmpInstallEntry[];
+/**
+ * @deprecated Use getInstallEntries instead. Features no longer have install arrays.
+ */
+export declare function getEnabledInstallEntries(pkgJson: PluginPackageJson, _enabledFeatures?: string[]): OmpInstallEntry[];
+/**
+ * Get all available feature names from a plugin
+ */
+export declare function getAllFeatureNames(pkgJson: PluginPackageJson): string[];
+/**
+ * Get features that are enabled by default (default !== false)
+ */
+export declare function getDefaultFeatures(features: Record<string, OmpFeature>): string[];
 export interface SymlinkResult {
     created: string[];
     errors: string[];
 }
+export interface SymlinkRemovalResult {
+    removed: string[];
+    errors: string[];
+    skippedNonSymlinks: string[];
+}
+/**
+ * Create symlinks (or copy files with copy:true) for a plugin's omp.install entries
+ * @param skipDestinations - Set of destination paths to skip (e.g., due to conflict resolution)
+ * @param enabledFeatures - Features to write into runtime.json (if plugin has one)
+ */
+export declare function createPluginSymlinks(pluginName: string, pkgJson: PluginPackageJson, global?: boolean, verbose?: boolean, skipDestinations?: Set<string>, enabledFeatures?: string[]): Promise<SymlinkResult>;
+/**
+ * Read runtime.json config from a plugin's installed location
+ */
+export declare function readRuntimeConfig(runtimePath: string): PluginRuntimeConfig;
+/**
+ * Write runtime.json config to a plugin's installed location
+ */
+export declare function writeRuntimeConfig(runtimePath: string, config: PluginRuntimeConfig, verbose?: boolean): Promise<void>;
 /**
- * Create symlinks for a plugin's omp.install entries
+ * Get the path to a plugin's runtime.json in the installed location
  */
-export declare function createPluginSymlinks(pluginName: string, pkgJson: PluginPackageJson, global?: boolean, verbose?: boolean): Promise<SymlinkResult>;
+export declare function getRuntimeConfigPath(pkgJson: PluginPackageJson, global?: boolean): string | null;
 /**
- * Remove symlinks for a plugin's omp.install entries
+ * Remove symlinks and copied files for a plugin's omp.install entries
  */
-export declare function removePluginSymlinks(_pluginName: string, pkgJson: PluginPackageJson, verbose?: boolean): Promise<SymlinkResult>;
+export declare function removePluginSymlinks(_pluginName: string, pkgJson: PluginPackageJson, global?: boolean, verbose?: boolean): Promise<SymlinkRemovalResult>;
 /**
- * Check symlink health for a plugin
+ * Check symlink/file health for a plugin
  */
 export declare function checkPluginSymlinks(pluginName: string, pkgJson: PluginPackageJson, global?: boolean): Promise<{
     valid: string[];
@@ -26,7 +62,7 @@ export declare function getPluginForSymlink(dest: string, installedPlugins: Map<
 /**
  * Find all symlinks installed by plugins and trace them back
  */
-export declare function traceInstalledFile(filePath: string, installedPlugins: Map<string, PluginPackageJson>): Promise<{
+export declare function traceInstalledFile(filePath: string, installedPlugins: Map<string, PluginPackageJson>, global?: boolean): Promise<{
     plugin: string;
     entry: OmpInstallEntry;
 } | null>;

package/dist/symlinks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"symlinks.d.ts","sourceRoot":"","sources":["../src/symlinks.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAIxE,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACzC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,UAAO,EACb,OAAO,UAAO,GACZ,OAAO,CAAC,aAAa,CAAC,CAkDxB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACzC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,UAAO,GACZ,OAAO,CAAC,aAAa,CAAC,CA4BxB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,UAAO,GACX,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAoCnE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACxC,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAC9C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWxB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACvC,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAC9C,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GAAG,IAAI,CAAC,CAkB5D"}
+{"version":3,"file":"symlinks.d.ts","sourceRoot":"","sources":["../src/symlinks.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAKzG;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,eAAe,EAAE,CAE/E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACvC,OAAO,EAAE,iBAAiB,EAC1B,gBAAgB,CAAC,EAAE,MAAM,EAAE,GACzB,eAAe,EAAE,CAEnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAEvE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,MAAM,EAAE,CAIjF;AAgCD,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACzC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,UAAO,EACb,OAAO,UAAO,EACd,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAC9B,eAAe,CAAC,EAAE,MAAM,EAAE,GACxB,OAAO,CAAC,aAAa,CAAC,CAwHxB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,CAO1E;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACvC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,mBAAmB,EAC3B,OAAO,UAAQ,GACb,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAO,GAAG,MAAM,GAAG,IAAI,CAK7F;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACzC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,UAAO,EACb,OAAO,UAAO,GACZ,OAAO,CAAC,oBAAoB,CAAC,CAkE/B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,UAAO,GACX,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAwDnE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACxC,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAC9C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWxB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACvC,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAChD,MAAM,UAAO,GACX,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GAAG,IAAI,CAAC,CAmB5D"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/cli",
-	"version": "0.1.0",
+	"version": "0.3.0",
 	"description": "Plugin manager for pi - install and manage pi config plugins from git repos",
 	"type": "module",
 	"main": "./dist/index.js",
@@ -11,15 +11,20 @@
 	"scripts": {
 		"build": "bun build src/cli.ts --outdir dist --target bun && tsc --emitDeclarationOnly",
 		"dev": "bun --watch src/cli.ts",
-		"check": "biome check --write . && tsc --noEmit",
+		"lint": "biome check --write .",
+		"check": "bun run lint && tsc --noEmit",
 		"clean": "rm -rf dist",
 		"publish:all": "./scripts/publish.sh",
 		"publish:dry": "./scripts/publish.sh --dry-run",
 		"version:bump": "./scripts/bump-version.sh"
 	},
 	"keywords": ["pi", "plugin", "manager", "cli"],
-	"author": "",
+	"author": "Can Bölük <me@can.ac>",
 	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/can1357/oh-my-pi.git"
+	},
 	"devDependencies": {
 		"@biomejs/biome": "2.3.5",
 		"@types/node": "^22.10.5",
@@ -27,8 +32,9 @@
 		"typescript": "^5.9.2"
 	},
 	"dependencies": {
-		"commander": "^12.0.0",
-		"chalk": "^5.3.0"
+		"@inquirer/prompts": "^8.1.0",
+		"chalk": "^5.3.0",
+		"commander": "^12.0.0"
 	},
 	"engines": {
 		"bun": ">=1.0.0"

package/plugins/exa/README.md

@@ -0,0 +1,153 @@
+# Exa Plugin
+
+Exa AI web search and websets tools for pi.
+
+## Installation
+
+```bash
+# Install with default features (search only)
+omp install @oh-my-pi/exa
+
+# Install with all features
+omp install @oh-my-pi/exa[*]
+
+# Install with specific features
+omp install @oh-my-pi/exa[search,linkedin,websets]
+```
+
+## Features
+
+| Feature | Default | Description | Tools |
+|---------|---------|-------------|-------|
+| `search` | ✓ | Core web search capabilities | 4 tools |
+| `linkedin` | | LinkedIn profile and company search | 1 tool |
+| `company` | | Comprehensive company research | 1 tool |
+| `researcher` | | Long-running AI research tasks | 2 tools |
+| `websets` | | Entity collection management | 14 tools |
+
+Manage features after install:
+
+```bash
+omp features @oh-my-pi/exa                    # Interactive UI or list features
+omp features @oh-my-pi/exa --enable websets   # Enable websets
+omp features @oh-my-pi/exa --disable search   # Disable search
+omp features @oh-my-pi/exa --set search,linkedin,websets  # Set exact features
+```
+
+Feature state is stored in `runtime.json` which is copied (not symlinked) to the install location. You can also edit it directly:
+
+```bash
+cat ~/.pi/agent/tools/exa/runtime.json
+# {"features": ["search"], "options": {}}
+```
+
+## Setup
+
+Set your Exa API key:
+
+```bash
+# Option 1: Use omp config
+omp config @oh-my-pi/exa apiKey YOUR_API_KEY
+
+# Option 2: Environment variable
+export EXA_API_KEY=YOUR_API_KEY
+
+# Option 3: .env file in current directory or ~/.env
+echo "EXA_API_KEY=YOUR_API_KEY" >> ~/.env
+```
+
+Get your API key from: https://dashboard.exa.ai/api-keys
+
+## Tools
+
+### search (default)
+
+| Tool | Description |
+|------|-------------|
+| `web_search_general` | Real-time web searches with content extraction |
+| `web_search_deep` | Natural language web search with synthesized results |
+| `web_search_code_context` | Search code snippets, docs, and examples |
+| `web_search_crawl_url` | Extract content from specific URLs |
+
+### linkedin
+
+| Tool | Description |
+|------|-------------|
+| `web_search_linkedin` | Search LinkedIn profiles and companies |
+
+### company
+
+| Tool | Description |
+|------|-------------|
+| `web_search_company_research` | Comprehensive company research |
+
+### researcher
+
+| Tool | Description |
+|------|-------------|
+| `web_search_researcher_start` | Start comprehensive AI-powered research task |
+| `web_search_researcher_check` | Check research task status and get results |
+
+### websets
+
+| Tool | Description |
+|------|-------------|
+| `webset_create` | Create entity collections with search and enrichments |
+| `webset_list` | List all websets in your account |
+| `webset_get` | Get detailed webset information |
+| `webset_update` | Update webset metadata |
+| `webset_delete` | Delete a webset |
+| `webset_items_list` | List items in a webset |
+| `webset_item_get` | Get item details |
+| `webset_search_create` | Add search to find entities for a webset |
+| `webset_search_get` | Check search status |
+| `webset_search_cancel` | Cancel running search |
+| `webset_enrichment_create` | Extract custom data from webset items |
+| `webset_enrichment_get` | Get enrichment details |
+| `webset_enrichment_update` | Update enrichment metadata |
+| `webset_enrichment_delete` | Delete enrichment |
+| `webset_enrichment_cancel` | Cancel running enrichment |
+| `webset_monitor_create` | Auto-update webset on schedule |
+
+## Usage Examples
+
+### Code Search
+```
+Find examples of how to use React hooks with TypeScript
+```
+
+### Web Search
+```
+Search for the latest news about AI regulation in the EU
+```
+
+### Company Research (requires company feature)
+```
+Research the company OpenAI and find information about their products
+```
+
+### Deep Research (requires researcher feature)
+```
+Start a deep research project on the impact of large language models on software development
+```
+
+### Websets (requires websets feature)
+```
+Create a webset of AI startups in San Francisco founded after 2020,
+find 10 companies and enrich with CEO name and funding amount
+```
+
+## How It Works
+
+The plugin connects to Exa's hosted MCP (Model Context Protocol) servers:
+- `https://mcp.exa.ai/mcp` - Search tools
+- `https://websetsmcp.exa.ai/mcp` - Websets tools
+
+Tools are dynamically fetched from these servers, so you always get the latest available tools.
+
+## Resources
+
+- [Exa Dashboard](https://dashboard.exa.ai/)
+- [Exa MCP Documentation](https://docs.exa.ai/reference/exa-mcp)
+- [Websets MCP Documentation](https://docs.exa.ai/reference/websets-mcp)
+- [Exa API Documentation](https://docs.exa.ai/)

package/plugins/exa/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@oh-my-pi/exa",
+  "version": "0.3.0",
+  "description": "Exa AI web search and websets tools for pi",
+  "keywords": ["omp-plugin", "exa", "web-search", "websets", "ai-search"],
+  "author": "Can Bölük <me@can.ac>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/can1357/oh-my-pi.git",
+    "directory": "plugins/exa"
+  },
+  "omp": {
+    "install": [
+      { "src": "tools/exa/runtime.json", "dest": "agent/tools/exa/runtime.json", "copy": true },
+      { "src": "tools/exa/index.ts", "dest": "agent/tools/exa/index.ts" },
+      { "src": "tools/exa/shared.ts", "dest": "agent/tools/exa/shared.ts" },
+      { "src": "tools/exa/search.ts", "dest": "agent/tools/exa/search.ts" },
+      { "src": "tools/exa/linkedin.ts", "dest": "agent/tools/exa/linkedin.ts" },
+      { "src": "tools/exa/company.ts", "dest": "agent/tools/exa/company.ts" },
+      { "src": "tools/exa/researcher.ts", "dest": "agent/tools/exa/researcher.ts" },
+      { "src": "tools/exa/websets.ts", "dest": "agent/tools/exa/websets.ts" }
+    ],
+    "variables": {
+      "apiKey": {
+        "type": "string",
+        "env": "EXA_API_KEY",
+        "description": "Exa API key for authentication",
+        "required": true
+      }
+    },
+    "features": {
+      "search": {
+        "description": "Core web search (general, deep, code context, URL crawling)",
+        "default": true
+      },
+      "linkedin": {
+        "description": "LinkedIn profile and company search",
+        "default": false
+      },
+      "company": {
+        "description": "Comprehensive company research",
+        "default": false
+      },
+      "researcher": {
+        "description": "Long-running AI research tasks",
+        "default": false
+      },
+      "websets": {
+        "description": "Entity collection management (14 tools)",
+        "default": false
+      }
+    }
+  },
+  "files": ["tools"]
+}

package/plugins/exa/tools/exa/company.ts

@@ -0,0 +1,35 @@
+/**
+ * Exa Company Research Tool
+ *
+ * Tools:
+ *   - web_search_company_research: Comprehensive company research
+ */
+
+import type { TSchema } from "@sinclair/typebox";
+import type { CustomAgentTool, CustomToolFactory, ToolAPI } from "@mariozechner/pi-coding-agent";
+import { callExaTool, createToolWrapper, fetchExaTools, findApiKey } from "./shared";
+
+// MCP tool names for this feature
+const TOOL_NAMES = ["company_research_exa"];
+
+// Tool name mapping: MCP name -> exposed name
+const NAME_MAP: Record<string, string> = {
+   "company_research_exa": "web_search_company_research",
+};
+
+const factory: CustomToolFactory = async (_toolApi: ToolAPI): Promise<CustomAgentTool<TSchema, unknown>[] | null> => {
+   const apiKey = findApiKey();
+   if (!apiKey) return null;
+
+   const mcpTools = await fetchExaTools(apiKey, TOOL_NAMES);
+   if (mcpTools.length === 0) return null;
+
+   const callFn = (toolName: string, args: Record<string, unknown>) =>
+      callExaTool(apiKey, TOOL_NAMES, toolName, args);
+
+   return mcpTools.map((tool) =>
+      createToolWrapper(tool, NAME_MAP[tool.name] ?? tool.name, callFn)
+   );
+};
+
+export default factory;

package/plugins/exa/tools/exa/index.ts

@@ -0,0 +1,66 @@
+/**
+ * Exa Tools - Dynamic loader for feature modules
+ *
+ * Reads runtime.json to determine which features are enabled,
+ * then loads and initializes those feature modules.
+ *
+ * Available features:
+ *   - search: Core web search (general, deep, code context, URL crawling)
+ *   - linkedin: LinkedIn profile and company search
+ *   - company: Comprehensive company research
+ *   - researcher: Long-running AI research tasks
+ *   - websets: Entity collection management
+ */
+
+import type { TSchema } from "@sinclair/typebox";
+import type { CustomAgentTool, CustomToolFactory, ToolAPI } from "@mariozechner/pi-coding-agent";
+import runtime from "./runtime.json";
+
+// Map feature names to their module imports
+const FEATURE_LOADERS: Record<string, () => Promise<{ default: CustomToolFactory }>> = {
+   search: () => import("./search"),
+   linkedin: () => import("./linkedin"),
+   company: () => import("./company"),
+   researcher: () => import("./researcher"),
+   websets: () => import("./websets"),
+};
+
+/**
+ * Factory function that loads enabled features from runtime.json
+ */
+const factory: CustomToolFactory = async (toolApi: ToolAPI): Promise<CustomAgentTool<TSchema, unknown>[] | null> => {
+   const allTools: CustomAgentTool<TSchema, unknown>[] = [];
+   const enabledFeatures = runtime.features ?? [];
+
+   for (const feature of enabledFeatures) {
+      const loader = FEATURE_LOADERS[feature];
+      if (!loader) {
+         console.error(`Unknown exa feature: "${feature}"`);
+         continue;
+      }
+
+      try {
+         const module = await loader();
+         const featureFactory = module.default;
+
+         if (typeof featureFactory === "function") {
+            const result = await featureFactory(toolApi);
+            // Handle both single tool and array of tools
+            if (result) {
+               const tools = Array.isArray(result) ? result : [result];
+               for (const tool of tools) {
+                  if (tool && typeof tool === "object" && "name" in tool) {
+                     allTools.push(tool);
+                  }
+               }
+            }
+         }
+      } catch (error) {
+         console.error(`Failed to load exa feature "${feature}":`, error);
+      }
+   }
+
+   return allTools.length > 0 ? allTools : null;
+};
+
+export default factory;

package/plugins/exa/tools/exa/linkedin.ts

@@ -0,0 +1,35 @@
+/**
+ * Exa LinkedIn Search Tool
+ *
+ * Tools:
+ *   - web_search_linkedin: Search LinkedIn profiles and companies
+ */
+
+import type { TSchema } from "@sinclair/typebox";
+import type { CustomAgentTool, CustomToolFactory, ToolAPI } from "@mariozechner/pi-coding-agent";
+import { callExaTool, createToolWrapper, fetchExaTools, findApiKey } from "./shared";
+
+// MCP tool names for this feature
+const TOOL_NAMES = ["linkedin_search_exa"];
+
+// Tool name mapping: MCP name -> exposed name
+const NAME_MAP: Record<string, string> = {
+   "linkedin_search_exa": "web_search_linkedin",
+};
+
+const factory: CustomToolFactory = async (_toolApi: ToolAPI): Promise<CustomAgentTool<TSchema, unknown>[] | null> => {
+   const apiKey = findApiKey();
+   if (!apiKey) return null;
+
+   const mcpTools = await fetchExaTools(apiKey, TOOL_NAMES);
+   if (mcpTools.length === 0) return null;
+
+   const callFn = (toolName: string, args: Record<string, unknown>) =>
+      callExaTool(apiKey, TOOL_NAMES, toolName, args);
+
+   return mcpTools.map((tool) =>
+      createToolWrapper(tool, NAME_MAP[tool.name] ?? tool.name, callFn)
+   );
+};
+
+export default factory;

package/plugins/exa/tools/exa/researcher.ts

@@ -0,0 +1,40 @@
+/**
+ * Exa Deep Researcher Tools
+ *
+ * Tools:
+ *   - web_search_researcher_start: Start comprehensive AI research tasks
+ *   - web_search_researcher_check: Check research task status
+ */
+
+import type { TSchema } from "@sinclair/typebox";
+import type { CustomAgentTool, CustomToolFactory, ToolAPI } from "@mariozechner/pi-coding-agent";
+import { callExaTool, createToolWrapper, fetchExaTools, findApiKey } from "./shared";
+
+// MCP tool names for this feature
+const TOOL_NAMES = [
+   "deep_researcher_start",
+   "deep_researcher_check",
+];
+
+// Tool name mapping: MCP name -> exposed name
+const NAME_MAP: Record<string, string> = {
+   "deep_researcher_start": "web_search_researcher_start",
+   "deep_researcher_check": "web_search_researcher_check",
+};
+
+const factory: CustomToolFactory = async (_toolApi: ToolAPI): Promise<CustomAgentTool<TSchema, unknown>[] | null> => {
+   const apiKey = findApiKey();
+   if (!apiKey) return null;
+
+   const mcpTools = await fetchExaTools(apiKey, TOOL_NAMES);
+   if (mcpTools.length === 0) return null;
+
+   const callFn = (toolName: string, args: Record<string, unknown>) =>
+      callExaTool(apiKey, TOOL_NAMES, toolName, args);
+
+   return mcpTools.map((tool) =>
+      createToolWrapper(tool, NAME_MAP[tool.name] ?? tool.name, callFn)
+   );
+};
+
+export default factory;

package/plugins/exa/tools/exa/runtime.json

@@ -0,0 +1,4 @@
+{
+  "features": ["search"],
+  "options": {}
+}

package/plugins/exa/tools/exa/search.ts

@@ -0,0 +1,46 @@
+/**
+ * Exa Search Tools - Core web search capabilities
+ *
+ * Tools:
+ *   - web_search_general: Real-time web searches
+ *   - web_search_deep: Natural language web search with synthesis
+ *   - web_search_code_context: Code search for libraries, docs, examples
+ *   - web_search_crawl_url: Extract content from specific URLs
+ */
+
+import type { TSchema } from "@sinclair/typebox";
+import type { CustomAgentTool, CustomToolFactory, ToolAPI } from "@mariozechner/pi-coding-agent";
+import { callExaTool, createToolWrapper, fetchExaTools, findApiKey } from "./shared";
+
+// MCP tool names for this feature
+const TOOL_NAMES = [
+   "web_search_exa",
+   "deep_search_exa",
+   "get_code_context_exa",
+   "crawling_exa",
+];
+
+// Tool name mapping: MCP name -> exposed name
+const NAME_MAP: Record<string, string> = {
+   "web_search_exa": "web_search_general",
+   "deep_search_exa": "web_search_deep",
+   "get_code_context_exa": "web_search_code_context",
+   "crawling_exa": "web_search_crawl_url",
+};
+
+const factory: CustomToolFactory = async (_toolApi: ToolAPI): Promise<CustomAgentTool<TSchema, unknown>[] | null> => {
+   const apiKey = findApiKey();
+   if (!apiKey) return null;
+
+   const mcpTools = await fetchExaTools(apiKey, TOOL_NAMES);
+   if (mcpTools.length === 0) return null;
+
+   const callFn = (toolName: string, args: Record<string, unknown>) =>
+      callExaTool(apiKey, TOOL_NAMES, toolName, args);
+
+   return mcpTools.map((tool) =>
+      createToolWrapper(tool, NAME_MAP[tool.name] ?? tool.name, callFn)
+   );
+};
+
+export default factory;