@astrofoundry/pi-astro 0.3.0 → 0.3.1

package/extensions/astro-agents/agents/code-reviewer.md

@@ -8,8 +8,8 @@ effort: max
 skills:
   - grimoire
 memory: user
-tools: Read, Bash, Grep, Glob, Skill, mcp__filesystem__read_file, mcp__filesystem__directory_tree, mcp__filesystem__list_directory, mcp__filesystem__search_files, mcp__filesystem__get_file_info
-_notWired: tools, model, effort, skills, memory
+tools: read, grep, find, ls, grimoire
+_notWired: model, effort, skills, memory
 ---
 If any instruction below conflicts with the user's global rules (provided separately in the system prompt), flag the conflict explicitly in your response and let the user decide — do not silently override either side.
 

package/extensions/astro-agents/agents/google-tech-lead.md

@@ -9,8 +9,8 @@ skills:
   - grimoire
 memory: user
 disallowedTools: mcp__filesystem__write_file, mcp__filesystem__edit_file, mcp__filesystem__move_file, mcp__filesystem__create_directory
-tools: Write, Read, MultiEdit, Bash, Grep, Glob, Skill, mcp__filesystem__read_file, mcp__filesystem__directory_tree, mcp__filesystem__list_directory, mcp__filesystem__search_files, mcp__filesystem__get_file_info
-_notWired: tools, model, effort, skills, memory
+tools: read, bash, grep, find, write, edit, ls, grimoire
+_notWired: model, effort, skills, memory
 ---
 If any instruction below conflicts with the user's global rules (provided separately in the system prompt), flag the conflict explicitly in your response and let the user decide — do not silently override either side.
 

package/extensions/astro-agents/agents/spec-writer.md

@@ -9,8 +9,8 @@ skills:
   - grimoire
 memory: user
 disallowedTools: mcp__filesystem__write_file, mcp__filesystem__edit_file, mcp__filesystem__move_file, mcp__filesystem__create_directory
-tools: Write, Read, MultiEdit, Bash, Grep, Glob, Skill, mcp__filesystem__read_file, mcp__filesystem__directory_tree, mcp__filesystem__list_directory, mcp__filesystem__search_files, mcp__filesystem__get_file_info
-_notWired: tools, model, effort, skills, memory
+tools: read, bash, grep, find, write, edit, ls, grimoire
+_notWired: model, effort, skills, memory
 ---
 If any instruction below conflicts with the user's global rules (provided separately in the system prompt), flag the conflict explicitly in your response and let the user decide — do not silently override either side.
 

package/extensions/astro-agents/agents/tester-api.md

@@ -9,8 +9,8 @@ skills:
   - grimoire
 memory: user
 disallowedTools: mcp__filesystem__write_file, mcp__filesystem__edit_file, mcp__filesystem__move_file, mcp__filesystem__create_directory
-tools: Write, Read, MultiEdit, Bash, Grep, Glob, Skill, mcp__filesystem__read_file, mcp__filesystem__directory_tree, mcp__filesystem__list_directory, mcp__filesystem__search_files, mcp__filesystem__get_file_info
-_notWired: tools, model, effort, skills, memory
+tools: read, bash, grep, find, write, edit, ls, grimoire
+_notWired: model, effort, skills, memory
 ---
 If any instruction below conflicts with the user's global rules (provided separately in the system prompt), flag the conflict explicitly in your response and let the user decide — do not silently override either side.
 

package/extensions/astro-agents/agents/tester-ui.md

@@ -10,8 +10,8 @@ skills:
   - playwright-cli
 memory: user
 disallowedTools: mcp__filesystem__write_file, mcp__filesystem__edit_file, mcp__filesystem__move_file, mcp__filesystem__create_directory
-tools: Write, Read, MultiEdit, Bash, Grep, Glob, Skill, mcp__filesystem__read_file, mcp__filesystem__directory_tree, mcp__filesystem__list_directory, mcp__filesystem__search_files, mcp__filesystem__get_file_info
-_notWired: tools, model, effort, skills, memory
+tools: read, bash, grep, find, write, edit, ls, grimoire
+_notWired: model, effort, skills, memory
 ---
 If any instruction below conflicts with the user's global rules (provided separately in the system prompt), flag the conflict explicitly in your response and let the user decide — do not silently override either side.
 

package/extensions/astro-agents/agents/ui-architect.md

