xling 0.4.1 → 0.5.0

package/README.md

@@ -47,217 +47,47 @@ npm link
 
 ## Usage
 
-### Quick Start - The `x` Command
+`xling` bundles a quick launcher, configuration helpers, and git productivity
+commands. Detailed usage, flag tables, and examples live in
+[`docs/README.md`](./docs/README.md) and the per-command Markdown files under
+`docs/`. The summary below mirrors the docs so you can skim everything in one
+place.
 
-The fastest way to start your AI tools! Just type `xling x` to launch Claude Code with yolo mode.
+### Command Overview
 
-**Claude Code is launched by default** - the ultimate convenience!
+- `x`: Launch Claude Code or Codex with resume flags, yolo toggle, and passthrough args.
+- `settings:list|get|set|switch|inspect`: Inspect, edit, and switch Claude, Codex, or Gemini configs across scopes.
+- `git:prc|prr|prv`: Create, checkout, and view GitHub pull requests with automatic gh/git fallbacks.
+- `git:wta|wtl|wtp|wtr|wts`: Manage git worktrees (add/list/prune/remove/switch) with guard rails and subshell support.
 
-```bash
-# Fastest way - Start Claude Code instantly
-xling x
-
-# Continue last conversation/session
-xling x -c
-
-# Resume from conversation/session list
-xling x -r
-
-# Pass arguments to Claude
-xling x -- chat "Hello, how are you?"
-
-# Start without yolo mode
-xling x --no-yolo
-
-# Start Codex instead
-xling x --tool codex
-# or use the short flag
-xling x -t codex
-
-# Continue last Codex session
-xling x -t codex -c
-
-# Start Codex in a specific directory
-xling x -t codex -C /path/to/project
-```
-
-**Resume Options:**
-- `-c` or `--continue`: Continue the last conversation/session
-  - Claude Code: `claude -c`
-  - Codex: `codex resume --last`
-- `-r` or `--resume`: Show a list to choose from
-  - Claude Code: `claude -r`
-  - Codex: `codex resume`
-
-**Yolo mode flags:**
-- Claude Code: `--dangerously-skip-permissions`
-- Codex: `--dangerously-bypass-approvals-and-sandbox`
-
-### Git Workflow Commands
-
-Manage PRs and worktrees with intelligent fallback strategies.
-
-```bash
-# Checkout PR (uses gh CLI if available, falls back to git)
-xling git:prr 123
-
-# Checkout PR to a specific branch
-xling git:prr 456 --branch my-feature
-
-# Force git fallback (skip gh CLI)
-xling git:prr 789 --no-gh --remote upstream
-
-# Create PR
-xling git:prc
-
-# Create PR with title and body
-xling git:prc --title "Add feature X" --body "Implements feature X"
-
-# Create PR and preview in browser
-xling git:prc --web
-
-# Create PR and preview in specific browser
-xling git:prc --web --browser safari
+### Command Documentation (inline excerpt)
 
-# Create draft PR
-xling git:prc --draft --title "WIP: Feature Y"
+#### Launching AI tools
 
-# Create PR with reviewers and labels
-xling git:prc --reviewer user1 --reviewer user2 --label bug
+- [`x` – quick launcher](docs/x.md): fire up Claude Code or Codex with resume/yolo controls and passthrough args.
 
-# View PR in browser
-xling git:prv 123
+#### Settings management
 
-# View PR in specific browser
-xling git:prv 456 --browser safari
-xling git:prv 789 --browser firefox
-xling git:prv 999 --browser arc
+- [`settings:list`](docs/settings.md#settingslist): summarize which config files exist per tool/scope (JSON or table view).
+- [`settings:get`](docs/settings.md#settingsget): print the raw config (or a specific Claude variant) for auditing and backups.
+- [`settings:set`](docs/settings.md#settingsset): open the target config in your editor of choice; handles variant creation.
+- [`settings:switch`](docs/settings.md#settingsswitch): flip active profiles (Codex) or Claude variants with safety checks.
+- [`settings:inspect`](docs/settings.md#settingsinspect): deep-dive into parsed settings with validation output.
 
-# List worktrees
-xling git:wtl
+#### Git worktree helpers
 
-# Add new worktree (defaults to main branch)
-xling git:wta
-xling git:wta -b feature/login
-xling git:wta -b feature/login -p ../custom-path
+- [`git:wta` – add worktree](docs/git-wta.md): create detached or branch-bound worktrees with auto paths and guards.
+- [`git:wtl` – list worktrees](docs/git-wtl.md): display human-readable worktree inventory (branch + path).
+- [`git:wtp` – prune worktrees](docs/git-wtp.md): clean stale git metadata left behind after manual deletions.
+- [`git:wtr` – remove worktree](docs/git-wtr.md): remove a worktree safely by branch, dir, or absolute path.
+- [`git:wts` – switch to worktree](docs/git-wts.md): jump into an existing worktree or just print its path for scripting.
 
-# Switch to worktree (opens subshell)
-xling git:wts                     # Switch to main
-xling git:wts -b feature/login    # Switch to specific branch
+#### Pull request helpers
 
-# Print path only (useful for cd $(...))
-cd $(xling git:wts --path-only -b feature/login)
+- [`git:prc` – create PR](docs/git-prc.md): wrap `gh pr create` with reviewers, labels, draft, and browser launch options.
+- [`git:prr` – checkout PR](docs/git-prr.md): fetch/checkout PRs with a smart `gh`/git fallback and custom branch names.
+- [`git:prv` – view PR](docs/git-prv.md): open a PR in your preferred browser directly from the terminal.
 
-# Remove worktree
-xling git:wtr -b main                 # By branch name
-xling git:wtr -b xling-feature        # By directory name
-xling git:wtr -p ../repo-feature      # By path
-
-# Prune stale worktrees
-xling git:wtp
-```
-
-**PR Checkout Strategies:**
-- **gh strategy**: Uses `gh pr checkout <id>` (preferred, requires GitHub CLI)
-- **git fallback**: Uses `git fetch origin pull/<id>/head:<branch>` + `git switch <branch>`
-- Automatic detection: gh CLI availability is checked automatically
-- Manual override: Use `--no-gh` to force git strategy
-
-**PR Creation Features:**
-- Interactive mode: Run without flags for guided PR creation
-- Direct mode: Specify title, body, and other options via flags
-- Draft PRs: Use `--draft` flag for work-in-progress PRs
-- Reviewers & Labels: Add multiple reviewers and labels
-- Browser preview: Use `--web` to open PR in browser after creation
-- Custom browser: Combine `--web --browser <name>` for specific browser
-
-**Worktree Features:**
-- **Focused commands**: Separate commands for each action (`wtl`, `wta`, `wts`, `wtr`, `wtp`)
-- **Smart switching**: `wts` drops you into a subshell inside the worktree (use `--path-only` for scripts)
-- **Auto-path generation**: Auto-generates path as `../repo-name-branch-name` when adding
-- **Smart naming**: Branch names with `/` are converted to `-` (e.g., `feature/login` → `xling-feature-login`)
-- **Intelligent matching**: Remove/switch by branch name, directory name, or full path
-- **Default branch**: Defaults to `main` branch for `wta` and `wts`
-- **Branch occupation check**: Prevents creating worktree for branch already in use
-
-**Browser Support:**
-- macOS: chrome, safari, firefox, arc, edge, dia
-- Linux: chrome, firefox, edge, dia (via `google-chrome`, `firefox`, `microsoft-edge`, `dia`)
-- Windows: chrome, firefox, arc, edge, dia
-- Default: chrome
-- Note: Safari only available on macOS; Arc has limited Linux support
-
-### List Settings
-
-```bash
-# List all settings for Claude Code (user scope)
-xling settings:list --tool claude --scope user
-
-# List Codex settings in table format
-xling settings:list --tool codex --table
-```
-
-> Claude-specific: `settings:list --tool claude` now enumerates every
-> `settings*.json` file (for example `settings.hxi.json`) in the selected scope
-> so you can quickly discover switchable variants.
->
-> Codex-specific: `settings:list --tool codex` surfaces only the `model_providers`
-> block from `~/.codex/config.toml`, helping you audit provider names, base URLs,
-> and env key bindings at a glance.
-
-`settings:list` prints a concise YAML-style summary by default. Add `--table` or `--json` for structured output. Other commands default to JSON and can switch to plain text with `--no-json`.
-
-### Get Settings File
-
-```bash
-# Show Claude user settings (plain text default)
-xling settings:get --tool claude --scope user
-
-# Inspect a Claude variant (settings.hxi.json)
-xling settings:get hxi --tool claude --scope user
-
-# Show Codex config (plain text)
-xling settings:get --tool codex
-```
-
-### Edit Settings (Claude)
-
-```bash
-# Create/edit settings.hxi.json in VS Code (default)
-xling settings:set --tool claude --scope user --name hxi
-
-# Open default settings in Cursor
-xling settings:set --tool claude --scope project --name default --ide cursor --no-json
-```
-
-`settings:set` now focuses on whole-file editing: pass `--name` (defaults to `default`) to create or open `settings.<name>.json`, and use `--ide` to pick the editor command (defaults to VS Code's `code`).
-
-> Note: Every `settings:*` command relies solely on flags such as `--tool`, `--scope`, and `--name`; key-level overrides like `developerShortcuts.runCommand` are no longer supported.
-
-### Switch Profiles or Claude Variants
-
-```bash
-# Switch to a different profile
-xling settings:switch oss --tool codex
-
-# Activate settings.hxi.json for Claude user scope
-xling settings:switch hxi --tool claude --scope user
-
-# Apply without prompt (Claude)
-xling settings:switch hxi --tool claude --scope user --force
-
-# Force and keep a .bak backup
-xling settings:switch hxi --tool claude --scope user --force --backup
-```
-
-Claude switches now show an interactive diff preview: the command prints a unified diff and then prompts for `overwrite / backup / cancel`. Use `--force` for non-interactive runs, optionally paired with `--backup` to keep a `.bak`. Codex continues to switch profiles immediately.
-
-### Inspect Configuration
-
-```bash
-# View configuration file information
-xling settings:inspect --tool claude --scope user
-```
 
 ## Supported Tools
 

package/dist/{base-C-NPqEhs.d.ts → base-4RgBKYUc.d.ts}

@@ -1,5 +1,5 @@
-import { f as SettingsResult, m as ToolId, n as InspectResult, p as SwitchOptions, s as Scope, t as EditOptions, u as SettingsListData } from "./types-h3oFUAyV.js";
-import { n as SettingsAdapter } from "./interfaces-CbUR78_2.js";
+import { f as SettingsListData, g as ToolId, h as SwitchOptions, i as InspectResult, l as Scope, m as SettingsResult, r as EditOptions, t as ConfigObject } from "./types-B6AS7UBa.js";
+import { n as SettingsAdapter } from "./interfaces-Db5DCCHW.js";
 
 //#region src/services/settings/adapters/base.d.ts
 
@@ -32,11 +32,11 @@ declare abstract class BaseAdapter implements SettingsAdapter {
   /**
   * Read the configuration file (subclasses may override)
   */
-  protected readConfig(path: string): Record<string, unknown>;
+  protected readConfig(path: string): ConfigObject;
   /**
   * Write the configuration file (subclasses may override)
   */
-  protected writeConfig(path: string, data: Record<string, unknown>, backup?: boolean): void;
+  protected writeConfig(path: string, data: ConfigObject, backup?: boolean): void;
 }
 //#endregion
 export { BaseAdapter as t };

package/dist/{base-CqP3N9Eo.d.ts → base-B1zqN9dm.d.ts}

@@ -1,5 +1,5 @@
-import { m as ToolId, r as LaunchCommandSpec } from "./types-h3oFUAyV.js";
-import { t as LaunchAdapter } from "./interfaces-CbUR78_2.js";
+import { a as LaunchCommandSpec, g as ToolId } from "./types-B6AS7UBa.js";
+import { t as LaunchAdapter } from "./interfaces-Db5DCCHW.js";
 
 //#region src/services/launch/adapters/base.d.ts
 

package/dist/{base-BDWlyPnr.js → base-DtcPVpvU.js}

@@ -1,5 +1,5 @@
 import { c as InvalidScopeError } from "./errors-pXKbCKbL.js";
-import { a as readJSON, c as writeJSON, i as getFileInfo, r as fileExists } from "./fsStore-MvYlG65t.js";
+import { a as readJSON, c as writeJSON, i as getFileInfo, r as fileExists } from "./fsStore-S8RslR8L.js";
 
 //#region src/services/settings/adapters/base.ts
 /**

package/dist/{claude-BvlLXKkI.js → claude-BO72_3yh.js}

@@ -1,4 +1,4 @@
-import { t as BaseLaunchAdapter } from "./base-CRTwHcps.js";
+import { t as BaseLaunchAdapter } from "./base-DkYAPGeT.js";
 
 //#region src/services/launch/adapters/claude.ts
 /**

package/dist/{claude-NvQoYxJY.js → claude-Bagw5C6H.js}

@@ -1,9 +1,9 @@
 import { c as InvalidScopeError, u as SettingsVariantNotFoundError } from "./errors-pXKbCKbL.js";
 import { n as resolveEditorCommand, t as openInEditor } from "./editor-CUiekAEb.js";
-import { t as formatDiff } from "./format-GMs1vKBL.js";
-import { c as writeJSON, i as getFileInfo, n as ensureDir, s as resolveHome } from "./fsStore-MvYlG65t.js";
-import { t as BaseAdapter } from "./base-BDWlyPnr.js";
-import { t as CLAUDE_SETTINGS_TEMPLATE } from "./claudeDefault-E3SAE4Ef.js";
+import { t as formatDiff } from "./format-a_tYXjv9.js";
+import { c as writeJSON, i as getFileInfo, n as ensureDir, s as resolveHome } from "./fsStore-S8RslR8L.js";
+import { t as BaseAdapter } from "./base-DtcPVpvU.js";
+import { t as CLAUDE_SETTINGS_TEMPLATE } from "./claudeDefault-ewrEKzlX.js";
 import * as fs from "fs";
 import * as path from "path";
 

package/dist/client-BQFhUvFV.js

@@ -0,0 +1,88 @@
+import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
+import { generateText, streamText } from "ai";
+
+//#region src/services/prompt/client.ts
+/**
+* OpenAI Compatible Client Wrapper
+* Wraps @ai-sdk/openai-compatible for each provider
+*/
+/**
+* Client for a single provider using AI SDK
+*/
+var PromptClient = class {
+	provider;
+	config;
+	constructor(config) {
+		this.config = config;
+		this.provider = createOpenAICompatible({
+			name: config.name,
+			baseURL: config.baseUrl,
+			apiKey: config.apiKey,
+			headers: config.headers
+		});
+	}
+	/**
+	* Convert AI SDK v2 usage to our internal format
+	*/
+	convertUsage(usage) {
+		if (!usage) return;
+		return {
+			promptTokens: usage.inputTokens ?? 0,
+			completionTokens: usage.outputTokens ?? 0,
+			totalTokens: usage.totalTokens ?? 0
+		};
+	}
+	/**
+	* Generate text (non-streaming)
+	*/
+	async generate(request) {
+		const baseParams = {
+			model: this.provider(request.model || ""),
+			temperature: request.temperature,
+			maxOutputTokens: request.maxTokens,
+			maxRetries: 2,
+			abortSignal: request.abortSignal
+		};
+		const result = await generateText(request.messages && request.messages.length > 0 ? {
+			...baseParams,
+			messages: request.messages
+		} : {
+			...baseParams,
+			prompt: request.prompt || "",
+			system: request.system
+		});
+		return {
+			content: result.text,
+			model: request.model || "",
+			provider: this.config.name,
+			usage: this.convertUsage(result.usage),
+			finishReason: result.finishReason
+		};
+	}
+	/**
+	* Stream text
+	*/
+	async stream(request) {
+		const baseParams = {
+			model: this.provider(request.model || ""),
+			temperature: request.temperature,
+			maxOutputTokens: request.maxTokens,
+			maxRetries: 2,
+			abortSignal: request.abortSignal
+		};
+		return await streamText(request.messages && request.messages.length > 0 ? {
+			...baseParams,
+			messages: request.messages
+		} : {
+			...baseParams,
+			prompt: request.prompt || "",
+			system: request.system
+		});
+	}
+	getProviderName() {
+		return this.config.name;
+	}
+};
+
+//#endregion
+export { PromptClient as t };

package/dist/{codex-DrigbqRY.js → codex-0_hkyUsd.js}

@@ -1,4 +1,4 @@
-import { t as BaseLaunchAdapter } from "./base-CRTwHcps.js";
+import { t as BaseLaunchAdapter } from "./base-DkYAPGeT.js";
 
 //#region src/services/launch/adapters/codex.ts
 /**

package/dist/{codex-DX7doGgq.js → codex-CKkfM5YP.js}

@@ -1,6 +1,6 @@
 import { c as InvalidScopeError, l as ProfileNotFoundError } from "./errors-pXKbCKbL.js";
-import { l as writeTOML, o as readTOML } from "./fsStore-MvYlG65t.js";
-import { t as BaseAdapter } from "./base-BDWlyPnr.js";
+import { l as writeTOML, o as readTOML } from "./fsStore-S8RslR8L.js";
+import { t as BaseAdapter } from "./base-DtcPVpvU.js";
 
 //#region src/services/settings/adapters/codex.ts
 /**
@@ -43,9 +43,12 @@ var CodexAdapter = class extends BaseAdapter {
 		if (!this.validateScope(scope)) throw new InvalidScopeError(scope);
 		const path = this.resolvePath(scope);
 		const config = this.readConfig(path);
-		const profiles = config.profiles;
+		const profilesValue = config.profiles;
+		const profiles = isConfigObject(profilesValue) ? profilesValue : void 0;
 		if (!profiles || !(profile in profiles)) throw new ProfileNotFoundError(profile);
-		const profileConfig = profiles[profile];
+		const profileValue = profiles[profile];
+		if (!isConfigObject(profileValue)) throw new ProfileNotFoundError(profile);
+		const profileConfig = profileValue;
 		const newConfig = { ...config };
 		for (const [key, value] of Object.entries(profileConfig)) newConfig[key] = value;
 		newConfig.current_profile = profile;
@@ -70,10 +73,11 @@ var CodexAdapter = class extends BaseAdapter {
 	}
 	extractProviders(config) {
 		const providers = config.model_providers;
-		if (typeof providers === "object" && providers !== null && !Array.isArray(providers)) return providers;
+		if (isConfigObject(providers)) return providers;
 		return {};
 	}
 };
+const isConfigObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value) && !(value instanceof Date);
 
 //#endregion
 export { CodexAdapter as t };

package/dist/commands/git/prc.js

@@ -4,9 +4,9 @@ import "../../runner-DYk4q6mP.js";
 import "../../utils-DDnNMPIq.js";
 import "../../pr-DjdO-vJk.js";
 import "../../view-JZaEEspp.js";
-import "../../worktree-CYc33agA.js";
+import "../../worktree-BuIXmI0X.js";
 import "../../create-CKUHliul.js";
-import { t as GitDispatcher } from "../../dispatcher-C0-p8F1o.js";
+import { t as GitDispatcher } from "../../dispatcher-D4bEJonH.js";
 import { Command, Flags } from "@oclif/core";
 
 //#region src/commands/git/prc.ts

package/dist/commands/git/prr.js

@@ -3,9 +3,9 @@ import "../../runner-DYk4q6mP.js";
 import "../../utils-DDnNMPIq.js";
 import "../../pr-DjdO-vJk.js";
 import "../../view-JZaEEspp.js";
-import "../../worktree-CYc33agA.js";
+import "../../worktree-BuIXmI0X.js";
 import "../../create-CKUHliul.js";
-import { t as GitDispatcher } from "../../dispatcher-C0-p8F1o.js";
+import { t as GitDispatcher } from "../../dispatcher-D4bEJonH.js";
 import { Args, Command, Flags } from "@oclif/core";
 
 //#region src/commands/git/prr.ts

package/dist/commands/git/prv.js

@@ -4,9 +4,9 @@ import "../../runner-DYk4q6mP.js";
 import "../../utils-DDnNMPIq.js";
 import "../../pr-DjdO-vJk.js";
 import "../../view-JZaEEspp.js";
-import "../../worktree-CYc33agA.js";
+import "../../worktree-BuIXmI0X.js";
 import "../../create-CKUHliul.js";
-import { t as GitDispatcher } from "../../dispatcher-C0-p8F1o.js";
+import { t as GitDispatcher } from "../../dispatcher-D4bEJonH.js";
 import { Args, Command, Flags } from "@oclif/core";
 
 //#region src/commands/git/prv.ts

package/dist/commands/git/worktree.js

@@ -3,9 +3,9 @@ import "../../runner-DYk4q6mP.js";
 import "../../utils-DDnNMPIq.js";
 import "../../pr-DjdO-vJk.js";
 import "../../view-JZaEEspp.js";
-import "../../worktree-CYc33agA.js";
+import "../../worktree-BuIXmI0X.js";
 import "../../create-CKUHliul.js";
-import { t as GitDispatcher } from "../../dispatcher-C0-p8F1o.js";
+import { t as GitDispatcher } from "../../dispatcher-D4bEJonH.js";
 import { Command, Flags } from "@oclif/core";
 
 //#region src/commands/git/worktree.ts

package/dist/commands/git/wta.js

@@ -3,9 +3,9 @@ import "../../runner-DYk4q6mP.js";
 import "../../utils-DDnNMPIq.js";
 import "../../pr-DjdO-vJk.js";
 import "../../view-JZaEEspp.js";
-import "../../worktree-CYc33agA.js";
+import "../../worktree-BuIXmI0X.js";
 import "../../create-CKUHliul.js";
-import { t as GitDispatcher } from "../../dispatcher-C0-p8F1o.js";
+import { t as GitDispatcher } from "../../dispatcher-D4bEJonH.js";
 import { Command, Flags } from "@oclif/core";
 
 //#region src/commands/git/wta.ts

package/dist/commands/git/wtl.js

@@ -3,9 +3,9 @@ import "../../runner-DYk4q6mP.js";
 import "../../utils-DDnNMPIq.js";
 import "../../pr-DjdO-vJk.js";
 import "../../view-JZaEEspp.js";
-import "../../worktree-CYc33agA.js";
+import "../../worktree-BuIXmI0X.js";
 import "../../create-CKUHliul.js";
-import { t as GitDispatcher } from "../../dispatcher-C0-p8F1o.js";
+import { t as GitDispatcher } from "../../dispatcher-D4bEJonH.js";
 import { Command } from "@oclif/core";
 
 //#region src/commands/git/wtl.ts

package/dist/commands/git/wtp.js

@@ -3,9 +3,9 @@ import "../../runner-DYk4q6mP.js";
 import "../../utils-DDnNMPIq.js";
 import "../../pr-DjdO-vJk.js";
 import "../../view-JZaEEspp.js";
-import "../../worktree-CYc33agA.js";
+import "../../worktree-BuIXmI0X.js";
 import "../../create-CKUHliul.js";
-import { t as GitDispatcher } from "../../dispatcher-C0-p8F1o.js";
+import { t as GitDispatcher } from "../../dispatcher-D4bEJonH.js";
 import { Command } from "@oclif/core";
 
 //#region src/commands/git/wtp.ts

package/dist/commands/git/wtr.js

@@ -3,9 +3,9 @@ import "../../runner-DYk4q6mP.js";
 import "../../utils-DDnNMPIq.js";
 import "../../pr-DjdO-vJk.js";
 import "../../view-JZaEEspp.js";
-import "../../worktree-CYc33agA.js";
+import "../../worktree-BuIXmI0X.js";
 import "../../create-CKUHliul.js";
-import { t as GitDispatcher } from "../../dispatcher-C0-p8F1o.js";
+import { t as GitDispatcher } from "../../dispatcher-D4bEJonH.js";
 import { Command, Flags } from "@oclif/core";
 
 //#region src/commands/git/wtr.ts

package/dist/commands/git/wts.js

@@ -3,9 +3,9 @@ import "../../runner-DYk4q6mP.js";
 import "../../utils-DDnNMPIq.js";
 import "../../pr-DjdO-vJk.js";
 import "../../view-JZaEEspp.js";
-import "../../worktree-CYc33agA.js";
+import "../../worktree-BuIXmI0X.js";
 import "../../create-CKUHliul.js";
-import { t as GitDispatcher } from "../../dispatcher-C0-p8F1o.js";
+import { t as GitDispatcher } from "../../dispatcher-D4bEJonH.js";
 import { Command, Flags } from "@oclif/core";
 import { spawn } from "node:child_process";
 

package/dist/commands/p/index.d.ts

@@ -0,0 +1,39 @@
+import { Command, Interfaces } from "@oclif/core";
+
+//#region src/commands/p/index.d.ts
+
+declare class PCommand extends Command {
+  static description: string;
+  static examples: Command.Example[];
+  static flags: Interfaces.FlagInput;
+  static args: Interfaces.ArgInput;
+  run(): Promise<void>;
+  /**
+  * Determine if should enter interactive mode
+  */
+  private shouldEnterInteractive;
+  /**
+  * Ask user if they want to continue conversation
+  * Uses /dev/tty to read from terminal even when stdin is piped
+  */
+  private askContinueConversation;
+  /**
+  * Enter interactive REPL mode
+  * Uses /dev/tty for proper terminal behavior when stdin is piped
+  */
+  private enterInteractiveMode;
+  /**
+  * Display streaming output and return full text
+  */
+  private displayStream;
+  /**
+  * Build prompt from various sources
+  */
+  private buildPrompt;
+  /**
+  * Read from stdin
+  */
+  private readStdin;
+}
+//#endregion
+export { PCommand as default };