@imdigitalashish/zpi 0.1.1

package/README.md

@@ -0,0 +1,95 @@
+# zpi - Memory-Augmented Coding Agent
+
+A terminal coding agent with persistent long-term memory that learns from your interactions across sessions.
+
+## Install
+
+```bash
+npm install -g @imdigitalashish/zpi
+```
+
+## Setup
+
+Authenticate with an API key:
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...
+zpi
+```
+
+Or use your existing subscription:
+
+```bash
+zpi
+/login  # Then select provider
+```
+
+## Features
+
+- **Persistent Memory System** — procedural, episodic, and semantic memories stored per-project in `.pi/memory/`
+- **Automatic Learning** — the agent detects preferences, workflows, and facts from conversations and saves them automatically
+- **Timestamp Awareness** — the LLM sees when each message was sent and can detect time gaps
+- **Toggle On/Off** — memory system is on by default, disable via `/settings`
+
+## Memory System
+
+Memories are stored per-project in `.pi/memory/`:
+
+| Type | File | What it stores |
+|------|------|----------------|
+| Procedural | `procedural.json` | Multi-step workflows the user teaches |
+| Episodic | `episodic.json` | Session summaries, mistakes, lessons |
+| Semantic | `semantic.json` | Preferences, rules, facts, conventions |
+
+### Memory Tools (used by the LLM automatically)
+
+- `memory_write` — save a new memory
+- `memory_read` — recall memories by type, ID, or search
+- `memory_update` — update an existing memory
+- `memory_delete` — remove a memory
+
+### Memory Commands
+
+- `/memory` or `/memory list` — show all memories
+- `/memory show <id>` — show a specific memory
+- `/memory search <query>` — search memories
+- `/memory delete <id>` — delete a memory
+- `/memory compact` — deduplicate and consolidate memories
+
+## Supported Providers
+
+| Provider | Auth |
+|----------|------|
+| Anthropic | `ANTHROPIC_API_KEY` or `/login anthropic` |
+| OpenAI | `OPENAI_API_KEY` |
+| Google Gemini | `GOOGLE_GENERATIVE_AI_API_KEY` or `/login google` |
+| AWS Bedrock | `AWS_ACCESS_KEY_ID` + `AWS_SECRET_ACCESS_KEY` |
+| Azure OpenAI | `AZURE_OPENAI_API_KEY` + `AZURE_OPENAI_ENDPOINT` |
+| GitHub Copilot | `/login copilot` |
+| OpenAI-compatible | `OPENAI_API_KEY` + `OPENAI_BASE_URL` |
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `/model` | Switch model |
+| `/login` | Authenticate with a provider |
+| `/settings` | Toggle memory, theme, etc. |
+| `/memory` | View/manage memories |
+| `/sessions` | Browse sessions |
+| `/compact` | Compact conversation |
+| `/help` | Show all commands |
+
+## Settings
+
+Toggle memory system on/off:
+- Use `/settings` in the TUI
+- Or edit `.pi/settings.json`: `{ "memory": { "enabled": false } }`
+
+## Author
+
+[imdigitalashish](https://github.com/imdigitalashish)
+
+## License
+
+MIT

package/dist/cli/args.d.ts

@@ -0,0 +1,47 @@
+/**
+ * CLI argument parsing and help display
+ */
+import type { ThinkingLevel } from "@mariozechner/pi-agent-core";
+import { type ToolName } from "../core/tools/index.js";
+export type Mode = "text" | "json" | "rpc";
+export interface Args {
+    provider?: string;
+    model?: string;
+    apiKey?: string;
+    systemPrompt?: string;
+    appendSystemPrompt?: string;
+    thinking?: ThinkingLevel;
+    continue?: boolean;
+    resume?: boolean;
+    help?: boolean;
+    version?: boolean;
+    mode?: Mode;
+    noSession?: boolean;
+    session?: string;
+    sessionDir?: string;
+    models?: string[];
+    tools?: ToolName[];
+    noTools?: boolean;
+    extensions?: string[];
+    noExtensions?: boolean;
+    print?: boolean;
+    export?: string;
+    noSkills?: boolean;
+    skills?: string[];
+    promptTemplates?: string[];
+    noPromptTemplates?: boolean;
+    themes?: string[];
+    noThemes?: boolean;
+    listModels?: string | true;
+    verbose?: boolean;
+    messages: string[];
+    fileArgs: string[];
+    /** Unknown flags (potentially extension flags) - map of flag name to value */
+    unknownFlags: Map<string, boolean | string>;
+}
+export declare function isValidThinkingLevel(level: string): level is ThinkingLevel;
+export declare function parseArgs(args: string[], extensionFlags?: Map<string, {
+    type: "boolean" | "string";
+}>): Args;
+export declare function printHelp(): void;
+//# sourceMappingURL=args.d.ts.map

package/dist/cli/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGjE,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAE3C,MAAM,WAAW,IAAI;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8EAA8E;IAC9E,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;CAC5C;AAID,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,aAAa,CAE1E;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAA;CAAE,CAAC,GAAG,IAAI,CAwH5G;AAED,wBAAgB,SAAS,IAAI,IAAI,CAsIhC","sourcesContent":["/**\r\n * CLI argument parsing and help display\r\n */\r\n\r\nimport type { ThinkingLevel } from \"@mariozechner/pi-agent-core\";\r\nimport chalk from \"chalk\";\r\nimport { APP_NAME, CONFIG_DIR_NAME, ENV_AGENT_DIR } from \"../config.js\";\r\nimport { allTools, type ToolName } from \"../core/tools/index.js\";\r\n\r\nexport type Mode = \"text\" | \"json\" | \"rpc\";\r\n\r\nexport interface Args {\r\n\tprovider?: string;\r\n\tmodel?: string;\r\n\tapiKey?: string;\r\n\tsystemPrompt?: string;\r\n\tappendSystemPrompt?: string;\r\n\tthinking?: ThinkingLevel;\r\n\tcontinue?: boolean;\r\n\tresume?: boolean;\r\n\thelp?: boolean;\r\n\tversion?: boolean;\r\n\tmode?: Mode;\r\n\tnoSession?: boolean;\r\n\tsession?: string;\r\n\tsessionDir?: string;\r\n\tmodels?: string[];\r\n\ttools?: ToolName[];\r\n\tnoTools?: boolean;\r\n\textensions?: string[];\r\n\tnoExtensions?: boolean;\r\n\tprint?: boolean;\r\n\texport?: string;\r\n\tnoSkills?: boolean;\r\n\tskills?: string[];\r\n\tpromptTemplates?: string[];\r\n\tnoPromptTemplates?: boolean;\r\n\tthemes?: string[];\r\n\tnoThemes?: boolean;\r\n\tlistModels?: string | true;\r\n\tverbose?: boolean;\r\n\tmessages: string[];\r\n\tfileArgs: string[];\r\n\t/** Unknown flags (potentially extension flags) - map of flag name to value */\r\n\tunknownFlags: Map<string, boolean | string>;\r\n}\r\n\r\nconst VALID_THINKING_LEVELS = [\"off\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\"] as const;\r\n\r\nexport function isValidThinkingLevel(level: string): level is ThinkingLevel {\r\n\treturn VALID_THINKING_LEVELS.includes(level as ThinkingLevel);\r\n}\r\n\r\nexport function parseArgs(args: string[], extensionFlags?: Map<string, { type: \"boolean\" | \"string\" }>): Args {\r\n\tconst result: Args = {\r\n\t\tmessages: [],\r\n\t\tfileArgs: [],\r\n\t\tunknownFlags: new Map(),\r\n\t};\r\n\r\n\tfor (let i = 0; i < args.length; i++) {\r\n\t\tconst arg = args[i];\r\n\r\n\t\tif (arg === \"--help\" || arg === \"-h\") {\r\n\t\t\tresult.help = true;\r\n\t\t} else if (arg === \"--version\" || arg === \"-v\") {\r\n\t\t\tresult.version = true;\r\n\t\t} else if (arg === \"--mode\" && i + 1 < args.length) {\r\n\t\t\tconst mode = args[++i];\r\n\t\t\tif (mode === \"text\" || mode === \"json\" || mode === \"rpc\") {\r\n\t\t\t\tresult.mode = mode;\r\n\t\t\t}\r\n\t\t} else if (arg === \"--continue\" || arg === \"-c\") {\r\n\t\t\tresult.continue = true;\r\n\t\t} else if (arg === \"--resume\" || arg === \"-r\") {\r\n\t\t\tresult.resume = true;\r\n\t\t} else if (arg === \"--provider\" && i + 1 < args.length) {\r\n\t\t\tresult.provider = args[++i];\r\n\t\t} else if (arg === \"--model\" && i + 1 < args.length) {\r\n\t\t\tresult.model = args[++i];\r\n\t\t} else if (arg === \"--api-key\" && i + 1 < args.length) {\r\n\t\t\tresult.apiKey = args[++i];\r\n\t\t} else if (arg === \"--system-prompt\" && i + 1 < args.length) {\r\n\t\t\tresult.systemPrompt = args[++i];\r\n\t\t} else if (arg === \"--append-system-prompt\" && i + 1 < args.length) {\r\n\t\t\tresult.appendSystemPrompt = args[++i];\r\n\t\t} else if (arg === \"--no-session\") {\r\n\t\t\tresult.noSession = true;\r\n\t\t} else if (arg === \"--session\" && i + 1 < args.length) {\r\n\t\t\tresult.session = args[++i];\r\n\t\t} else if (arg === \"--session-dir\" && i + 1 < args.length) {\r\n\t\t\tresult.sessionDir = args[++i];\r\n\t\t} else if (arg === \"--models\" && i + 1 < args.length) {\r\n\t\t\tresult.models = args[++i].split(\",\").map((s) => s.trim());\r\n\t\t} else if (arg === \"--no-tools\") {\r\n\t\t\tresult.noTools = true;\r\n\t\t} else if (arg === \"--tools\" && i + 1 < args.length) {\r\n\t\t\tconst toolNames = args[++i].split(\",\").map((s) => s.trim());\r\n\t\t\tconst validTools: ToolName[] = [];\r\n\t\t\tfor (const name of toolNames) {\r\n\t\t\t\tif (name in allTools) {\r\n\t\t\t\t\tvalidTools.push(name as ToolName);\r\n\t\t\t\t} else {\r\n\t\t\t\t\tconsole.error(\r\n\t\t\t\t\t\tchalk.yellow(`Warning: Unknown tool \"${name}\". Valid tools: ${Object.keys(allTools).join(\", \")}`),\r\n\t\t\t\t\t);\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t\tresult.tools = validTools;\r\n\t\t} else if (arg === \"--thinking\" && i + 1 < args.length) {\r\n\t\t\tconst level = args[++i];\r\n\t\t\tif (isValidThinkingLevel(level)) {\r\n\t\t\t\tresult.thinking = level;\r\n\t\t\t} else {\r\n\t\t\t\tconsole.error(\r\n\t\t\t\t\tchalk.yellow(\r\n\t\t\t\t\t\t`Warning: Invalid thinking level \"${level}\". Valid values: ${VALID_THINKING_LEVELS.join(\", \")}`,\r\n\t\t\t\t\t),\r\n\t\t\t\t);\r\n\t\t\t}\r\n\t\t} else if (arg === \"--print\" || arg === \"-p\") {\r\n\t\t\tresult.print = true;\r\n\t\t} else if (arg === \"--export\" && i + 1 < args.length) {\r\n\t\t\tresult.export = args[++i];\r\n\t\t} else if ((arg === \"--extension\" || arg === \"-e\") && i + 1 < args.length) {\r\n\t\t\tresult.extensions = result.extensions ?? [];\r\n\t\t\tresult.extensions.push(args[++i]);\r\n\t\t} else if (arg === \"--no-extensions\" || arg === \"-ne\") {\r\n\t\t\tresult.noExtensions = true;\r\n\t\t} else if (arg === \"--skill\" && i + 1 < args.length) {\r\n\t\t\tresult.skills = result.skills ?? [];\r\n\t\t\tresult.skills.push(args[++i]);\r\n\t\t} else if (arg === \"--prompt-template\" && i + 1 < args.length) {\r\n\t\t\tresult.promptTemplates = result.promptTemplates ?? [];\r\n\t\t\tresult.promptTemplates.push(args[++i]);\r\n\t\t} else if (arg === \"--theme\" && i + 1 < args.length) {\r\n\t\t\tresult.themes = result.themes ?? [];\r\n\t\t\tresult.themes.push(args[++i]);\r\n\t\t} else if (arg === \"--no-skills\" || arg === \"-ns\") {\r\n\t\t\tresult.noSkills = true;\r\n\t\t} else if (arg === \"--no-prompt-templates\" || arg === \"-np\") {\r\n\t\t\tresult.noPromptTemplates = true;\r\n\t\t} else if (arg === \"--no-themes\") {\r\n\t\t\tresult.noThemes = true;\r\n\t\t} else if (arg === \"--list-models\") {\r\n\t\t\t// Check if next arg is a search pattern (not a flag or file arg)\r\n\t\t\tif (i + 1 < args.length && !args[i + 1].startsWith(\"-\") && !args[i + 1].startsWith(\"@\")) {\r\n\t\t\t\tresult.listModels = args[++i];\r\n\t\t\t} else {\r\n\t\t\t\tresult.listModels = true;\r\n\t\t\t}\r\n\t\t} else if (arg === \"--verbose\") {\r\n\t\t\tresult.verbose = true;\r\n\t\t} else if (arg.startsWith(\"@\")) {\r\n\t\t\tresult.fileArgs.push(arg.slice(1)); // Remove @ prefix\r\n\t\t} else if (arg.startsWith(\"--\") && extensionFlags) {\r\n\t\t\t// Check if it's an extension-registered flag\r\n\t\t\tconst flagName = arg.slice(2);\r\n\t\t\tconst extFlag = extensionFlags.get(flagName);\r\n\t\t\tif (extFlag) {\r\n\t\t\t\tif (extFlag.type === \"boolean\") {\r\n\t\t\t\t\tresult.unknownFlags.set(flagName, true);\r\n\t\t\t\t} else if (extFlag.type === \"string\" && i + 1 < args.length) {\r\n\t\t\t\t\tresult.unknownFlags.set(flagName, args[++i]);\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t\t// Unknown flags without extensionFlags are silently ignored (first pass)\r\n\t\t} else if (!arg.startsWith(\"-\")) {\r\n\t\t\tresult.messages.push(arg);\r\n\t\t}\r\n\t}\r\n\r\n\treturn result;\r\n}\r\n\r\nexport function printHelp(): void {\r\n\tconsole.log(`${chalk.bold(APP_NAME)} - AI coding assistant with read, bash, edit, write tools\r\n\r\n${chalk.bold(\"Usage:\")}\r\n  ${APP_NAME} [options] [@files...] [messages...]\r\n\r\n${chalk.bold(\"Commands:\")}\r\n  ${APP_NAME} install <source> [-l]    Install extension source and add to settings\r\n  ${APP_NAME} remove <source> [-l]     Remove extension source from settings\r\n  ${APP_NAME} update [source]          Update installed extensions (skips pinned sources)\r\n  ${APP_NAME} list                     List installed extensions from settings\r\n  ${APP_NAME} config                   Open TUI to enable/disable package resources\r\n  ${APP_NAME} <command> --help         Show help for install/remove/update/list\r\n\r\n${chalk.bold(\"Options:\")}\r\n  --provider <name>              Provider name (default: google)\r\n  --model <pattern>              Model pattern or ID (supports \"provider/id\" and optional \":<thinking>\")\r\n  --api-key <key>                API key (defaults to env vars)\r\n  --system-prompt <text>         System prompt (default: coding assistant prompt)\r\n  --append-system-prompt <text>  Append text or file contents to the system prompt\r\n  --mode <mode>                  Output mode: text (default), json, or rpc\r\n  --print, -p                    Non-interactive mode: process prompt and exit\r\n  --continue, -c                 Continue previous session\r\n  --resume, -r                   Select a session to resume\r\n  --session <path>               Use specific session file\r\n  --session-dir <dir>            Directory for session storage and lookup\r\n  --no-session                   Don't save session (ephemeral)\r\n  --models <patterns>            Comma-separated model patterns for Ctrl+P cycling\r\n                                 Supports globs (anthropic/*, *sonnet*) and fuzzy matching\r\n  --no-tools                     Disable all built-in tools\r\n  --tools <tools>                Comma-separated list of tools to enable (default: read,bash,edit,write)\r\n                                 Available: read, bash, edit, write, grep, find, ls\r\n  --thinking <level>             Set thinking level: off, minimal, low, medium, high, xhigh\r\n  --extension, -e <path>         Load an extension file (can be used multiple times)\r\n  --no-extensions, -ne           Disable extension discovery (explicit -e paths still work)\r\n  --skill <path>                 Load a skill file or directory (can be used multiple times)\r\n  --no-skills, -ns               Disable skills discovery and loading\r\n  --prompt-template <path>       Load a prompt template file or directory (can be used multiple times)\r\n  --no-prompt-templates, -np     Disable prompt template discovery and loading\r\n  --theme <path>                 Load a theme file or directory (can be used multiple times)\r\n  --no-themes                    Disable theme discovery and loading\r\n  --export <file>                Export session file to HTML and exit\r\n  --list-models [search]         List available models (with optional fuzzy search)\r\n  --verbose                      Force verbose startup (overrides quietStartup setting)\r\n  --help, -h                     Show this help\r\n  --version, -v                  Show version number\r\n\r\nExtensions can register additional flags (e.g., --plan from plan-mode extension).\r\n\r\n${chalk.bold(\"Examples:\")}\r\n  # Interactive mode\r\n  ${APP_NAME}\r\n\r\n  # Interactive mode with initial prompt\r\n  ${APP_NAME} \"List all .ts files in src/\"\r\n\r\n  # Include files in initial message\r\n  ${APP_NAME} @prompt.md @image.png \"What color is the sky?\"\r\n\r\n  # Non-interactive mode (process and exit)\r\n  ${APP_NAME} -p \"List all .ts files in src/\"\r\n\r\n  # Multiple messages (interactive)\r\n  ${APP_NAME} \"Read package.json\" \"What dependencies do we have?\"\r\n\r\n  # Continue previous session\r\n  ${APP_NAME} --continue \"What did we discuss?\"\r\n\r\n  # Use different model\r\n  ${APP_NAME} --provider openai --model gpt-4o-mini \"Help me refactor this code\"\r\n\r\n  # Use model with provider prefix (no --provider needed)\r\n  ${APP_NAME} --model openai/gpt-4o \"Help me refactor this code\"\r\n\r\n  # Use model with thinking level shorthand\r\n  ${APP_NAME} --model sonnet:high \"Solve this complex problem\"\r\n\r\n  # Limit model cycling to specific models\r\n  ${APP_NAME} --models claude-sonnet,claude-haiku,gpt-4o\r\n\r\n  # Limit to a specific provider with glob pattern\r\n  ${APP_NAME} --models \"github-copilot/*\"\r\n\r\n  # Cycle models with fixed thinking levels\r\n  ${APP_NAME} --models sonnet:high,haiku:low\r\n\r\n  # Start with a specific thinking level\r\n  ${APP_NAME} --thinking high \"Solve this complex problem\"\r\n\r\n  # Read-only mode (no file modifications possible)\r\n  ${APP_NAME} --tools read,grep,find,ls -p \"Review the code in src/\"\r\n\r\n  # Export a session file to HTML\r\n  ${APP_NAME} --export ~/${CONFIG_DIR_NAME}/agent/sessions/--path--/session.jsonl\r\n  ${APP_NAME} --export session.jsonl output.html\r\n\r\n${chalk.bold(\"Environment Variables:\")}\r\n  ANTHROPIC_API_KEY                - Anthropic Claude API key\r\n  ANTHROPIC_OAUTH_TOKEN            - Anthropic OAuth token (alternative to API key)\r\n  OPENAI_API_KEY                   - OpenAI GPT API key\r\n  AZURE_OPENAI_API_KEY             - Azure OpenAI API key\r\n  AZURE_OPENAI_BASE_URL            - Azure OpenAI base URL (https://{resource}.openai.azure.com/openai/v1)\r\n  AZURE_OPENAI_RESOURCE_NAME       - Azure OpenAI resource name (alternative to base URL)\r\n  AZURE_OPENAI_API_VERSION         - Azure OpenAI API version (default: v1)\r\n  AZURE_OPENAI_DEPLOYMENT_NAME_MAP - Azure OpenAI model=deployment map (comma-separated)\r\n  GEMINI_API_KEY                   - Google Gemini API key\r\n  GROQ_API_KEY                     - Groq API key\r\n  CEREBRAS_API_KEY                 - Cerebras API key\r\n  XAI_API_KEY                      - xAI Grok API key\r\n  OPENROUTER_API_KEY               - OpenRouter API key\r\n  AI_GATEWAY_API_KEY               - Vercel AI Gateway API key\r\n  ZAI_API_KEY                      - ZAI API key\r\n  MISTRAL_API_KEY                  - Mistral API key\r\n  MINIMAX_API_KEY                  - MiniMax API key\r\n  KIMI_API_KEY                     - Kimi For Coding API key\r\n  AWS_PROFILE                      - AWS profile for Amazon Bedrock\r\n  AWS_ACCESS_KEY_ID                - AWS access key for Amazon Bedrock\r\n  AWS_SECRET_ACCESS_KEY            - AWS secret key for Amazon Bedrock\r\n  AWS_BEARER_TOKEN_BEDROCK         - Bedrock API key (bearer token)\r\n  AWS_REGION                       - AWS region for Amazon Bedrock (e.g., us-east-1)\r\n  ${ENV_AGENT_DIR.padEnd(32)} - Session storage directory (default: ~/${CONFIG_DIR_NAME}/agent)\r\n  PI_PACKAGE_DIR                   - Override package directory (for Nix/Guix store paths)\r\n  PI_SHARE_VIEWER_URL              - Base URL for /share command (default: https://pi.dev/session/)\r\n  PI_AI_ANTIGRAVITY_VERSION        - Override Antigravity User-Agent version (e.g., 1.23.0)\r\n\r\n${chalk.bold(\"Available Tools (default: read, bash, edit, write):\")}\r\n  read   - Read file contents\r\n  bash   - Execute bash commands\r\n  edit   - Edit files with find/replace\r\n  write  - Write files (creates/overwrites)\r\n  grep   - Search file contents (read-only, off by default)\r\n  find   - Find files by glob pattern (read-only, off by default)\r\n  ls     - List directory contents (read-only, off by default)\r\n`);\r\n}\r\n"]}