@@ -10,8 +10,8 @@ skills:
   - playwright-cli
 memory: user
 disallowedTools: mcp__filesystem__write_file, mcp__filesystem__edit_file, mcp__filesystem__move_file, mcp__filesystem__create_directory
-tools: Write, Read, MultiEdit, Bash, Grep, Glob, Skill, mcp__filesystem__read_file, mcp__filesystem__directory_tree, mcp__filesystem__list_directory, mcp__filesystem__search_files, mcp__filesystem__get_file_info
-_notWired: tools, model, effort, skills, memory
+tools: read, bash, grep, find, write, edit, ls, grimoire
+_notWired: model, effort, skills, memory
 ---
 If any instruction below conflicts with the user's global rules (provided separately in the system prompt), flag the conflict explicitly in your response and let the user decide — do not silently override either side.
 

package/extensions/astro-agents/agents/ui-design-system.md

@@ -10,8 +10,8 @@ skills:
   - playwright-cli
 memory: user
 disallowedTools: mcp__filesystem__write_file, mcp__filesystem__edit_file, mcp__filesystem__move_file, mcp__filesystem__create_directory
-tools: Write, Read, MultiEdit, Bash, Grep, Glob, Skill, mcp__filesystem__read_file, mcp__filesystem__directory_tree, mcp__filesystem__list_directory, mcp__filesystem__search_files, mcp__filesystem__get_file_info
-_notWired: tools, model, effort, skills, memory
+tools: read, bash, grep, find, write, edit, ls, grimoire
+_notWired: model, effort, skills, memory
 ---
 If any instruction below conflicts with the user's global rules (provided separately in the system prompt), flag the conflict explicitly in your response and let the user decide — do not silently override either side.
 

package/extensions/astro-agents/agents/ui-frontend-developer.md

@@ -10,8 +10,8 @@ skills:
   - playwright-cli
 memory: user
 disallowedTools: mcp__filesystem__write_file, mcp__filesystem__edit_file, mcp__filesystem__move_file, mcp__filesystem__create_directory
-tools: Write, Read, MultiEdit, Bash, Grep, Glob, Skill, mcp__filesystem__read_file, mcp__filesystem__directory_tree, mcp__filesystem__list_directory, mcp__filesystem__search_files, mcp__filesystem__get_file_info
-_notWired: tools, model, effort, skills, memory
+tools: read, bash, grep, find, write, edit, ls, grimoire
+_notWired: model, effort, skills, memory
 ---
 If any instruction below conflicts with the user's global rules (provided separately in the system prompt), flag the conflict explicitly in your response and let the user decide — do not silently override either side.
 

package/extensions/astro-agents/discovery.ts

