nia-opencode 0.1.3 → 0.1.5

package/dist/cli.js

@@ -10,10 +10,26 @@ var NIA_CONFIG_PATH = join(OPENCODE_CONFIG_DIR, "nia.json");
 var AGENTS_MD_PATH = join(OPENCODE_CONFIG_DIR, "AGENTS.md");
 var PLUGIN_NAME = "nia-opencode@latest";
 var NIA_AGENTS_INSTRUCTIONS = `
+---
+name: nia
+description: Use Nia MCP server for external documentation, GitHub repos, package source code, and research. Invoke when needing to index/search remote codebases, fetch library docs, explore packages, or do web research.
+---
+
 # How to use Nia
 
 Nia provides tools for indexing and searching external repositories, research papers, local folders, documentation, packages, and performing AI-powered research. Its primary goal is to reduce hallucinations in LLMs and provide up-to-date context for AI agents.
 
+## CRITICAL: Nia-First Workflow
+
+**BEFORE using WebFetch or WebSearch, you MUST:**
+
+1. **Check indexed sources first**: \`manage_resource(action='list', query='relevant-keyword')\` - Many sources may already be indexed
+2. **If source exists**: Use \`search\`, \`nia_grep\`, \`nia_read\`, \`nia_explore\` for targeted queries
+3. **If source doesn't exist but you know the URL**: Index it with \`index\` tool, then search
+4. **Only if source unknown**: Use \`nia_research(mode='quick')\` to discover URLs, then index
+
+**Why this matters**: Indexed sources provide more accurate, complete context than web fetches. WebFetch returns truncated/summarized content while Nia provides full source code and documentation.
+
 ## Deterministic Workflow
 
 1. Check if the source is already indexed using manage_resource (when listing sources, use targeted query to save tokens since users can have multiple sources indexed) or check any nia.md files for already indexed sources.
@@ -24,10 +40,18 @@ Nia provides tools for indexing and searching external repositories, research pa
 
 ## Notes
 
-- DO NOT USE WEB RESEARCH TOOLS IF INFORMATION IS INDEXED IN NIA BY USING 'manage_resource' tool.
+- **IMPORTANT**: Always prefer Nia tools over WebFetch/WebSearch. Nia provides full, structured content while web tools give truncated summaries.
 - If the source isn't indexed, index it. Note that for docs you should always index the root link like docs.stripe.com so it will always scrape all pages.
 - If you need to index something but don't know the link for that source, use nia_research (quick or deep modes).
 - Once you use the index tool, do not expect it to finish in 1-3 seconds. Stop your work or do something that will make your work pause for 1-5 minutes until the source is indexed, then run manage_resource again to check its status. You can also prompt the user to wait if needed.
+
+## Pre-WebFetch Checklist
+
+Before ANY WebFetch or WebSearch call, verify:
+- [ ] Ran \`manage_resource(action='list', query='...')\` for relevant keywords
+- [ ] Checked nia-sources.md or nia.md files for previously indexed sources
+- [ ] Confirmed no indexed source covers this information
+- [ ] For GitHub/npm/PyPI URLs: These should ALWAYS be indexed, not fetched
 `;
 function stripJsoncComments(content) {
   return content.replace(/\/\*[\s\S]*?\*\//g, "").replace(/\/\/.*$/gm, "");
@@ -210,13 +234,14 @@ async function install(options) {
   console.log("Step 1: Configure API Key");
   let apiKey = options.apiKey || process.env.NIA_API_KEY || "";
   if (!apiKey && options.tui && rl) {
-    console.log(`Get your API key from: https://app.trynia.ai
+    console.log("Get your API key from: https://app.trynia.ai");
+    console.log(`New user? Run: curl -fsSL https://app.trynia.ai/cli | sh
 `);
     apiKey = await prompt(rl, "Enter your Nia API key (nk_...): ");
   }
   if (!apiKey) {
     console.log("  No API key provided. You can set NIA_API_KEY environment variable later.");
-    console.log(`  Get your API key at: https://trynia.ai/api-keys
+    console.log(`  Get your API key at: https://app.trynia.ai
 `);
   } else if (!apiKey.startsWith("nk_")) {
     console.log("  Warning: API key should start with 'nk_'");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nia-opencode",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "OpenCode plugin that integrates Nia Knowledge Agent for research and documentation",
   "type": "module",
   "main": "dist/index.js",