package/dist/cli/args.js

@@ -0,0 +1,293 @@
+/**
+ * CLI argument parsing and help display
+ */
+import chalk from "chalk";
+import { APP_NAME, CONFIG_DIR_NAME, ENV_AGENT_DIR } from "../config.js";
+import { allTools } from "../core/tools/index.js";
+const VALID_THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh"];
+export function isValidThinkingLevel(level) {
+    return VALID_THINKING_LEVELS.includes(level);
+}
+export function parseArgs(args, extensionFlags) {
+    const result = {
+        messages: [],
+        fileArgs: [],
+        unknownFlags: new Map(),
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--help" || arg === "-h") {
+            result.help = true;
+        }
+        else if (arg === "--version" || arg === "-v") {
+            result.version = true;
+        }
+        else if (arg === "--mode" && i + 1 < args.length) {
+            const mode = args[++i];
+            if (mode === "text" || mode === "json" || mode === "rpc") {
+                result.mode = mode;
+            }
+        }
+        else if (arg === "--continue" || arg === "-c") {
+            result.continue = true;
+        }
+        else if (arg === "--resume" || arg === "-r") {
+            result.resume = true;
+        }
+        else if (arg === "--provider" && i + 1 < args.length) {
+            result.provider = args[++i];
+        }
+        else if (arg === "--model" && i + 1 < args.length) {
+            result.model = args[++i];
+        }
+        else if (arg === "--api-key" && i + 1 < args.length) {
+            result.apiKey = args[++i];
+        }
+        else if (arg === "--system-prompt" && i + 1 < args.length) {
+            result.systemPrompt = args[++i];
+        }
+        else if (arg === "--append-system-prompt" && i + 1 < args.length) {
+            result.appendSystemPrompt = args[++i];
+        }
+        else if (arg === "--no-session") {
+            result.noSession = true;
+        }
+        else if (arg === "--session" && i + 1 < args.length) {
+            result.session = args[++i];
+        }
+        else if (arg === "--session-dir" && i + 1 < args.length) {
+            result.sessionDir = args[++i];
+        }
+        else if (arg === "--models" && i + 1 < args.length) {
+            result.models = args[++i].split(",").map((s) => s.trim());
+        }
+        else if (arg === "--no-tools") {
+            result.noTools = true;
+        }
+        else if (arg === "--tools" && i + 1 < args.length) {
+            const toolNames = args[++i].split(",").map((s) => s.trim());
+            const validTools = [];
+            for (const name of toolNames) {
+                if (name in allTools) {
+                    validTools.push(name);
+                }
+                else {
+                    console.error(chalk.yellow(`Warning: Unknown tool "${name}". Valid tools: ${Object.keys(allTools).join(", ")}`));
+                }
+            }
+            result.tools = validTools;
+        }
+        else if (arg === "--thinking" && i + 1 < args.length) {
+            const level = args[++i];
+            if (isValidThinkingLevel(level)) {
+                result.thinking = level;
+            }
+            else {
+                console.error(chalk.yellow(`Warning: Invalid thinking level "${level}". Valid values: ${VALID_THINKING_LEVELS.join(", ")}`));
+            }
+        }
+        else if (arg === "--print" || arg === "-p") {
+            result.print = true;
+        }
+        else if (arg === "--export" && i + 1 < args.length) {
+            result.export = args[++i];
+        }
+        else if ((arg === "--extension" || arg === "-e") && i + 1 < args.length) {
+            result.extensions = result.extensions ?? [];
+            result.extensions.push(args[++i]);
+        }
+        else if (arg === "--no-extensions" || arg === "-ne") {
+            result.noExtensions = true;
+        }
+        else if (arg === "--skill" && i + 1 < args.length) {
+            result.skills = result.skills ?? [];
+            result.skills.push(args[++i]);
+        }
+        else if (arg === "--prompt-template" && i + 1 < args.length) {
+            result.promptTemplates = result.promptTemplates ?? [];
+            result.promptTemplates.push(args[++i]);
+        }
+        else if (arg === "--theme" && i + 1 < args.length) {
+            result.themes = result.themes ?? [];
+            result.themes.push(args[++i]);
+        }
+        else if (arg === "--no-skills" || arg === "-ns") {
+            result.noSkills = true;
+        }
+        else if (arg === "--no-prompt-templates" || arg === "-np") {
+            result.noPromptTemplates = true;
+        }
+        else if (arg === "--no-themes") {
+            result.noThemes = true;
+        }
+        else if (arg === "--list-models") {
+            // Check if next arg is a search pattern (not a flag or file arg)
+            if (i + 1 < args.length && !args[i + 1].startsWith("-") && !args[i + 1].startsWith("@")) {
+                result.listModels = args[++i];
+            }
+            else {
+                result.listModels = true;
+            }
+        }
+        else if (arg === "--verbose") {
+            result.verbose = true;
+        }
+        else if (arg.startsWith("@")) {
+            result.fileArgs.push(arg.slice(1)); // Remove @ prefix
+        }
+        else if (arg.startsWith("--") && extensionFlags) {
+            // Check if it's an extension-registered flag
+            const flagName = arg.slice(2);
+            const extFlag = extensionFlags.get(flagName);
+            if (extFlag) {
+                if (extFlag.type === "boolean") {
+                    result.unknownFlags.set(flagName, true);
+                }
+                else if (extFlag.type === "string" && i + 1 < args.length) {
+                    result.unknownFlags.set(flagName, args[++i]);
+                }
+            }
+            // Unknown flags without extensionFlags are silently ignored (first pass)
+        }
+        else if (!arg.startsWith("-")) {
+            result.messages.push(arg);
+        }
+    }
+    return result;
+}
+export function printHelp() {
+    console.log(`${chalk.bold(APP_NAME)} - AI coding assistant with read, bash, edit, write tools
+
+${chalk.bold("Usage:")}
+  ${APP_NAME} [options] [@files...] [messages...]
+
+${chalk.bold("Commands:")}
+  ${APP_NAME} install <source> [-l]    Install extension source and add to settings
+  ${APP_NAME} remove <source> [-l]     Remove extension source from settings
+  ${APP_NAME} update [source]          Update installed extensions (skips pinned sources)
+  ${APP_NAME} list                     List installed extensions from settings
+  ${APP_NAME} config                   Open TUI to enable/disable package resources
+  ${APP_NAME} <command> --help         Show help for install/remove/update/list
+
+${chalk.bold("Options:")}
+  --provider <name>              Provider name (default: google)
+  --model <pattern>              Model pattern or ID (supports "provider/id" and optional ":<thinking>")
+  --api-key <key>                API key (defaults to env vars)
+  --system-prompt <text>         System prompt (default: coding assistant prompt)
+  --append-system-prompt <text>  Append text or file contents to the system prompt
+  --mode <mode>                  Output mode: text (default), json, or rpc
+  --print, -p                    Non-interactive mode: process prompt and exit
+  --continue, -c                 Continue previous session
+  --resume, -r                   Select a session to resume
+  --session <path>               Use specific session file
+  --session-dir <dir>            Directory for session storage and lookup
+  --no-session                   Don't save session (ephemeral)
+  --models <patterns>            Comma-separated model patterns for Ctrl+P cycling
+                                 Supports globs (anthropic/*, *sonnet*) and fuzzy matching
+  --no-tools                     Disable all built-in tools
+  --tools <tools>                Comma-separated list of tools to enable (default: read,bash,edit,write)
+                                 Available: read, bash, edit, write, grep, find, ls
+  --thinking <level>             Set thinking level: off, minimal, low, medium, high, xhigh
+  --extension, -e <path>         Load an extension file (can be used multiple times)
+  --no-extensions, -ne           Disable extension discovery (explicit -e paths still work)
+  --skill <path>                 Load a skill file or directory (can be used multiple times)
+  --no-skills, -ns               Disable skills discovery and loading
+  --prompt-template <path>       Load a prompt template file or directory (can be used multiple times)
+  --no-prompt-templates, -np     Disable prompt template discovery and loading
+  --theme <path>                 Load a theme file or directory (can be used multiple times)
+  --no-themes                    Disable theme discovery and loading
+  --export <file>                Export session file to HTML and exit
+  --list-models [search]         List available models (with optional fuzzy search)
+  --verbose                      Force verbose startup (overrides quietStartup setting)
+  --help, -h                     Show this help
+  --version, -v                  Show version number
+
+Extensions can register additional flags (e.g., --plan from plan-mode extension).
+
+${chalk.bold("Examples:")}
+  # Interactive mode
+  ${APP_NAME}
+
+  # Interactive mode with initial prompt
+  ${APP_NAME} "List all .ts files in src/"
+
+  # Include files in initial message
+  ${APP_NAME} @prompt.md @image.png "What color is the sky?"
+
+  # Non-interactive mode (process and exit)
+  ${APP_NAME} -p "List all .ts files in src/"
+
+  # Multiple messages (interactive)
+  ${APP_NAME} "Read package.json" "What dependencies do we have?"
+
+  # Continue previous session
+  ${APP_NAME} --continue "What did we discuss?"
+
+  # Use different model
+  ${APP_NAME} --provider openai --model gpt-4o-mini "Help me refactor this code"
+
+  # Use model with provider prefix (no --provider needed)
+  ${APP_NAME} --model openai/gpt-4o "Help me refactor this code"
+
+  # Use model with thinking level shorthand
+  ${APP_NAME} --model sonnet:high "Solve this complex problem"
+
+  # Limit model cycling to specific models
+  ${APP_NAME} --models claude-sonnet,claude-haiku,gpt-4o
+
+  # Limit to a specific provider with glob pattern
+  ${APP_NAME} --models "github-copilot/*"
+
+  # Cycle models with fixed thinking levels
+  ${APP_NAME} --models sonnet:high,haiku:low
+
+  # Start with a specific thinking level
+  ${APP_NAME} --thinking high "Solve this complex problem"
+
+  # Read-only mode (no file modifications possible)
+  ${APP_NAME} --tools read,grep,find,ls -p "Review the code in src/"
+
+  # Export a session file to HTML
+  ${APP_NAME} --export ~/${CONFIG_DIR_NAME}/agent/sessions/--path--/session.jsonl
+  ${APP_NAME} --export session.jsonl output.html
+
+${chalk.bold("Environment Variables:")}
+  ANTHROPIC_API_KEY                - Anthropic Claude API key
+  ANTHROPIC_OAUTH_TOKEN            - Anthropic OAuth token (alternative to API key)
+  OPENAI_API_KEY                   - OpenAI GPT API key
+  AZURE_OPENAI_API_KEY             - Azure OpenAI API key
+  AZURE_OPENAI_BASE_URL            - Azure OpenAI base URL (https://{resource}.openai.azure.com/openai/v1)
+  AZURE_OPENAI_RESOURCE_NAME       - Azure OpenAI resource name (alternative to base URL)
+  AZURE_OPENAI_API_VERSION         - Azure OpenAI API version (default: v1)
+  AZURE_OPENAI_DEPLOYMENT_NAME_MAP - Azure OpenAI model=deployment map (comma-separated)
+  GEMINI_API_KEY                   - Google Gemini API key
+  GROQ_API_KEY                     - Groq API key
+  CEREBRAS_API_KEY                 - Cerebras API key
+  XAI_API_KEY                      - xAI Grok API key
+  OPENROUTER_API_KEY               - OpenRouter API key
+  AI_GATEWAY_API_KEY               - Vercel AI Gateway API key
+  ZAI_API_KEY                      - ZAI API key
+  MISTRAL_API_KEY                  - Mistral API key
+  MINIMAX_API_KEY                  - MiniMax API key
+  KIMI_API_KEY                     - Kimi For Coding API key
+  AWS_PROFILE                      - AWS profile for Amazon Bedrock
+  AWS_ACCESS_KEY_ID                - AWS access key for Amazon Bedrock
+  AWS_SECRET_ACCESS_KEY            - AWS secret key for Amazon Bedrock
+  AWS_BEARER_TOKEN_BEDROCK         - Bedrock API key (bearer token)
+  AWS_REGION                       - AWS region for Amazon Bedrock (e.g., us-east-1)
+  ${ENV_AGENT_DIR.padEnd(32)} - Session storage directory (default: ~/${CONFIG_DIR_NAME}/agent)
+  PI_PACKAGE_DIR                   - Override package directory (for Nix/Guix store paths)
+  PI_SHARE_VIEWER_URL              - Base URL for /share command (default: https://pi.dev/session/)
+  PI_AI_ANTIGRAVITY_VERSION        - Override Antigravity User-Agent version (e.g., 1.23.0)
+
+${chalk.bold("Available Tools (default: read, bash, edit, write):")}
+  read   - Read file contents
+  bash   - Execute bash commands
+  edit   - Edit files with find/replace
+  write  - Write files (creates/overwrites)
+  grep   - Search file contents (read-only, off by default)
+  find   - Find files by glob pattern (read-only, off by default)
+  ls     - List directory contents (read-only, off by default)
+`);
+}
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * CLI argument parsing and help display\r\n */\r\n\r\nimport type { ThinkingLevel } from \"@mariozechner/pi-agent-core\";\r\nimport chalk from \"chalk\";\r\nimport { APP_NAME, CONFIG_DIR_NAME, ENV_AGENT_DIR } from \"../config.js\";\r\nimport { allTools, type ToolName } from \"../core/tools/index.js\";\r\n\r\nexport type Mode = \"text\" | \"json\" | \"rpc\";\r\n\r\nexport interface Args {\r\n\tprovider?: string;\r\n\tmodel?: string;\r\n\tapiKey?: string;\r\n\tsystemPrompt?: string;\r\n\tappendSystemPrompt?: string;\r\n\tthinking?: ThinkingLevel;\r\n\tcontinue?: boolean;\r\n\tresume?: boolean;\r\n\thelp?: boolean;\r\n\tversion?: boolean;\r\n\tmode?: Mode;\r\n\tnoSession?: boolean;\r\n\tsession?: string;\r\n\tsessionDir?: string;\r\n\tmodels?: string[];\r\n\ttools?: ToolName[];\r\n\tnoTools?: boolean;\r\n\textensions?: string[];\r\n\tnoExtensions?: boolean;\r\n\tprint?: boolean;\r\n\texport?: string;\r\n\tnoSkills?: boolean;\r\n\tskills?: string[];\r\n\tpromptTemplates?: string[];\r\n\tnoPromptTemplates?: boolean;\r\n\tthemes?: string[];\r\n\tnoThemes?: boolean;\r\n\tlistModels?: string | true;\r\n\tverbose?: boolean;\r\n\tmessages: string[];\r\n\tfileArgs: string[];\r\n\t/** Unknown flags (potentially extension flags) - map of flag name to value */\r\n\tunknownFlags: Map<string, boolean | string>;\r\n}\r\n\r\nconst VALID_THINKING_LEVELS = [\"off\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\"] as const;\r\n\r\nexport function isValidThinkingLevel(level: string): level is ThinkingLevel {\r\n\treturn VALID_THINKING_LEVELS.includes(level as ThinkingLevel);\r\n}\r\n\r\nexport function parseArgs(args: string[], extensionFlags?: Map<string, { type: \"boolean\" | \"string\" }>): Args {\r\n\tconst result: Args = {\r\n\t\tmessages: [],\r\n\t\tfileArgs: [],\r\n\t\tunknownFlags: new Map(),\r\n\t};\r\n\r\n\tfor (let i = 0; i < args.length; i++) {\r\n\t\tconst arg = args[i];\r\n\r\n\t\tif (arg === \"--help\" || arg === \"-h\") {\r\n\t\t\tresult.help = true;\r\n\t\t} else if (arg === \"--version\" || arg === \"-v\") {\r\n\t\t\tresult.version = true;\r\n\t\t} else if (arg === \"--mode\" && i + 1 < args.length) {\r\n\t\t\tconst mode = args[++i];\r\n\t\t\tif (mode === \"text\" || mode === \"json\" || mode === \"rpc\") {\r\n\t\t\t\tresult.mode = mode;\r\n\t\t\t}\r\n\t\t} else if (arg === \"--continue\" || arg === \"-c\") {\r\n\t\t\tresult.continue = true;\r\n\t\t} else if (arg === \"--resume\" || arg === \"-r\") {\r\n\t\t\tresult.resume = true;\r\n\t\t} else if (arg === \"--provider\" && i + 1 < args.length) {\r\n\t\t\tresult.provider = args[++i];\r\n\t\t} else if (arg === \"--model\" && i + 1 < args.length) {\r\n\t\t\tresult.model = args[++i];\r\n\t\t} else if (arg === \"--api-key\" && i + 1 < args.length) {\r\n\t\t\tresult.apiKey = args[++i];\r\n\t\t} else if (arg === \"--system-prompt\" && i + 1 < args.length) {\r\n\t\t\tresult.systemPrompt = args[++i];\r\n\t\t} else if (arg === \"--append-system-prompt\" && i + 1 < args.length) {\r\n\t\t\tresult.appendSystemPrompt = args[++i];\r\n\t\t} else if (arg === \"--no-session\") {\r\n\t\t\tresult.noSession = true;\r\n\t\t} else if (arg === \"--session\" && i + 1 < args.length) {\r\n\t\t\tresult.session = args[++i];\r\n\t\t} else if (arg === \"--session-dir\" && i + 1 < args.length) {\r\n\t\t\tresult.sessionDir = args[++i];\r\n\t\t} else if (arg === \"--models\" && i + 1 < args.length) {\r\n\t\t\tresult.models = args[++i].split(\",\").map((s) => s.trim());\r\n\t\t} else if (arg === \"--no-tools\") {\r\n\t\t\tresult.noTools = true;\r\n\t\t} else if (arg === \"--tools\" && i + 1 < args.length) {\r\n\t\t\tconst toolNames = args[++i].split(\",\").map((s) => s.trim());\r\n\t\t\tconst validTools: ToolName[] = [];\r\n\t\t\tfor (const name of toolNames) {\r\n\t\t\t\tif (name in allTools) {\r\n\t\t\t\t\tvalidTools.push(name as ToolName);\r\n\t\t\t\t} else {\r\n\t\t\t\t\tconsole.error(\r\n\t\t\t\t\t\tchalk.yellow(`Warning: Unknown tool \"${name}\". Valid tools: ${Object.keys(allTools).join(\", \")}`),\r\n\t\t\t\t\t);\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t\tresult.tools = validTools;\r\n\t\t} else if (arg === \"--thinking\" && i + 1 < args.length) {\r\n\t\t\tconst level = args[++i];\r\n\t\t\tif (isValidThinkingLevel(level)) {\r\n\t\t\t\tresult.thinking = level;\r\n\t\t\t} else {\r\n\t\t\t\tconsole.error(\r\n\t\t\t\t\tchalk.yellow(\r\n\t\t\t\t\t\t`Warning: Invalid thinking level \"${level}\". Valid values: ${VALID_THINKING_LEVELS.join(\", \")}`,\r\n\t\t\t\t\t),\r\n\t\t\t\t);\r\n\t\t\t}\r\n\t\t} else if (arg === \"--print\" || arg === \"-p\") {\r\n\t\t\tresult.print = true;\r\n\t\t} else if (arg === \"--export\" && i + 1 < args.length) {\r\n\t\t\tresult.export = args[++i];\r\n\t\t} else if ((arg === \"--extension\" || arg === \"-e\") && i + 1 < args.length) {\r\n\t\t\tresult.extensions = result.extensions ?? [];\r\n\t\t\tresult.extensions.push(args[++i]);\r\n\t\t} else if (arg === \"--no-extensions\" || arg === \"-ne\") {\r\n\t\t\tresult.noExtensions = true;\r\n\t\t} else if (arg === \"--skill\" && i + 1 < args.length) {\r\n\t\t\tresult.skills = result.skills ?? [];\r\n\t\t\tresult.skills.push(args[++i]);\r\n\t\t} else if (arg === \"--prompt-template\" && i + 1 < args.length) {\r\n\t\t\tresult.promptTemplates = result.promptTemplates ?? [];\r\n\t\t\tresult.promptTemplates.push(args[++i]);\r\n\t\t} else if (arg === \"--theme\" && i + 1 < args.length) {\r\n\t\t\tresult.themes = result.themes ?? [];\r\n\t\t\tresult.themes.push(args[++i]);\r\n\t\t} else if (arg === \"--no-skills\" || arg === \"-ns\") {\r\n\t\t\tresult.noSkills = true;\r\n\t\t} else if (arg === \"--no-prompt-templates\" || arg === \"-np\") {\r\n\t\t\tresult.noPromptTemplates = true;\r\n\t\t} else if (arg === \"--no-themes\") {\r\n\t\t\tresult.noThemes = true;\r\n\t\t} else if (arg === \"--list-models\") {\r\n\t\t\t// Check if next arg is a search pattern (not a flag or file arg)\r\n\t\t\tif (i + 1 < args.length && !args[i + 1].startsWith(\"-\") && !args[i + 1].startsWith(\"@\")) {\r\n\t\t\t\tresult.listModels = args[++i];\r\n\t\t\t} else {\r\n\t\t\t\tresult.listModels = true;\r\n\t\t\t}\r\n\t\t} else if (arg === \"--verbose\") {\r\n\t\t\tresult.verbose = true;\r\n\t\t} else if (arg.startsWith(\"@\")) {\r\n\t\t\tresult.fileArgs.push(arg.slice(1)); // Remove @ prefix\r\n\t\t} else if (arg.startsWith(\"--\") && extensionFlags) {\r\n\t\t\t// Check if it's an extension-registered flag\r\n\t\t\tconst flagName = arg.slice(2);\r\n\t\t\tconst extFlag = extensionFlags.get(flagName);\r\n\t\t\tif (extFlag) {\r\n\t\t\t\tif (extFlag.type === \"boolean\") {\r\n\t\t\t\t\tresult.unknownFlags.set(flagName, true);\r\n\t\t\t\t} else if (extFlag.type === \"string\" && i + 1 < args.length) {\r\n\t\t\t\t\tresult.unknownFlags.set(flagName, args[++i]);\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t\t// Unknown flags without extensionFlags are silently ignored (first pass)\r\n\t\t} else if (!arg.startsWith(\"-\")) {\r\n\t\t\tresult.messages.push(arg);\r\n\t\t}\r\n\t}\r\n\r\n\treturn result;\r\n}\r\n\r\nexport function printHelp(): void {\r\n\tconsole.log(`${chalk.bold(APP_NAME)} - AI coding assistant with read, bash, edit, write tools\r\n\r\n${chalk.bold(\"Usage:\")}\r\n  ${APP_NAME} [options] [@files...] [messages...]\r\n\r\n${chalk.bold(\"Commands:\")}\r\n  ${APP_NAME} install <source> [-l]    Install extension source and add to settings\r\n  ${APP_NAME} remove <source> [-l]     Remove extension source from settings\r\n  ${APP_NAME} update [source]          Update installed extensions (skips pinned sources)\r\n  ${APP_NAME} list                     List installed extensions from settings\r\n  ${APP_NAME} config                   Open TUI to enable/disable package resources\r\n  ${APP_NAME} <command> --help         Show help for install/remove/update/list\r\n\r\n${chalk.bold(\"Options:\")}\r\n  --provider <name>              Provider name (default: google)\r\n  --model <pattern>              Model pattern or ID (supports \"provider/id\" and optional \":<thinking>\")\r\n  --api-key <key>                API key (defaults to env vars)\r\n  --system-prompt <text>         System prompt (default: coding assistant prompt)\r\n  --append-system-prompt <text>  Append text or file contents to the system prompt\r\n  --mode <mode>                  Output mode: text (default), json, or rpc\r\n  --print, -p                    Non-interactive mode: process prompt and exit\r\n  --continue, -c                 Continue previous session\r\n  --resume, -r                   Select a session to resume\r\n  --session <path>               Use specific session file\r\n  --session-dir <dir>            Directory for session storage and lookup\r\n  --no-session                   Don't save session (ephemeral)\r\n  --models <patterns>            Comma-separated model patterns for Ctrl+P cycling\r\n                                 Supports globs (anthropic/*, *sonnet*) and fuzzy matching\r\n  --no-tools                     Disable all built-in tools\r\n  --tools <tools>                Comma-separated list of tools to enable (default: read,bash,edit,write)\r\n                                 Available: read, bash, edit, write, grep, find, ls\r\n  --thinking <level>             Set thinking level: off, minimal, low, medium, high, xhigh\r\n  --extension, -e <path>         Load an extension file (can be used multiple times)\r\n  --no-extensions, -ne           Disable extension discovery (explicit -e paths still work)\r\n  --skill <path>                 Load a skill file or directory (can be used multiple times)\r\n  --no-skills, -ns               Disable skills discovery and loading\r\n  --prompt-template <path>       Load a prompt template file or directory (can be used multiple times)\r\n  --no-prompt-templates, -np     Disable prompt template discovery and loading\r\n  --theme <path>                 Load a theme file or directory (can be used multiple times)\r\n  --no-themes                    Disable theme discovery and loading\r\n  --export <file>                Export session file to HTML and exit\r\n  --list-models [search]         List available models (with optional fuzzy search)\r\n  --verbose                      Force verbose startup (overrides quietStartup setting)\r\n  --help, -h                     Show this help\r\n  --version, -v                  Show version number\r\n\r\nExtensions can register additional flags (e.g., --plan from plan-mode extension).\r\n\r\n${chalk.bold(\"Examples:\")}\r\n  # Interactive mode\r\n  ${APP_NAME}\r\n\r\n  # Interactive mode with initial prompt\r\n  ${APP_NAME} \"List all .ts files in src/\"\r\n\r\n  # Include files in initial message\r\n  ${APP_NAME} @prompt.md @image.png \"What color is the sky?\"\r\n\r\n  # Non-interactive mode (process and exit)\r\n  ${APP_NAME} -p \"List all .ts files in src/\"\r\n\r\n  # Multiple messages (interactive)\r\n  ${APP_NAME} \"Read package.json\" \"What dependencies do we have?\"\r\n\r\n  # Continue previous session\r\n  ${APP_NAME} --continue \"What did we discuss?\"\r\n\r\n  # Use different model\r\n  ${APP_NAME} --provider openai --model gpt-4o-mini \"Help me refactor this code\"\r\n\r\n  # Use model with provider prefix (no --provider needed)\r\n  ${APP_NAME} --model openai/gpt-4o \"Help me refactor this code\"\r\n\r\n  # Use model with thinking level shorthand\r\n  ${APP_NAME} --model sonnet:high \"Solve this complex problem\"\r\n\r\n  # Limit model cycling to specific models\r\n  ${APP_NAME} --models claude-sonnet,claude-haiku,gpt-4o\r\n\r\n  # Limit to a specific provider with glob pattern\r\n  ${APP_NAME} --models \"github-copilot/*\"\r\n\r\n  # Cycle models with fixed thinking levels\r\n  ${APP_NAME} --models sonnet:high,haiku:low\r\n\r\n  # Start with a specific thinking level\r\n  ${APP_NAME} --thinking high \"Solve this complex problem\"\r\n\r\n  # Read-only mode (no file modifications possible)\r\n  ${APP_NAME} --tools read,grep,find,ls -p \"Review the code in src/\"\r\n\r\n  # Export a session file to HTML\r\n  ${APP_NAME} --export ~/${CONFIG_DIR_NAME}/agent/sessions/--path--/session.jsonl\r\n  ${APP_NAME} --export session.jsonl output.html\r\n\r\n${chalk.bold(\"Environment Variables:\")}\r\n  ANTHROPIC_API_KEY                - Anthropic Claude API key\r\n  ANTHROPIC_OAUTH_TOKEN            - Anthropic OAuth token (alternative to API key)\r\n  OPENAI_API_KEY                   - OpenAI GPT API key\r\n  AZURE_OPENAI_API_KEY             - Azure OpenAI API key\r\n  AZURE_OPENAI_BASE_URL            - Azure OpenAI base URL (https://{resource}.openai.azure.com/openai/v1)\r\n  AZURE_OPENAI_RESOURCE_NAME       - Azure OpenAI resource name (alternative to base URL)\r\n  AZURE_OPENAI_API_VERSION         - Azure OpenAI API version (default: v1)\r\n  AZURE_OPENAI_DEPLOYMENT_NAME_MAP - Azure OpenAI model=deployment map (comma-separated)\r\n  GEMINI_API_KEY                   - Google Gemini API key\r\n  GROQ_API_KEY                     - Groq API key\r\n  CEREBRAS_API_KEY                 - Cerebras API key\r\n  XAI_API_KEY                      - xAI Grok API key\r\n  OPENROUTER_API_KEY               - OpenRouter API key\r\n  AI_GATEWAY_API_KEY               - Vercel AI Gateway API key\r\n  ZAI_API_KEY                      - ZAI API key\r\n  MISTRAL_API_KEY                  - Mistral API key\r\n  MINIMAX_API_KEY                  - MiniMax API key\r\n  KIMI_API_KEY                     - Kimi For Coding API key\r\n  AWS_PROFILE                      - AWS profile for Amazon Bedrock\r\n  AWS_ACCESS_KEY_ID                - AWS access key for Amazon Bedrock\r\n  AWS_SECRET_ACCESS_KEY            - AWS secret key for Amazon Bedrock\r\n  AWS_BEARER_TOKEN_BEDROCK         - Bedrock API key (bearer token)\r\n  AWS_REGION                       - AWS region for Amazon Bedrock (e.g., us-east-1)\r\n  ${ENV_AGENT_DIR.padEnd(32)} - Session storage directory (default: ~/${CONFIG_DIR_NAME}/agent)\r\n  PI_PACKAGE_DIR                   - Override package directory (for Nix/Guix store paths)\r\n  PI_SHARE_VIEWER_URL              - Base URL for /share command (default: https://pi.dev/session/)\r\n  PI_AI_ANTIGRAVITY_VERSION        - Override Antigravity User-Agent version (e.g., 1.23.0)\r\n\r\n${chalk.bold(\"Available Tools (default: read, bash, edit, write):\")}\r\n  read   - Read file contents\r\n  bash   - Execute bash commands\r\n  edit   - Edit files with find/replace\r\n  write  - Write files (creates/overwrites)\r\n  grep   - Search file contents (read-only, off by default)\r\n  find   - Find files by glob pattern (read-only, off by default)\r\n  ls     - List directory contents (read-only, off by default)\r\n`);\r\n}\r\n"]}

