Lex Christopherson d20d5e8fb5 docs: add Mintlify documentation site and move internal docs

Add a proper public-facing documentation site using Mintlify with 19 MDX
pages covering getting started, auto mode, commands, configuration, and
all user-facing features. Move internal/SDK documentation (Pi SDK, TUI,
context & hooks, research notes, ADRs) to docs-internal/ since they
should not be part of the public documentation.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-03-25 09:54:41 -06:00

1.6 KiB

Raw Blame History

Built-in Dialog Methods

The simplest UI — blocking dialogs that wait for user response:

Selection

const choice = await ctx.ui.select("Pick a color:", ["Red", "Green", "Blue"]);
// Returns: "Red" | "Green" | "Blue" | undefined (if cancelled)

Confirmation

const ok = await ctx.ui.confirm("Delete file?", "This action cannot be undone.");
// Returns: true | false

Text Input

const name = await ctx.ui.input("Project name:", "my-project");
// Returns: string | undefined (if cancelled)

Multi-line Editor

const text = await ctx.ui.editor("Edit the description:", "Default text here");
// Returns: string | undefined (if cancelled)

Timed Dialogs (Auto-Dismiss)

Dialogs can auto-dismiss with a live countdown:

// Shows "Confirm? (5s)" → "Confirm? (4s)" → ... → auto-dismisses
const ok = await ctx.ui.confirm(
  "Auto-proceed?",
  "Continuing in 5 seconds...",
  { timeout: 5000 }
);
// Returns false on timeout

Timeout return values:

select() → undefined
confirm() → false
input() → undefined

Manual Dismissal with AbortSignal

For more control (distinguish timeout from user cancel):

const controller = new AbortController();
const timeoutId = setTimeout(() => controller.abort(), 5000);

const ok = await ctx.ui.confirm(
  "Timed Confirm",
  "Auto-cancels in 5s",
  { signal: controller.signal }
);

clearTimeout(timeoutId);

if (ok) {
  // User confirmed
} else if (controller.signal.aborted) {
  // Timed out
} else {
  // User cancelled (Escape)
}

1.6 KiB Raw Blame History