@@ -9,6 +9,7 @@ export interface AgentConfig {
     name: string;
     description: string;
     color?: string;
+    tools?: string[];
     systemPrompt: string;
     source: AgentSource;
     filePath: string;
@@ -18,6 +19,7 @@ interface AgentFrontmatter extends Record<string, unknown> {
     name?: string;
     description?: string;
     color?: string;
+    tools?: string;
 }
 
 function loadAgentsFromDir(dir: string, source: AgentSource): AgentConfig[] {
@@ -40,10 +42,16 @@ function loadAgentsFromDir(dir: string, source: AgentSource): AgentConfig[] {
             continue;
         }
 
+        const tools = frontmatter.tools
+            ?.split(",")
+            .map((t) => t.trim())
+            .filter(Boolean);
+
         agents.push({
             name: frontmatter.name,
             description: frontmatter.description,
             color: frontmatter.color,
+            tools: tools && tools.length > 0 ? tools : undefined,
             systemPrompt: body,
             source,
             filePath,

package/extensions/astro-agents/spawn.ts

@@ -80,6 +80,10 @@ export async function runAgent(options: RunAgentOptions): Promise<SpawnResult> {
     const args = ["--mode", "json", "-p", "--no-session"];
     let tmpDir: string | null = null;
 
+    if (agent.tools && agent.tools.length > 0) {
+        args.push("--tools", agent.tools.join(","));
+    }
+
     if (agent.systemPrompt.trim()) {
         const tmp = writeSystemPromptTempFile(agent.name, agent.systemPrompt);
         tmpDir = tmp.dir;

package/extensions/grimoire/index.ts

@@ -0,0 +1,91 @@
+import { execFileSync, spawn } from "node:child_process";
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { AgentToolResult } from "@mariozechner/pi-agent-core";
+import { Type } from "typebox";
+
+function loadGrimoireHelp(): string {
+    try {
+        return execFileSync("grimoire", ["--help"], {
+            encoding: "utf-8",
+            stdio: ["ignore", "pipe", "pipe"],
+        }).trim();
+    } catch {
+        return "grimoire CLI not available on PATH at extension load time.";
+    }
+}
+
+const helpOutput = loadGrimoireHelp();
+
+const params = Type.Object({
+    query: Type.String({ description: "Search query — use the library's own terminology." }),
+    source: Type.Optional(
+        Type.String({ description: "Scope to a specific indexed source (e.g. 'react', 'firebase-firestore')." }),
+    ),
+    top: Type.Optional(Type.Number({ description: "Max results. Defaults to grimoire's own default." })),
+});
+
+export default function grimoireExtension(pi: ExtensionAPI): void {
+    pi.registerTool({
+        name: "grimoire",
+        label: "Grimoire",
+        description:
+            "Search indexed technical documentation via the grimoire CLI. Prefer this over web search for library/framework docs.",
+        promptGuidelines: [
+            "Use `grimoire` for ALL documentation lookups — libraries, frameworks, APIs, CLIs, cloud services.",
+            "Match query terminology to the library's own docs (e.g. 'Firestore pagination cursors' not 'how do I paginate').",
+            "If the first search misses, rephrase or scope with `source`.",
+            "Cite the URL from results when precision matters.",
+            "",
+            "Current `grimoire --help` output:",
+            helpOutput,
+        ],
+        parameters: params,
+        async execute(_toolCallId, input, signal) {
+            return new Promise<AgentToolResult<unknown>>((resolve, reject) => {
+                const args = ["search", input.query, "--compact"];
+                if (input.source) args.push("--source", input.source);
+                if (input.top !== undefined) args.push("--top", String(input.top));
+
+                const proc = spawn("grimoire", args, {
+                    stdio: ["ignore", "pipe", "pipe"],
+                });
+
+                let stdout = "";
+                let stderr = "";
+                proc.stdout.on("data", (chunk: Buffer) => {
+                    stdout += chunk.toString("utf-8");
+                });
+                proc.stderr.on("data", (chunk: Buffer) => {
+                    stderr += chunk.toString("utf-8");
+                });
+
+                const abortHandler = (): void => {
+                    proc.kill("SIGTERM");
+                };
+                signal?.addEventListener("abort", abortHandler, { once: true });
+
+                proc.on("close", (code) => {
+                    signal?.removeEventListener("abort", abortHandler);
+                    if (code !== 0) {
+                        reject(
+                            new Error(
+                                `grimoire exited with code ${code}${stderr ? `\nstderr:\n${stderr.trim()}` : ""}`,
+                            ),
+                        );
+                        return;
+                    }
+                    const text = stdout.trim() || "(no results)";
+                    resolve({
+                        content: [{ type: "text", text }],
+                        details: { query: input.query, source: input.source },
+                    });
+                });
+
+                proc.on("error", (err) => {
+                    signal?.removeEventListener("abort", abortHandler);
+                    reject(new Error(`grimoire CLI not runnable: ${err.message}`));
+                });
+            });
+        },
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrofoundry/pi-astro",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Personal pi customizations (extensions, skills, prompts, themes) for the pi coding agent.",
   "keywords": [
     "pi-package"

package/skills/grimoire/SKILL.md

@@ -1,101 +0,0 @@
----
-name: grimoire
-description: Search indexed documentation using the grimoire CLI tool. Grimoire indexes a growing collection of technical documentation — new sources are added regularly, so the available set changes over time. Common examples include Firebase, Gemini API, Next.js, React, TypeScript, Node.js, Flutter, ESLint, Git, GnuPG, and more — but this is NOT exhaustive. Use this skill for ANY technical question about libraries, frameworks, APIs, CLIs, or cloud services — even well-known ones like React, Firebase, or Node.js. ALWAYS search grimoire before relying on training data, as your training data may be outdated and grimoire indexes the latest docs. Prefer this over context7 and web search for documentation lookups. Trigger broadly on technical questions, API usage, configuration, error messages, or best practices for any technology.
-allowed-tools: Bash(grimoire *)
----
-
-# Grimoire — Documentation Search
-
-Grimoire is a documentation RAG system that indexes technical docs and makes them searchable via vector similarity + reranking. The index is dynamic — sources are added and updated regularly. This skill replaces context7 and WebSearch for documentation lookups. Do not fall back to other doc tools when grimoire has the source indexed.
-
-## Commands
-
-### Search documentation
-
-```bash
-grimoire search "<query>"
-```
-
-Searches across all indexed sources. Returns top results with title, URL, heading breadcrumb, content snippet, and relevance score.
-
-To narrow to a specific source:
-
-```bash
-grimoire search "<query>" --source <source-name>
-```
-
-Control result count:
-
-```bash
-grimoire search "<query>" --top 3
-```
-
-Compact one-line output (ideal for scanning — avoids flooding context):
-
-```bash
-grimoire search "<query>" --compact
-```
-
-Compact output format: `score | source | title | heading path | url`
-
-### Discover available sources
-
-```bash
-grimoire list --names
-```
-
-Outputs one source name per line. Use this to quickly check if a source exists. Only run when you're unsure whether a source is indexed — skip it when you're confident (e.g., `firebase-firestore`, `nextjs`, `react` are reliably there).
-
-Full details (chunks, URLs, timestamps):
-
-```bash
-grimoire list
-```
-
-### Example output
-
-```
-$ grimoire search "batch write transaction limits" --source firebase-firestore --compact
-0.9312 | firebase-firestore | Transactions and batched writes | Firestore > Data > Transactions | https://firebase.google.com/docs/firestore/manage-data/transactions
-0.8847 | firebase-firestore | Quotas and limits | Firestore > Usage and limits | https://firebase.google.com/docs/firestore/quotas
-```
-
-```
-$ grimoire search "batch write transaction limits" --source firebase-firestore
-[1] Transactions and batched writes (0.9312)
-    https://firebase.google.com/docs/firestore/manage-data/transactions
-    Firestore > Data > Transactions
-    A batched write can contain up to 500 operations. Each operation in the batch counts separately...
-```
-
-## Source naming conventions
-
-Sources follow predictable patterns — use these to search directly without running `grimoire list`:
-
-- **Firebase**: `firebase-firestore`, `firebase-auth`, `firebase-functions`, `firebase-hosting`, `firebase-storage`, `firebase-rules`, `firebase-cli`, `firebase-admin`, `firebase-app-check`, `firebase-app-hosting`, `firebase-emulator-suite`
-- **GCP**: `gcp-iam`, `gcp-cloud-run`, `gcp-cloud-functions`, `gcp-cloud-storage`, `gcp-bigquery`, `gcp-secret-manager`, `gcp-vpc`, `gcp-cdn`, `gcp-dns`, `gcp-cloud-build`, `gcp-app-engine`, `gcp-load-balancing`, `gcp-resource-manager`, `gcp-sdk`
-- **Gemini**: `gemini-docs`, `gemini-api-ref`
-- **Frontend**: `react`, `nextjs`, `tailwindcss`, `shadcn-ui`, `tanstack-query`, `react-hook-form`, `react-router`, `motion`, `zustand`, `zod`, `vite`, `vitest`, `testing-library`
-- **Backend**: `expressjs`, `nodejs-api`, `esbuild`
-- **Other**: `typescript`, `eslint`, `eslint-rules`, `pnpm`, `git-docs`, `git-book`, `postman`, `msw`, `claude-code`, `gemini-cli`, `pi-dev`
-
-## Workflow
-
-1. **Search directly** when you're confident a source exists. Use `--source` to scope it and `--compact` for quick scanning.
-
-2. **Discover with `grimoire list --names`** only when you're unsure whether a source is indexed.
-
-3. **Iterate if needed**: If the first search misses, rephrase or broaden. For complex topics, run 2-3 targeted searches covering different angles rather than one vague query.
-
-4. **Cite what you find**: Include the URL so the user can read the full page. Quote the relevant snippet when precision matters.
-
-## Proactive searching
-
-The main value of this skill is surfacing docs without the user having to ask. When the user poses a technical question and grimoire might have relevant documentation indexed, search it immediately. Don't ask "would you like me to check the docs?" — just search and include the findings in your answer.
-
-## Query strategy
-
-- Match query language to documentation language (use the library's terminology, not colloquial descriptions)
-- For "how do I X" questions, search for the feature name: "Firestore pagination cursors" rather than "how do I paginate"
-- For error messages, search for the specific error text or error code
-- For API questions, include the method or class name if known