@jx-grxf/patchpilot 0.2.0

package/.env.example

@@ -0,0 +1,13 @@
+# Provider options: ollama, gemini, openrouter, nvidia, codex.
+# codex uses your Codex CLI ChatGPT login. Run: codex login
+PATCHPILOT_PROVIDER=codex
+PATCHPILOT_MODEL=gpt-5.5
+
+# Only needed for API providers.
+GEMINI_API_KEY=your_gemini_api_key_here
+OPENROUTER_API_KEY=your_openrouter_api_key_here
+NVIDIA_API_KEY=your_nvidia_api_key_here
+
+# Optional tuning shared by local and API providers.
+PATCHPILOT_NUM_PREDICT=1024
+PATCHPILOT_TEMPERATURE=0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Johannes Grof
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,314 @@
+<div align="center">
+
+# PatchPilot
+
+**A local-first coding-agent TUI that makes repo changes visible, permissioned, and easy to review across local, remote, and cloud model routes.**
+
+[![CI](https://github.com/jx-grxf/PatchPilot/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/jx-grxf/PatchPilot/actions/workflows/ci.yml)
+![Status](https://img.shields.io/badge/status-public%20preview-0ea5e9)
+![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178C6?logo=typescript&logoColor=white)
+![Node](https://img.shields.io/badge/Node.js-22%2B-339933?logo=node.js&logoColor=white)
+![Ink](https://img.shields.io/badge/TUI-Ink-111827)
+![Ollama](https://img.shields.io/badge/LLM-Ollama-000000)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
+<p>
+  <strong>Visible tools.</strong> Explicit permissions. Local Ollama. Remote Ollama. Gemini. OpenRouter. NVIDIA. Codex.
+</p>
+
+</div>
+
+---
+
+## Showcase
+
+<p align="center">
+  <img src="docs/showcase/patchpilot-showcase.svg" alt="PatchPilot terminal interface overview" width="920">
+</p>
+
+PatchPilot is a terminal interface for running coding-agent tasks inside a repository. It shows what the agent is doing, keeps risky actions behind explicit permissions, and supports local Ollama, remote Ollama, Google Gemini, OpenRouter, NVIDIA NIM-compatible endpoints, and Codex CLI OAuth.
+
+---
+
+## Contents
+
+- [Highlights](#highlights)
+- [Why This Exists](#why-this-exists)
+- [Quick Start](#quick-start)
+- [Usage](#usage)
+- [Providers](#providers)
+- [Remote Ollama](#remote-ollama)
+- [Safety Model](#safety-model)
+- [Tech Stack](#tech-stack)
+- [Development](#development)
+- [Roadmap](#roadmap)
+- [Security and Legal](#security-and-legal)
+- [License](#license)
+
+## Highlights
+
+| Feature | What it means |
+|---|---|
+| Local-first by default | Uses Ollama on your own machine unless you choose another route. |
+| Remote GPU workflow | Connect your laptop TUI to an Ollama host on a desktop, LAN, or Tailscale machine. |
+| Cloud provider routes | Gemini, OpenRouter, NVIDIA, and Codex CLI OAuth are available from one TUI. |
+| Guided onboarding | First-run setup walks through local/remote mode, provider auth, host discovery, and model choice. |
+| Observable agent loop | Transcript, tool calls, telemetry, token counts, provider cache hits, latency, and cost estimates are visible. |
+| Explicit permissions | File writes require `--apply`; shell commands require `--allow-shell`. |
+| Workspace boundary | File tools are constrained to the selected project root and block common secret files. |
+| Slash-command palette | Type `/` for browsable commands, provider switching, modes, models, diagnostics, and host selection. |
+| Advisor subagents | Explorer, planner, and reviewer advisor calls can brief the main agent before it edits. |
+| Ollama eject | `/eject` unloads the active Ollama model; `/eject all` clears models PatchPilot used in the session. |
+| CI-ready TypeScript | Strict TypeScript, Vitest, GitHub Actions, and package verification are included. |
+
+## Why This Exists
+
+Most local coding-agent experiments fall into one of two traps: they are either raw scripts that feel painful to use, or polished tools that hide too much of what is happening. PatchPilot aims for the middle: a practical TUI where every file read, search, proposed write, command, model route, and token/cost signal stays visible.
+
+The core workflow is intentionally simple:
+
+1. Open a repository.
+2. Pick local, remote, or cloud inference.
+3. Ask for a patch, review, summary, or refactor plan.
+4. Enable writes or shell commands only when the current task needs them.
+5. Review the diff before committing.
+
+## Quick Start
+
+Install the public CLI globally:
+
+```bash
+npm install -g @jx-grxf/patchpilot
+```
+
+For source development, clone it, install dependencies, build it, and link the local CLI:
+
+```bash
+git clone https://github.com/jx-grxf/PatchPilot.git
+cd PatchPilot
+npm install
+npm run build
+npm link
+```
+
+For local Ollama inference:
+
+```bash
+ollama pull qwen2.5-coder:7b
+patchpilot doctor
+patchpilot
+```
+
+Then type a task inside the TUI:
+
+```text
+summarize this repository and point out the riskiest files
+```
+
+For a one-shot task from a different repository:
+
+```bash
+cd /path/to/your/project
+patchpilot "find likely test gaps in this repo"
+```
+
+Use build permissions only when you intentionally want PatchPilot to modify files or run commands:
+
+```bash
+patchpilot "add tests for the parser" --apply --allow-shell
+```
+
+API keys are stored by onboarding in `~/.patchpilot/.env`.
+
+## Usage
+
+```bash
+patchpilot [task] [options]
+patchpilot doctor [options]
+```
+
+| Option | Description |
+|---|---|
+| `--workspace <path>` | Project root the agent may inspect. Defaults to the current directory. |
+| `--provider <name>` | Model provider route. Supports `ollama`, `gemini`/`google`, `openrouter`/`open-router`, `nvidia`/`nim`, and `codex`/`openai`/`openai-codex`. |
+| `--model <name>` | Model name for the selected provider. |
+| `--ollama-url <url>` | Ollama base URL. Defaults to `http://127.0.0.1:11434`. |
+| `--steps <count>` | Maximum agent loop steps before stopping. |
+| `--thinking <mode>` | Step-budget mode: `fixed` or `adaptive`. |
+| `--reasoning <effort>` | Provider reasoning effort: `low`, `medium`, `high`, `xhigh`, or `adaptive`. |
+| `--apply` | Allows file writes inside the workspace. |
+| `--allow-shell` | Allows shell commands inside the workspace. |
+| `--no-subagents` | Disables explorer/planner/reviewer advisor calls for faster runs. |
+
+Useful slash commands inside the TUI:
+
+| Command | Description |
+|---|---|
+| `/help` | Show available commands. |
+| `/help <command>` | Explain one command, for example `/help think` or `/help model`. |
+| `/onboarding` | Open guided provider/auth/model setup. |
+| `/mode plan` | Read-only planning mode. |
+| `/mode build` | Implementation mode; writes and shell can still be toggled separately. |
+| `/think fixed\|adaptive` | Switch between fixed and adaptive step budgets. |
+| `/reasoning low\|medium\|high\|xhigh\|adaptive` | Set provider reasoning effort where supported. |
+| `/write on\|off` | Enable or disable workspace writes. |
+| `/shell on\|off` | Enable or disable shell commands. |
+| `/agents on\|off` | Enable or disable advisor subagents. |
+| `/provider ollama\|gemini\|openrouter\|nvidia\|codex` | Switch inference provider. |
+| `/model <query>` | Search and switch the model for the current provider. |
+| `/models [query\|number]` | Refresh, search, browse, or select provider models. |
+| `/connect` | Scan LAN/Tailscale for reachable Ollama hosts. |
+| `/connect <url>` | Connect to a specific Ollama host. |
+| `/eject [model\|all]` | Unload Ollama model(s) from the active host. |
+| `/hosts` | Re-scan reachable Ollama hosts. |
+| `/doctor` | Run provider diagnostics from inside the TUI. |
+| `/clear` | Clear the current transcript. |
+| `/exit` | Quit PatchPilot. |
+
+The transcript and sidebar have internal scroll areas. With an empty prompt, use left/right to choose the sidebar or transcript, then Page Up/Page Down and Home/End to navigate long sessions.
+
+## Providers
+
+| Provider route | Accepted values | Default model | Best for | Setup |
+|---|---|---|---|---|
+| Ollama local | `ollama` | `qwen2.5-coder:7b` | Private local coding work and offline experiments. | Install Ollama, pull a model, run `patchpilot`. |
+| Ollama remote | `ollama` with `--ollama-url` or `/connect` | Host model inventory | Laptop editing with a stronger desktop/server GPU. | Expose Ollama on the host, then use `/connect` or `--ollama-url`. |
+| Google Gemini | `gemini`, `google` | `gemini-2.5-flash` | Fast cloud inference through a Gemini API key. | Store `GEMINI_API_KEY` in `~/.patchpilot/.env` or use onboarding. |
+| OpenRouter | `openrouter`, `open-router` | `openrouter/auto` | Broad model routing, auto model selection, and free variants. | Store `OPENROUTER_API_KEY` in `~/.patchpilot/.env` or use onboarding. |
+| NVIDIA | `nvidia`, `nim` | `meta/llama-3.1-70b-instruct` | NVIDIA NIM OpenAI-compatible endpoints. | Store `NVIDIA_API_KEY` in `~/.patchpilot/.env` or use onboarding. |
+| Codex CLI | `codex`, `openai`, `openai-codex` | `gpt-5.5` | Using an existing Codex CLI OAuth login. | Run `codex login`, then `patchpilot --provider codex`. |
+
+Examples:
+
+```bash
+patchpilot --provider ollama --model qwen2.5-coder:7b
+patchpilot --provider gemini --model gemini-2.5-flash
+patchpilot --provider openrouter --model openrouter/auto
+patchpilot --provider nvidia --model meta/llama-3.1-70b-instruct
+patchpilot --provider codex --model gpt-5.5
+patchpilot --provider google --model gemini-2.5-flash
+patchpilot --provider nim --model meta/llama-3.1-70b-instruct
+patchpilot --provider openai --model gpt-5.5
+```
+
+Provider diagnostics:
+
+```bash
+patchpilot doctor --provider ollama
+patchpilot doctor --provider gemini
+patchpilot doctor --provider openrouter
+patchpilot doctor --provider nvidia
+patchpilot doctor --provider codex
+```
+
+PatchPilot caches model discovery for a short TTL inside the running TUI, so normal prompts do not re-query providers every time. Run `/models` again when you intentionally want to refresh the visible list.
+
+PatchPilot reads provider cache telemetry when the provider reports it, for example Codex cached input tokens or OpenRouter `prompt_tokens_details.cached_tokens`, then displays cache hit rate as `cached / input`.
+
+OpenRouter `:free` models are rate-limited by OpenRouter. PatchPilot warns when a selected model ID ends in `:free`.
+
+## Remote Ollama
+
+PatchPilot can run the TUI and workspace tools on one machine while sending model requests to Ollama on another machine. This is useful when your desktop has the GPU and your laptop is where you edit code.
+
+Inside PatchPilot:
+
+```text
+/connect
+/connect 1
+/connect http://192.168.1.50:11434
+/connect local
+```
+
+From the shell:
+
+```bash
+patchpilot --ollama-url http://<host-ip>:11434
+```
+
+On a Windows desktop or remote host, expose Ollama on your private network:
+
+1. Quit Ollama.
+2. Set `OLLAMA_HOST` to `0.0.0.0:11434`.
+3. Start Ollama again.
+4. Allow inbound TCP traffic on port `11434` only on trusted private networks.
+
+PatchPilot verifies candidates with Ollama's `/api/version` endpoint before listing them. It does not move file reads, writes, Git, or test commands to the remote host; only model requests are routed there.
+
+For smaller local machines, reduce the request budget before starting PatchPilot:
+
+```bash
+PATCHPILOT_NUM_CTX=4096 PATCHPILOT_NUM_PREDICT=768 patchpilot
+```
+
+## Safety Model
+
+PatchPilot is designed to keep powerful actions boring and reviewable:
+
+- File access is constrained to one workspace root.
+- Secret-like files such as `.env`, `.npmrc`, SSH keys, and `.netrc` are blocked from normal file tools.
+- Writes are disabled unless `--apply` is set.
+- Shell commands are disabled unless `--allow-shell` is set.
+- Shell execution uses a restricted single-command runner.
+- Provider config is stored in `~/.patchpilot/.env`, not in the current repository by default.
+- Tool output is shown in the transcript and fed back into the agent in clipped form.
+- Cloud providers may process prompts and context remotely under their own terms.
+
+This is still experimental agent tooling. Review diffs, avoid sensitive repositories when using cloud providers, and do not enable write or shell permissions casually.
+
+## Tech Stack
+
+| Layer | Technologies |
+|---|---|
+| Language | TypeScript, strict NodeNext ESM |
+| Runtime | Node.js 22+ |
+| TUI | Ink, React, ink-text-input |
+| Agent protocol | JSON command envelope validated with Zod |
+| Providers | Ollama chat API, Gemini generateContent API, OpenRouter OpenAI-compatible API, NVIDIA OpenAI-compatible API, Codex CLI OAuth backend |
+| Tests | Vitest |
+| CI | GitHub Actions |
+
+More detail: [docs/architecture.md](docs/architecture.md)
+
+## Development
+
+Run the TUI from source:
+
+```bash
+npm run dev -- "summarize this repository"
+```
+
+Typecheck, test, and build:
+
+```bash
+npm run typecheck
+npm test
+npm run build
+```
+
+If Vitest fails because a native optional dependency was installed incorrectly, run `npm ci` again before debugging PatchPilot itself.
+
+## Roadmap
+
+| Area | Planned work |
+|---|---|
+| Patch review | Rich diff preview before writes. |
+| Permissions | Interactive approve/deny prompts per risky tool call. |
+| Agents | Dedicated editor and test-runner roles with hard tool boundaries. |
+| Memory | Repository summaries and local task state. |
+| Model support | Native Ollama tool calling when model support is reliable. |
+| Distribution | Signed macOS and Windows desktop shell with the CLI as a sidecar. |
+| Efficiency | More token-cache-aware prompts and provider-specific cost reporting. |
+
+## Security and Legal
+
+PatchPilot can read files, write files, and run shell commands when you enable those capabilities. Use it only in repositories and environments you trust.
+
+- Security reports: please use GitHub Security Advisories or contact the maintainer privately with reproduction steps and impact.
+- License: this project is provided under the [MIT License](LICENSE).
+- Warranty: the software is provided "AS IS", without warranties of any kind.
+- Third-party services: model providers and external services are subject to their own terms, privacy policies, retention settings, and regional compliance requirements.
+
+## License
+
+PatchPilot is released under the [MIT License](LICENSE).

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+import { jsx as _jsx } from "react/jsx-runtime";
+import path from "node:path";
+import { render } from "ink";
+import { Command } from "commander";
+import { defaultCodexModel } from "./core/codex.js";
+import { loadPatchPilotEnv } from "./core/env.js";
+import { defaultGeminiModel } from "./core/gemini.js";
+import { normalizeModelProvider, readModelProvider } from "./core/modelClient.js";
+import { defaultNvidiaModel } from "./core/nvidia.js";
+import { runDoctor } from "./core/doctor.js";
+import { defaultOllamaModel, resolveOllamaBaseUrl } from "./core/ollama.js";
+import { defaultOpenRouterModel } from "./core/openrouter.js";
+import { App } from "./tui/App.js";
+loadPatchPilotEnv();
+const defaultOllamaUrl = resolveOllamaBaseUrl();
+const defaultProvider = readModelProvider();
+const defaultModel = process.env.PATCHPILOT_MODEL ??
+    (defaultProvider === "gemini"
+        ? defaultGeminiModel
+        : defaultProvider === "openrouter"
+            ? defaultOpenRouterModel
+            : defaultProvider === "nvidia"
+                ? defaultNvidiaModel
+                : defaultProvider === "codex"
+                    ? defaultCodexModel
+                    : defaultOllamaModel);
+const program = new Command();
+program.enablePositionalOptions();
+program
+    .name("patchpilot")
+    .description("Local-first coding agent TUI powered by Ollama and OpenAI-compatible providers.")
+    .version("0.2.0");
+program
+    .command("doctor")
+    .description("Check local PatchPilot requirements.")
+    .option("--provider <name>", "Model provider: ollama, gemini, openrouter, nvidia, or codex.", defaultProvider)
+    .option("--check-url <url>", "Ollama base URL to verify", defaultOllamaUrl)
+    .option("--ollama-url <url>", "Alias for --check-url.")
+    .option("--check-model <name>", "Model name to verify", defaultModel)
+    .option("--model <name>", "Alias for --check-model.")
+    .action(async (options) => {
+    const results = await runDoctor(normalizeModelProvider(options.provider), options.ollamaUrl ?? options.checkUrl, options.model ?? options.checkModel);
+    for (const result of results) {
+        const marker = result.ok ? "ok" : "fail";
+        console.log(`${marker.padEnd(5)} ${result.name}: ${result.details}`);
+    }
+    process.exitCode = results.every((result) => result.ok) ? 0 : 1;
+});
+program
+    .argument("[task...]", "Task for the local coding agent.")
+    .option("--workspace <path>", "Workspace root", process.cwd())
+    .option("--provider <name>", "Model provider: ollama, gemini, openrouter, nvidia, or codex.", defaultProvider)
+    .option("--model <name>", "Model name", defaultModel)
+    .option("--ollama-url <url>", "Ollama base URL", defaultOllamaUrl)
+    .option("--steps <count>", "Maximum agent steps", "8")
+    .option("--thinking <mode>", "Thinking budget mode: fixed or adaptive.", process.env.PATCHPILOT_THINKING_MODE ?? "fixed")
+    .option("--reasoning <effort>", "Provider reasoning effort: low, medium, high, xhigh, or adaptive.", process.env.PATCHPILOT_REASONING_EFFORT ?? "medium")
+    .option("--apply", "Allow file writes inside the workspace.", false)
+    .option("--allow-shell", "Allow shell commands inside the workspace.", false)
+    .option("--no-subagents", "Disable planner and reviewer subagents for faster local runs.")
+    .action((taskParts, options) => {
+    const workspace = path.resolve(String(options.workspace));
+    const maxSteps = Number.parseInt(String(options.steps), 10);
+    render(_jsx(App, { initialTask: taskParts.join(" ").trim() || undefined, provider: readModelProvider({ PATCHPILOT_PROVIDER: String(options.provider) }), model: String(options.model), ollamaUrl: String(options.ollamaUrl), workspace: workspace, allowWrite: Boolean(options.apply), allowShell: Boolean(options.allowShell), maxSteps: Number.isFinite(maxSteps) ? maxSteps : 8, thinkingMode: String(options.thinking) === "adaptive" ? "adaptive" : "fixed", reasoningEffort: readReasoningEffort(String(options.reasoning)), subagents: options.subagents !== false }));
+});
+await program.parseAsync(process.argv);
+function readReasoningEffort(value) {
+    return value === "low" || value === "medium" || value === "high" || value === "xhigh" || value === "adaptive" ? value : "medium";
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.tsx"],"names":[],"mappings":"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"}

package/dist/core/agent.d.ts

@@ -0,0 +1,21 @@
+import type { AgentEvent, ModelProvider, ReasoningEffort } from "./types.js";
+export type AgentRunnerOptions = {
+    provider: ModelProvider;
+    model: string;
+    ollamaUrl: string;
+    workspace: string;
+    allowWrite: boolean;
+    allowShell: boolean;
+    maxSteps: number;
+    thinkingMode: "fixed" | "adaptive";
+    reasoningEffort: ReasoningEffort | "adaptive";
+    subagents: boolean;
+    signal?: AbortSignal;
+};
+export declare class AgentRunner {
+    private readonly client;
+    private readonly tools;
+    private readonly options;
+    constructor(options: AgentRunnerOptions);
+    run(task: string): AsyncGenerator<AgentEvent>;
+}