package/dist/cli/config-selector.d.ts

@@ -0,0 +1,14 @@
+/**
+ * TUI config selector for `pi config` command
+ */
+import type { ResolvedPaths } from "../core/package-manager.js";
+import type { SettingsManager } from "../core/settings-manager.js";
+export interface ConfigSelectorOptions {
+    resolvedPaths: ResolvedPaths;
+    settingsManager: SettingsManager;
+    cwd: string;
+    agentDir: string;
+}
+/** Show TUI config selector and return when closed */
+export declare function selectConfig(options: ConfigSelectorOptions): Promise<void>;
+//# sourceMappingURL=config-selector.d.ts.map

package/dist/cli/config-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-selector.d.ts","sourceRoot":"","sources":["../../src/cli/config-selector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAInE,MAAM,WAAW,qBAAqB;IACrC,aAAa,EAAE,aAAa,CAAC;IAC7B,eAAe,EAAE,eAAe,CAAC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,sDAAsD;AACtD,wBAAsB,YAAY,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiChF","sourcesContent":["/**\r\n * TUI config selector for `pi config` command\r\n */\r\n\r\nimport { ProcessTerminal, TUI } from \"@mariozechner/pi-tui\";\r\nimport type { ResolvedPaths } from \"../core/package-manager.js\";\r\nimport type { SettingsManager } from \"../core/settings-manager.js\";\r\nimport { ConfigSelectorComponent } from \"../modes/interactive/components/config-selector.js\";\r\nimport { initTheme, stopThemeWatcher } from \"../modes/interactive/theme/theme.js\";\r\n\r\nexport interface ConfigSelectorOptions {\r\n\tresolvedPaths: ResolvedPaths;\r\n\tsettingsManager: SettingsManager;\r\n\tcwd: string;\r\n\tagentDir: string;\r\n}\r\n\r\n/** Show TUI config selector and return when closed */\r\nexport async function selectConfig(options: ConfigSelectorOptions): Promise<void> {\r\n\t// Initialize theme before showing TUI\r\n\tinitTheme(options.settingsManager.getTheme(), true);\r\n\r\n\treturn new Promise((resolve) => {\r\n\t\tconst ui = new TUI(new ProcessTerminal());\r\n\t\tlet resolved = false;\r\n\r\n\t\tconst selector = new ConfigSelectorComponent(\r\n\t\t\toptions.resolvedPaths,\r\n\t\t\toptions.settingsManager,\r\n\t\t\toptions.cwd,\r\n\t\t\toptions.agentDir,\r\n\t\t\t() => {\r\n\t\t\t\tif (!resolved) {\r\n\t\t\t\t\tresolved = true;\r\n\t\t\t\t\tui.stop();\r\n\t\t\t\t\tstopThemeWatcher();\r\n\t\t\t\t\tresolve();\r\n\t\t\t\t}\r\n\t\t\t},\r\n\t\t\t() => {\r\n\t\t\t\tui.stop();\r\n\t\t\t\tstopThemeWatcher();\r\n\t\t\t\tprocess.exit(0);\r\n\t\t\t},\r\n\t\t\t() => ui.requestRender(),\r\n\t\t);\r\n\r\n\t\tui.addChild(selector);\r\n\t\tui.setFocus(selector.getResourceList());\r\n\t\tui.start();\r\n\t});\r\n}\r\n"]}

