@justram/pie 0.1.1 → 0.2.1

package/CHANGELOG.md

@@ -12,6 +12,44 @@
 
 ### Removed
 
+## 0.2.1
+
+### Breaking Changes
+
+### Added
+
+### Changed
+
+### Fixed
+
+- Restored minimal `AGENTS.md` pointing to `docs/` onboarding.
+
+### Removed
+
+## 0.2.0
+
+### Breaking Changes
+
+### Added
+
+- Added `--list-models` plus filtering/paging/JSON flags to inspect available provider models.
+- Added detailed progress output for `scripts/preindex.ts`, with concise tool/file status and periodic counters.
+- Defaulted `scripts/preindex.ts` to incremental updates based on git changes to reduce token usage.
+- Added clear logging for why a full update is selected in `scripts/preindex.ts`.
+- Added token usage summary logging after preindex runs.
+- Added untracked file detection to `scripts/preindex.ts` so incremental updates include new files.
+
+### Changed
+
+- Added `examples/hn-insights` and moved the HN insights script into the examples folder.
+- Expanded onboarding docs with example/script prerequisites and model listing flags.
+
+### Fixed
+
+- Removed TypeScript syntax from `bin/pie` to keep the CLI runnable under Node.
+
+### Removed
+
 ## 0.1.1
 
 ### Breaking Changes

package/README.md

