@earendil-works/pi-coding-agent 0.86.1 → 0.87.1

package/docs/docs.json

@@ -1,7 +1,7 @@
 {
   "navigation": [
     {
-      "title": "Start here",
+      "title": "Get Started",
       "items": [
         {
           "title": "Overview",
@@ -12,142 +12,178 @@
           "path": "quickstart.md"
         },
         {
-          "title": "Using Pi",
-          "path": "usage.md"
-        },
-        {
-          "title": "Providers",
-          "path": "providers.md"
-        },
-        {
-          "title": "Security",
-          "path": "security.md"
-        },
-        {
-          "title": "Containerization",
-          "path": "containerization.md"
-        },
-        {
-          "title": "Settings",
-          "path": "settings.md"
-        },
-        {
-          "title": "Keybindings",
-          "path": "keybindings.md"
-        },
-        {
-          "title": "Sessions",
-          "path": "sessions.md"
-        },
-        {
-          "title": "Compaction",
-          "path": "compaction.md"
+          "title": "How Pi Works",
+          "path": "how-pi-works.md"
         }
       ]
     },
     {
-      "title": "Customization",
+      "title": "Guides",
       "items": [
         {
-          "title": "Extensions",
-          "path": "extensions.md"
-        },
+          "title": "Run Pi",
+          "items": [
+            {
+              "title": "Use Pi in the Terminal",
+              "path": "usage.md"
+            },
+            {
+              "title": "Choose a Model",
+              "path": "models.md"
+            },
+            {
+              "title": "Manage Sessions and Context",
+              "path": "sessions.md"
+            },
+            {
+              "title": "Run Pi Safely",
+              "path": "security.md"
+            },
+            {
+              "title": "Isolate Pi",
+              "path": "containerization.md"
+            },
+            {
+              "title": "Run Local Models",
+              "path": "llama-cpp.md"
+            },
+            {
+              "title": "Configure Your Terminal",
+              "path": "terminal-setup.md"
+            },
+            {
+              "title": "Configure Shell Commands",
+              "path": "shell-aliases.md"
+            },
+            {
+              "title": "Run Pi in tmux",
+              "path": "tmux.md"
+            },
+            {
+              "title": "Run Pi on Windows",
+              "path": "windows.md"
+            },
+            {
+              "title": "Run Pi on Android",
+              "path": "termux.md"
+            }
+          ]
+        },
+        {
+          "title": "Customize Pi",
+          "items": [
+            {
+              "title": "Configure Pi",
+              "path": "configuration.md"
+            },
+            {
+              "title": "Create Prompt Templates",
+              "path": "prompt-templates.md"
+            },
+            {
+              "title": "Add Skills",
+              "path": "skills.md"
+            },
+            {
+              "title": "Create Themes",
+              "path": "themes.md"
+            },
+            {
+              "title": "Use Pi Packages",
+              "path": "packages.md"
+            }
+          ]
+        },
+        {
+          "title": "Build on Pi",
+          "items": [
+            {
+              "title": "Build Extensions",
+              "path": "extensions.md"
+            },
+            {
+              "title": "Add Custom Providers",
+              "path": "custom-provider.md"
+            },
+            {
+              "title": "Build Terminal UI Components",
+              "path": "tui.md"
+            },
+            {
+              "title": "Integrate with the CLI",
+              "path": "cli-integration.md"
+            },
+            {
+              "title": "Use the SDK",
+              "path": "sdk.md"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "title": "Reference",
+      "items": [
         {
-          "title": "Skills",
-          "path": "skills.md"
+          "title": "CLI",
+          "path": "cli.md"
         },
         {
-          "title": "Prompt Templates",
-          "path": "prompt-templates.md"
+          "title": "Slash Commands",
+          "path": "slash-commands.md"
         },
         {
-          "title": "Themes",
-          "path": "themes.md"
+          "title": "Settings",
+          "path": "settings.md"
         },
         {
-          "title": "Pi Packages",
-          "path": "packages.md"
+          "title": "Environment Variables",
+          "path": "environment-variables.md"
         },
         {
-          "title": "Custom Models",
-          "path": "models.md"
+          "title": "Keybindings",
+          "path": "keybindings.md"
         },
         {
-          "title": "Custom Providers",
-          "path": "custom-provider.md"
-        }
-      ]
-    },
-    {
-      "title": "Reference",
-      "items": [
-        {
-          "title": "Environment Variables",
-          "path": "environment-variables.md"
+          "title": "Provider Authentication",
+          "path": "providers.md"
         },
         {
-          "title": "Session Format",
+          "title": "Session File Format",
           "path": "session-format.md"
-        }
-      ]
-    },
-    {
-      "title": "Programmatic Usage",
-      "items": [
-        {
-          "title": "SDK",
-          "path": "sdk.md"
         },
         {
-          "title": "RPC Mode",
-          "path": "rpc.md"
+          "title": "Compaction and Branch Summaries",
+          "path": "compaction.md"
         },
         {
-          "title": "JSON Event Stream Mode",
+          "title": "JSON Event Stream",
           "path": "json.md"
         },
         {
-          "title": "TUI Components",
-          "path": "tui.md"
-        }
-      ]
-    },
-    {
-      "title": "Platform Setup",
-      "items": [
-        {
-          "title": "Windows",
-          "path": "windows.md"
-        },
-        {
-          "title": "Termux on Android",
-          "path": "termux.md"
+          "title": "RPC Protocol",
+          "path": "rpc.md"
         },
         {
-          "title": "tmux",
-          "path": "tmux.md"
+          "title": "RPC Commands",
+          "path": "rpc-commands.md"
         },
         {
-          "title": "Terminal Setup",
-          "path": "terminal-setup.md"
+          "title": "RPC Extension UI",
+          "path": "rpc-extension-ui.md"
         },
         {
-          "title": "Shell Aliases",
-          "path": "shell-aliases.md"
-        }
-      ]
-    },
-    {
-      "title": "Development",
-      "items": [
-        {
-          "title": "Development",
-          "path": "development.md"
+          "title": "Message Types",
+          "path": "message-types.md"
         }
       ]
     }
   ],
   "redirects": [
+    {
+      "from": "development.md",
+      "to": "index.md"
+    },
     {
       "from": "session.md",
       "to": "session-format.md"
@@ -155,6 +191,10 @@
     {
       "from": "tree.md",
       "to": "sessions.md"
+    },
+    {
+      "from": "process-integration.md",
+      "to": "cli-integration.md"
     }
   ]
 }

package/docs/environment-variables.md

@@ -6,7 +6,7 @@ Pi uses environment variables in three ways:
 - Pi sets process markers so child processes can identify Pi as the launching agent.
 - Commands run by the LLM-callable shell tools receive `PI_*` variables describing the current session.
 
-Provider API-key variables are documented separately in [Providers](providers.md#environment-variables-or-auth-file).
+Provider API-key variables are documented separately in [Provider Authentication](providers.md#use-an-api-key-from-the-environment).
 
 ## Process Marker
 
@@ -81,7 +81,7 @@ These variables are read by Pi itself:
 | `PI_CODING_AGENT_DIR` | Override the config directory; default is `~/.pi/agent` |
 | `PI_CODING_AGENT_SESSION_DIR` | Override session storage; overridden by `--session-dir` |
 | `PI_PACKAGE_DIR` | Override the package directory, useful for Nix/Guix store paths |
-| `PI_OFFLINE` | Disable startup network operations, including update checks, package updates, and install/update telemetry |
+| `PI_OFFLINE` | Disable automatic network activity, including model catalog refreshes |
 | `PI_SKIP_VERSION_CHECK` | Disable the `pi.dev` latest-version request |
 | `PI_TELEMETRY` | Override install/update telemetry and provider attribution headers: `1`/`true`/`yes` or `0`/`false`/`no` |
 | `PI_CACHE_RETENTION` | Set to `long` for extended provider prompt caching where supported |
@@ -95,6 +95,4 @@ These variables are read by Pi itself:
 | `VISUAL`, `EDITOR` | External editor fallback when `externalEditor` is unset |
 | `HTTP_PROXY`, `HTTPS_PROXY` | Proxy outbound HTTP requests |
 
-Provider credentials such as `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, and cloud-provider configuration are listed in [Providers](providers.md#environment-variables-or-auth-file).
-
-`PI_SERVER_DIR` and `PI_SERVER_ID` apply only to the source-only [experimental remote harness](development.md#experimental-remote-harness), not distributed builds.
+Provider credentials such as `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, and cloud-provider configuration are listed in [Provider Authentication](providers.md#use-an-api-key-from-the-environment).