package/dist/cli/config-selector.js

@@ -0,0 +1,31 @@
+/**
+ * TUI config selector for `pi config` command
+ */
+import { ProcessTerminal, TUI } from "@mariozechner/pi-tui";
+import { ConfigSelectorComponent } from "../modes/interactive/components/config-selector.js";
+import { initTheme, stopThemeWatcher } from "../modes/interactive/theme/theme.js";
+/** Show TUI config selector and return when closed */
+export async function selectConfig(options) {
+    // Initialize theme before showing TUI
+    initTheme(options.settingsManager.getTheme(), true);
+    return new Promise((resolve) => {
+        const ui = new TUI(new ProcessTerminal());
+        let resolved = false;
+        const selector = new ConfigSelectorComponent(options.resolvedPaths, options.settingsManager, options.cwd, options.agentDir, () => {
+            if (!resolved) {
+                resolved = true;
+                ui.stop();
+                stopThemeWatcher();
+                resolve();
+            }
+        }, () => {
+            ui.stop();
+            stopThemeWatcher();
+            process.exit(0);
+        }, () => ui.requestRender());
+        ui.addChild(selector);
+        ui.setFocus(selector.getResourceList());
+        ui.start();
+    });
+}
+//# sourceMappingURL=config-selector.js.map

package/dist/cli/config-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-selector.js","sourceRoot":"","sources":["../../src/cli/config-selector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAG5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,oDAAoD,CAAC;AAC7F,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AASlF,sDAAsD;AACtD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA8B,EAAiB;IACjF,sCAAsC;IACtC,SAAS,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,CAAC;IAEpD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/B,MAAM,EAAE,GAAG,IAAI,GAAG,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;QAC1C,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,MAAM,QAAQ,GAAG,IAAI,uBAAuB,CAC3C,OAAO,CAAC,aAAa,EACrB,OAAO,CAAC,eAAe,EACvB,OAAO,CAAC,GAAG,EACX,OAAO,CAAC,QAAQ,EAChB,GAAG,EAAE,CAAC;YACL,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACf,QAAQ,GAAG,IAAI,CAAC;gBAChB,EAAE,CAAC,IAAI,EAAE,CAAC;gBACV,gBAAgB,EAAE,CAAC;gBACnB,OAAO,EAAE,CAAC;YACX,CAAC;QAAA,CACD,EACD,GAAG,EAAE,CAAC;YACL,EAAE,CAAC,IAAI,EAAE,CAAC;YACV,gBAAgB,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAA,CAChB,EACD,GAAG,EAAE,CAAC,EAAE,CAAC,aAAa,EAAE,CACxB,CAAC;QAEF,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACtB,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAC;QACxC,EAAE,CAAC,KAAK,EAAE,CAAC;IAAA,CACX,CAAC,CAAC;AAAA,CACH","sourcesContent":["/**\r\n * TUI config selector for `pi config` command\r\n */\r\n\r\nimport { ProcessTerminal, TUI } from \"@mariozechner/pi-tui\";\r\nimport type { ResolvedPaths } from \"../core/package-manager.js\";\r\nimport type { SettingsManager } from \"../core/settings-manager.js\";\r\nimport { ConfigSelectorComponent } from \"../modes/interactive/components/config-selector.js\";\r\nimport { initTheme, stopThemeWatcher } from \"../modes/interactive/theme/theme.js\";\r\n\r\nexport interface ConfigSelectorOptions {\r\n\tresolvedPaths: ResolvedPaths;\r\n\tsettingsManager: SettingsManager;\r\n\tcwd: string;\r\n\tagentDir: string;\r\n}\r\n\r\n/** Show TUI config selector and return when closed */\r\nexport async function selectConfig(options: ConfigSelectorOptions): Promise<void> {\r\n\t// Initialize theme before showing TUI\r\n\tinitTheme(options.settingsManager.getTheme(), true);\r\n\r\n\treturn new Promise((resolve) => {\r\n\t\tconst ui = new TUI(new ProcessTerminal());\r\n\t\tlet resolved = false;\r\n\r\n\t\tconst selector = new ConfigSelectorComponent(\r\n\t\t\toptions.resolvedPaths,\r\n\t\t\toptions.settingsManager,\r\n\t\t\toptions.cwd,\r\n\t\t\toptions.agentDir,\r\n\t\t\t() => {\r\n\t\t\t\tif (!resolved) {\r\n\t\t\t\t\tresolved = true;\r\n\t\t\t\t\tui.stop();\r\n\t\t\t\t\tstopThemeWatcher();\r\n\t\t\t\t\tresolve();\r\n\t\t\t\t}\r\n\t\t\t},\r\n\t\t\t() => {\r\n\t\t\t\tui.stop();\r\n\t\t\t\tstopThemeWatcher();\r\n\t\t\t\tprocess.exit(0);\r\n\t\t\t},\r\n\t\t\t() => ui.requestRender(),\r\n\t\t);\r\n\r\n\t\tui.addChild(selector);\r\n\t\tui.setFocus(selector.getResourceList());\r\n\t\tui.start();\r\n\t});\r\n}\r\n"]}