@@ -28,6 +28,13 @@ cat input.txt | pie \
 	--model anthropic/claude-sonnet-4-5
 ```
 
+List available models (with optional filters):
+
+```bash
+pie --list-models --models-provider google-antigravity
+pie --list-models --models-provider google-antigravity --models-filter gemini
+```
+
 ### Authentication (API keys and OAuth)
 
 `pie` does not require Pi to be installed. It uses the OAuth helpers from `@mariozechner/pi-ai` and stores credentials in `~/.pi/agent/auth.json` (created automatically on first login).

package/bin/pie

@@ -2,7 +2,7 @@
 
 import { runCli } from "../dist/cli.js";
 
-async function main(): Promise<void> {
+async function main() {
 	const exitCode = await runCli(process.argv.slice(2));
 	process.exitCode = exitCode;
 }

package/dist/cli/args.d.ts

@@ -18,6 +18,12 @@ export interface CliArgs {
     recipeConfig?: string;
     recipeVars?: string;
     listRecipes?: boolean;
+    listModels?: boolean;
+    listModelsProvider?: string;
+    listModelsFilter?: string;
+    listModelsJson?: boolean;
+    listModelsLimit?: number;
+    listModelsOffset?: number;
     login?: string;
     help?: boolean;
     version?: boolean;

package/dist/cli/args.js

@@ -127,6 +127,58 @@ export function parseArgs(argv) {
             case "--list-recipes":
                 args.listRecipes = true;
                 break;
+            case "--list-models":
+                args.listModels = true;
+                break;
+            case "--models-provider":
+            case "--provider": {
+                const value = nextValue(arg);
+                if (value) {
+                    args.listModelsProvider = value;
+                    args.listModels = true;
+                }
+                break;
+            }
+            case "--models-filter": {
+                const value = nextValue(arg);
+                if (value) {
+                    args.listModelsFilter = value;
+                    args.listModels = true;
+                }
+                break;
+            }
+            case "--models-json":
+                args.listModelsJson = true;
+                args.listModels = true;
+                break;
+            case "--models-limit": {
+                const value = nextValue(arg);
+                if (!value)
+                    break;
+                const parsed = Number.parseInt(value, 10);
+                if (!Number.isFinite(parsed) || parsed < 0) {
+                    errors.push(`Invalid value for ${arg}: ${value}`);
+                }
+                else {
+                    args.listModelsLimit = parsed;
+                    args.listModels = true;
+                }
+                break;
+            }
+            case "--models-offset": {
+                const value = nextValue(arg);
+                if (!value)
+                    break;
+                const parsed = Number.parseInt(value, 10);
+                if (!Number.isFinite(parsed) || parsed < 0) {
+                    errors.push(`Invalid value for ${arg}: ${value}`);
+                }
+                else {
+                    args.listModelsOffset = parsed;
+                    args.listModels = true;
+                }
+                break;
+            }
             case "--login": {
                 const value = nextValue(arg);
                 if (value)
@@ -178,6 +230,12 @@ Options:
   --recipe-config <file>     Use a recipe config file (default: setup.md)
   --recipe-vars <json>       JSON object for recipe template vars
   --list-recipes             List available recipes and exit
+  --list-models              List available models and exit
+  --models-provider <name>   Filter models by provider (alias: --provider)
+  --models-filter <text>     Filter models by id or name substring
+  --models-limit <n>         Limit models output (for paging)
+  --models-offset <n>        Skip first N models (for paging)
+  --models-json              Output models as JSON
   --login <provider>         OAuth login for a provider (e.g. anthropic)
   -h, --help                 Show help
   -v, --version              Show version

package/dist/main.js

@@ -82,6 +82,45 @@ async function runCliInternal(argv, deps, stdout, stderr) {
         }
         return 0;
     }
+    if (args.listModels) {
+        const providerFilter = args.listModelsProvider;
+        if (providerFilter && !isKnownProvider(providerFilter)) {
+            throw new CliExitError(`Unknown provider: ${providerFilter}`, 2);
+        }
+        const providers = providerFilter ? [providerFilter] : getProviders();
+        const filter = args.listModelsFilter?.toLowerCase();
+        const entries = providers
+            .slice()
+            .sort((left, right) => left.localeCompare(right))
+            .flatMap((provider) => getModels(provider)
+            .slice()
+            .sort((left, right) => left.id.localeCompare(right.id))
+            .filter((model) => {
+            if (!filter) {
+                return true;
+            }
+            const id = model.id.toLowerCase();
+            const name = model.name?.toLowerCase() ?? "";
+            return id.includes(filter) || name.includes(filter);
+        })
+            .map((model) => ({
+            provider,
+            id: model.id,
+            name: model.name ?? null,
+        })));
+        const offset = args.listModelsOffset ?? 0;
+        const limit = args.listModelsLimit;
+        const sliced = limit === undefined ? entries.slice(offset) : entries.slice(offset, offset + limit);
+        if (args.listModelsJson) {
+            stdout.write(`${JSON.stringify(sliced, null, 2)}\n`);
+            return 0;
+        }
+        for (const entry of sliced) {
+            const name = entry.name ? `\t${entry.name}` : "";
+            stdout.write(`${entry.provider}\t${entry.id}${name}\n`);
+        }
+        return 0;
+    }
     const promptInput = args.promptFile ? readTextFile(args.promptFile, "prompt") : args.prompt;
     const promptPath = args.promptFile ? resolve(args.promptFile) : undefined;
     const promptIsSetup = !args.config && !useRecipe && typeof promptInput === "string" && promptInput.startsWith("---");

package/dist/models.d.ts

@@ -3,7 +3,7 @@
  *
  * Usage:
  * ```typescript
- * import { getModel, getModels, getProviders } from "pie";
+ * import { getModel, getModels, getProviders } from "@justram/pie";
  *
  * // Get specific model
  * const model = getModel("anthropic", "claude-sonnet-4-5");

package/dist/models.js

@@ -3,7 +3,7 @@
  *
  * Usage:
  * ```typescript
- * import { getModel, getModels, getProviders } from "pie";
+ * import { getModel, getModels, getProviders } from "@justram/pie";
  *
  * // Get specific model
  * const model = getModel("anthropic", "claude-sonnet-4-5");

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@justram/pie",
-	"version": "0.1.1",
+	"version": "0.2.1",
 	"description": "Structured extraction library and CLI built on @mariozechner/pi-ai.",
 	"license": "MIT",
 	"keywords": [