package/dist/cli/file-processor.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Process @file CLI arguments into text content and image attachments
+ */
+import type { ImageContent } from "@mariozechner/pi-ai";
+export interface ProcessedFiles {
+    text: string;
+    images: ImageContent[];
+}
+export interface ProcessFileOptions {
+    /** Whether to auto-resize images to 2000x2000 max. Default: true */
+    autoResizeImages?: boolean;
+}
+/** Process @file arguments into text content and image attachments */
+export declare function processFileArguments(fileArgs: string[], options?: ProcessFileOptions): Promise<ProcessedFiles>;
+//# sourceMappingURL=file-processor.d.ts.map

package/dist/cli/file-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-processor.d.ts","sourceRoot":"","sources":["../../src/cli/file-processor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAOxD,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IAClC,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,sEAAsE;AACtE,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CAwEpH","sourcesContent":["/**\r\n * Process @file CLI arguments into text content and image attachments\r\n */\r\n\r\nimport { access, readFile, stat } from \"node:fs/promises\";\r\nimport type { ImageContent } from \"@mariozechner/pi-ai\";\r\nimport chalk from \"chalk\";\r\nimport { resolve } from \"path\";\r\nimport { resolveReadPath } from \"../core/tools/path-utils.js\";\r\nimport { formatDimensionNote, resizeImage } from \"../utils/image-resize.js\";\r\nimport { detectSupportedImageMimeTypeFromFile } from \"../utils/mime.js\";\r\n\r\nexport interface ProcessedFiles {\r\n\ttext: string;\r\n\timages: ImageContent[];\r\n}\r\n\r\nexport interface ProcessFileOptions {\r\n\t/** Whether to auto-resize images to 2000x2000 max. Default: true */\r\n\tautoResizeImages?: boolean;\r\n}\r\n\r\n/** Process @file arguments into text content and image attachments */\r\nexport async function processFileArguments(fileArgs: string[], options?: ProcessFileOptions): Promise<ProcessedFiles> {\r\n\tconst autoResizeImages = options?.autoResizeImages ?? true;\r\n\tlet text = \"\";\r\n\tconst images: ImageContent[] = [];\r\n\r\n\tfor (const fileArg of fileArgs) {\r\n\t\t// Expand and resolve path (handles ~ expansion and macOS screenshot Unicode spaces)\r\n\t\tconst absolutePath = resolve(resolveReadPath(fileArg, process.cwd()));\r\n\r\n\t\t// Check if file exists\r\n\t\ttry {\r\n\t\t\tawait access(absolutePath);\r\n\t\t} catch {\r\n\t\t\tconsole.error(chalk.red(`Error: File not found: ${absolutePath}`));\r\n\t\t\tprocess.exit(1);\r\n\t\t}\r\n\r\n\t\t// Check if file is empty\r\n\t\tconst stats = await stat(absolutePath);\r\n\t\tif (stats.size === 0) {\r\n\t\t\t// Skip empty files\r\n\t\t\tcontinue;\r\n\t\t}\r\n\r\n\t\tconst mimeType = await detectSupportedImageMimeTypeFromFile(absolutePath);\r\n\r\n\t\tif (mimeType) {\r\n\t\t\t// Handle image file\r\n\t\t\tconst content = await readFile(absolutePath);\r\n\t\t\tconst base64Content = content.toString(\"base64\");\r\n\r\n\t\t\tlet attachment: ImageContent;\r\n\t\t\tlet dimensionNote: string | undefined;\r\n\r\n\t\t\tif (autoResizeImages) {\r\n\t\t\t\tconst resized = await resizeImage({ type: \"image\", data: base64Content, mimeType });\r\n\t\t\t\tdimensionNote = formatDimensionNote(resized);\r\n\t\t\t\tattachment = {\r\n\t\t\t\t\ttype: \"image\",\r\n\t\t\t\t\tmimeType: resized.mimeType,\r\n\t\t\t\t\tdata: resized.data,\r\n\t\t\t\t};\r\n\t\t\t} else {\r\n\t\t\t\tattachment = {\r\n\t\t\t\t\ttype: \"image\",\r\n\t\t\t\t\tmimeType,\r\n\t\t\t\t\tdata: base64Content,\r\n\t\t\t\t};\r\n\t\t\t}\r\n\r\n\t\t\timages.push(attachment);\r\n\r\n\t\t\t// Add text reference to image with optional dimension note\r\n\t\t\tif (dimensionNote) {\r\n\t\t\t\ttext += `<file name=\"${absolutePath}\">${dimensionNote}</file>\\n`;\r\n\t\t\t} else {\r\n\t\t\t\ttext += `<file name=\"${absolutePath}\"></file>\\n`;\r\n\t\t\t}\r\n\t\t} else {\r\n\t\t\t// Handle text file\r\n\t\t\ttry {\r\n\t\t\t\tconst content = await readFile(absolutePath, \"utf-8\");\r\n\t\t\t\ttext += `<file name=\"${absolutePath}\">\\n${content}\\n</file>\\n`;\r\n\t\t\t} catch (error: unknown) {\r\n\t\t\t\tconst message = error instanceof Error ? error.message : String(error);\r\n\t\t\t\tconsole.error(chalk.red(`Error: Could not read file ${absolutePath}: ${message}`));\r\n\t\t\t\tprocess.exit(1);\r\n\t\t\t}\r\n\t\t}\r\n\t}\r\n\r\n\treturn { text, images };\r\n}\r\n"]}