warpdotdev · warp-factories · Aug 28, 2026 · Aug 28, 2026 · Aug 30, 2026 · warp-for-oss
diff --git a/.agents/skills/missing_docs/references/changelog_decisions.md b/.agents/skills/missing_docs/references/changelog_decisions.md
@@ -32,6 +32,33 @@ Newest first. One row per PR number — usually a `warpdotdev/warp` changelog it
 
 | PR | Decided | Verdict | Gate / disqualifier | Reason and outcome |
 |---|---|---|---|---|
+| LrcActivitySignal (flag added, dogfood) | 2026-08-30 | deferred | Gate 0 | New dogfood-status feature flag. Not GA, so not documentable. No map entry needed — dogfood flags sit in the `tracked_non_ga` accounting bucket and the snapshot diff re-flags the flag if it is promoted or removed. Re-check on promotion to preview or GA. |
+| /continue-locally, /handoff, /remote-control, /set-tab-color (GUI slash command table) | 2026-08-28 | yes | Gate 1 | Exhaustive re-run of the slash audit scoped by `SlashCommandSurfaces` (the standard check is repo-wide, the blind spot that let `/usage` ship undocumented). Four GA GuiOnly/GuiAndTui commands in `app/src/search/slash_command_menu/static_commands/commands.rs`, none carrying a `feature_flag`, were absent from the "built-in Slash Commands" table on `agents/capabilities/slash-commands.mdx`, which presents itself as the complete list. `/set-tab-color` was undocumented anywhere. Added four table rows plus a `/set-tab-color` paragraph under **Tab colors** in `terminal/windows/tabs.mdx` (feature PR). CLI side is clean: all 32 TUI-capable commands covered under `agents/cli/`. |
+| n/a (81 --weak-coverage feature findings) | 2026-08-28 | no | Disqualified: not a docs gap / heuristic false positive | Ran `--weak-coverage` for exhaustiveness. Every hit is a curated surface-map entry whose page lacks a phrase derived from the internal flag name. Spot-verified against code and docs: `FullScreenZenMode` → `workspace_decoration_visibility` documented in `all-settings.mdx`; `SuggestedRules` → `agents.warp_agent.active_ai.rule_suggestions_enabled` documented and behavior described in `rules.mdx`; `SharedWithMe` → direct and link sharing documented in `warp-drive/index.mdx`; `GroupedTabs`/`DragTabsToWindows`/`UndoClosedPanes` → all covered in `tabs.mdx`. |
+| n/a (KittyImages map target) | 2026-08-28 | n/a | Map hygiene | Surfaced by the same `--weak-coverage` pass. The entry pointed at `terminal/more-features/full-screen-apps.mdx`, which documents the Kitty *keyboard* protocol; the Kitty *image* protocol is documented on `terminal/more-features/files-and-links.mdx`. Retargeted the entry. No docs change needed. |
+| n/a (/docker-sandbox) | 2026-08-28 | no | Already mapped `-> internal` | Absent from the GUI slash command table, but deliberately mapped internal. Left out of the table completion above. |
+| n/a (23 potentially_stale_docs, itemized) | 2026-08-28 | no | Disqualified: not a docs gap / owned by style_lint | Re-verified line by line rather than in bulk. "AI credits" is the deliberate name of the inference bucket, contrasted throughout with compute credits and platform credits (`plans-and-billing/platform-credits.mdx`); "Warp AI" hits are verbatim telemetry event names in `privacy.mdx` plus one historical FAQ heading; "Warp Terminal" hits are the distinguishing usage the style guide permits; "generate command" and "AI command" refer to the live Generate and AI Command Search features. Supersedes the bulk row below. |
+| terminal.input.warp_completions_enabled, terminal.input.native_shell_completions_enabled | 2026-08-28 | yes | Gate 1 | Always-on bool knobs in `app/src/settings/input.rs` (`toml_path` each; defaults `true`). UI labels "Warp completions" and "Native shell completions" under **Settings** > **Features** > **Terminal Input** (`features_page.rs`). Documented in `terminal/settings/all-settings.mdx` under `[terminal.input]`. |
+| agents.custom_endpoints | 2026-08-28 | yes | Gate 1 | Always-on structured setting `agents.custom_endpoints` in `app/src/settings/ai.rs` holding non-secret custom inference endpoint definitions (credentials stay in secure storage). Same pattern as `execution_profiles`. Feature already documented at `agents/inference/custom-inference-endpoint.mdx`; added the settings-file key to `terminal/settings/all-settings.mdx`. |
+| GET /factory/{uid}/integrations/issue-tracker/issues, POST /factory/{uid}/integrations/slack/connection-test-greeting | 2026-08-28 | deferred | Gate 0 | New public_api factory routes in `router/handlers/public_api/factories.go`. Released OpenAPI has zero `/factory` paths; sync-openapi-spec excludes the namespace while the Factory REST API is unreleased. Mapped `-> internal`; re-check when the factory API is published. |
+| agents.warp_agent.other.usage_display_unit | 2026-08-28 | deferred | Gate 0 | New GUI setting gated by dogfood flag `PricingTransparency` (`app/src/settings/ai.rs`). Snapshot status dogfood; not documentable until the flag is GA. Tracked by snapshot; re-check on promotion. |
+| NativeShellCompletions (flag other→dogfood) | 2026-08-28 | deferred | Gate 0 | Flag status moved other → dogfood. Already on the ignore list as a sub-feature toggle; the always-on settings above are the documentable knobs. Re-check only if the flag is promoted and changes user-facing surface beyond those settings. |
+| n/a (changelog 2026.08.27 Factories EA) | 2026-08-28 | no | Disqualifier: major launch / already documented | Duplicate of the 2026.08.25 Factories EA launch bullet already decided. Full `src/content/docs/factories/` set already ships. |
+| [#15515](https://github.com/warpdotdev/warp/pull/15515) | 2026-08-28 | no | Disqualified: pure UI affordance | Removed first-time-user banners/prompts on shared session or conversation transcript views. No setting or workflow change for the reader. |
+| [#15258](https://github.com/warpdotdev/warp/pull/15258) | 2026-08-28 | no | Disqualified: small and intuitive | Disabled team/workspace members shown grayed out with a tooltip. Understood on sight; no configuration. |
+| [#15424](https://github.com/warpdotdev/warp/pull/15424) | 2026-08-28 | no | Disqualified: pure UI affordance | Renamed settings page "Oz Cloud API Keys" → "API keys" under Cloud platform. Docs already say "API keys" (`reference/cli/api-keys.mdx`); no remaining "Oz Cloud API Keys" prose outside the changelog. |
+| [#15395](https://github.com/warpdotdev/warp/pull/15395) | 2026-08-28 | no | Disqualified: no user-observable change requiring action / platform parity | IME composition input enabled on Windows and Linux (was macOS-only). Restores expected input behavior; no knob or setup steps. |
+| [#15365](https://github.com/warpdotdev/warp/pull/15365) | 2026-08-28 | no | Already documented (Gate 1 covered) | Right-click paste setting. Concrete knob `terminal.input.right_click_behavior` already documented in `all-settings.mdx` with options `context_menu` / `paste` and Shift+right-click note. No further docs change. |
+| [#15340](https://github.com/warpdotdev/warp/pull/15340) | 2026-08-28 | no | Already documented (Gate 1 covered) | Setting to stop `#` opening AI Command Search. Concrete knob `terminal.input.enable_ai_command_search_hash_trigger` already in `all-settings.mdx` with default and keyboard-shortcut fallback. No further docs change. |
+| [#15148](https://github.com/warpdotdev/warp/pull/15148) | 2026-08-28 | no | Gate 0 / disqualified: pure UI affordance for GA surface | Usage surfaces show per-category dollar cost alongside credits. The configurable unit `agents.warp_agent.other.usage_display_unit` is dogfood-gated by `PricingTransparency`; the visible dual display is an improvement to existing usage UI, small and intuitive once shown. Defer documenting the unit setting until GA. |
+| [#15346](https://github.com/warpdotdev/warp/pull/15346) | 2026-08-28 | no | Disqualified: pure UI affordance | Added "Paste" to the terminal block list right-click context menu. No setting. |
+| [#13967](https://github.com/warpdotdev/warp/pull/13967) | 2026-08-28 | no | Disqualified: no user-observable change requiring action | Markdown viewer preserves scroll position between Rendered and Raw modes. Improves on its own. |
+| [#15221](https://github.com/warpdotdev/warp/pull/15221) | 2026-08-28 | no | Disqualified: pure UI affordance / small and intuitive | Holding a modifier shows each tab's switch-to-tab shortcut on the tab. Discoverable in-product; shortcuts already documented. |
+| [#15505](https://github.com/warpdotdev/warp/pull/15505) | 2026-08-28 | no | Disqualified: bug fix restoring intended behavior | Fixed handoff snapshot files not reaching a rebuilt cloud sandbox. Restores expected handoff file availability; handoff docs already describe the feature. |
+| n/a (changelog 2026.08.25 Factories EA) | 2026-08-28 | no | Disqualifier: major launch / already documented | Already decided 2026-08-25; repeated here only because the snapshot's last-seen changelog version lagged this release range. |
+| [#14968](https://github.com/warpdotdev/warp/pull/14968) | 2026-08-28 | no | Already decided 2026-08-25 | Inline `/usage` already verdicted yes; prior run owns the docs update. Skipped re-draft. |
+| n/a (oz_updates / changelog 2026.08.25 MCP) | 2026-08-28 | no | Already decided 2026-08-25 | Intermittent MCP-after-rebuild fix already verdicted no as a bug fix. |
+| n/a (23 potentially_stale_docs findings) | 2026-08-28 | no | Disqualified: not a docs gap / owned by style_lint | Same class as 2026-08-26: terminology matches only (including known `ai credits` false positives). No missing content. |
 | POST /agent/runs/{runId}/environment-snapshot | 2026-08-26 | no | Gate 0 + disqualified: no user-observable surface | Marked `x-internal: true` in warp-server's canonical spec, so the publish filter strips it from `developers/agent-api-openapi.yaml`. Registered behind `ambient_task.ValidateAmbientTask` + `RequireCloudAgent(true)` and rejects any caller whose token is not the run's own active execution (`agent_environment_snapshot.go`), so no API consumer can ever call it. Machine-facing worker plumbing like its `client-events` and `event-sequence` siblings. Mapped `-> internal`. |
 | POST /factory/{uid}/github-onboarding-pr | 2026-08-26 | deferred | Gate 0 | Opens/refreshes the throwaway branch and PR that verify a factory's GitHub connection during onboarding (`factories.go`). In the `/factory` namespace, which sync-openapi-spec excludes wholesale while the Factory REST API is unreleased; released public spec has zero `/factory` paths. Mapped `-> internal`; re-check when the factory API is published. |
 | POST /factory/{uid}/source/branch/sync, DELETE /factory/{uid}/source/branch | 2026-08-26 | deferred | Gate 0 | Integrate production drift into, and discard, a `warp/code/*` working branch behind the factory definition editor (`factory_code_browser.go`). Same `/factory` namespace exclusion as the sibling `source/*` routes already mapped internal. Mapped `-> internal`; re-check with the factory API publish. |

diff --git a/.agents/skills/missing_docs/references/feature_surface_map.md b/.agents/skills/missing_docs/references/feature_surface_map.md
@@ -141,7 +141,9 @@ Changelog -> src/content/docs/changelog/index.mdx
 Autoupdate -> src/content/docs/support-and-community/troubleshooting-and-support/updating-warp.mdx
 ShellSelector -> src/content/docs/getting-started/supported-shells.mdx
 WorkflowAliases -> src/content/docs/terminal/entry/yaml-workflows.mdx
-KittyImages -> src/content/docs/terminal/more-features/full-screen-apps.mdx
+# The Kitty *image* protocol is documented on files-and-links.mdx; full-screen-apps.mdx
+# covers the Kitty *keyboard* protocol, which is a different surface.
+KittyImages -> src/content/docs/terminal/more-features/files-and-links.mdx
 UndoClosedPanes -> src/content/docs/terminal/windows/tabs.mdx
 # Tab groups (organize tabs into named, collapsible groups) — GA (in the default
 # feature set).
@@ -528,6 +530,10 @@ GET /factory/{uid}/integrations/linear/users -> internal
 GET /factory/{uid}/integrations/linear/workflow-states -> internal
 GET /factory/{uid}/integrations/slack/conversations -> internal
 GET /factory/{uid}/integrations/slack/users -> internal
+# Issue-tracker issue picker and Slack connection-test greeting used by the
+# factory integrations UI. Same unreleased `/factory` namespace as siblings above.
+GET /factory/{uid}/integrations/issue-tracker/issues -> internal
+POST /factory/{uid}/integrations/slack/connection-test-greeting -> internal
 # Factory benchmark suites and benchmark runs
 # (router/handlers/public_api/benchmarks.go). Same unreleased Factory product as
 # the routes above, and absent from warp-server's canonical public spec.

diff --git a/.agents/skills/missing_docs/references/last_release_processed.json b/.agents/skills/missing_docs/references/last_release_processed.json
@@ -1,8 +1,8 @@
 {
-  "last_processed_version": "v0.2026.08.19.08.15.stable_01",
-  "release_date": "2026-08-19T22:28:46Z",
-  "processed_at": "2026-08-25T00:58:59Z",
-  "changelog_entry_count": 5,
+  "last_processed_version": "v0.2026.08.26.17.59.stable_01",
+  "release_date": "2026-08-27T23:50:37+0000",
+  "processed_at": "2026-08-28T16:06:31Z",
+  "changelog_entry_count": 39,
   "oz_updates_count": 1,
   "_comment": "Written by check_new_release.py --commit after a drift-watch run completes triage. Kept separate from surface_snapshot.json, which is regenerated wholesale and would lose this marker. Do not hand-edit; to force a re-run of the current release, delete this file."
 }
diff --git a/.agents/skills/missing_docs/references/surface_snapshot.json b/.agents/skills/missing_docs/references/surface_snapshot.json
@@ -173,6 +173,7 @@
     "LocalComputerUse": "dogfood",
     "LocalDockerSandbox": "dogfood",
     "LogExpensiveFramesInSentry": "dogfood",
+    "LrcActivitySignal": "dogfood",
     "MCPGroupedServerContext": "ga",
     "MSYS2Shells": "dogfood",
     "MarkdownImages": "dogfood",
@@ -188,7 +189,7 @@
     "MultiProfile": "ga",
     "MultiWorkspace": "dogfood",
     "NamedAgents": "ga",
-    "NativeShellCompletions": "other",
+    "NativeShellCompletions": "dogfood",
     "NewTabStyling": "ga",
     "NldPromptHistoryMatch": "other",
     "OpenCodeNotifications": "ga",
@@ -896,6 +897,7 @@
     "GET /api/v1/factory/{uid}/integrations/github/teams",
     "GET /api/v1/factory/{uid}/integrations/github/users",
     "GET /api/v1/factory/{uid}/integrations/github/workflows",
+    "GET /api/v1/factory/{uid}/integrations/issue-tracker/issues",
     "GET /api/v1/factory/{uid}/integrations/jira/labels",
     "GET /api/v1/factory/{uid}/integrations/jira/projects",
     "GET /api/v1/factory/{uid}/integrations/jira/statuses",
@@ -976,6 +978,7 @@
     "POST /api/v1/factory/{uid}/benchmarks/tasks/compose-from-run",
     "POST /api/v1/factory/{uid}/github-onboarding-pr",
     "POST /api/v1/factory/{uid}/gitlab-automation-capability/refresh",
+    "POST /api/v1/factory/{uid}/integrations/slack/connection-test-greeting",
     "POST /api/v1/factory/{uid}/merges",
     "POST /api/v1/factory/{uid}/merges/check",
     "POST /api/v1/factory/{uid}/plan",
@@ -1087,6 +1090,7 @@
     "accessibility.accessibility_verbosity": "always_on",
     "account.is_settings_sync_enabled": "always_on",
     "agents.cloud_conversation_storage_enabled": "always_on",
+    "agents.custom_endpoints": "always_on",
     "agents.execution_profiles": "always_on",
     "agents.knowledge.rules_enabled": "always_on",
     "agents.knowledge.warp_drive_context_enabled": "always_on",
@@ -1140,6 +1144,7 @@
     "agents.warp_agent.other.show_agent_notifications": "always_on",
     "agents.warp_agent.other.show_conversation_history": "always_on",
     "agents.warp_agent.other.thinking_display_mode": "always_on",
+    "agents.warp_agent.other.usage_display_unit": "dogfood",
     "appearance.blocks.should_show_bootstrap_block": "always_on",
     "appearance.blocks.should_show_in_band_command_blocks": "always_on",
     "appearance.blocks.should_show_ssh_block": "always_on",
@@ -1281,11 +1286,13 @@
     "terminal.input.honor_ps1": "always_on",
     "terminal.input.input_box_type_setting": "always_on",
     "terminal.input.middle_click_paste_enabled": "always_on",
+    "terminal.input.native_shell_completions_enabled": "always_on",
     "terminal.input.outline_codebase_symbols_for_at_context_menu": "always_on",
     "terminal.input.right_click_behavior": "always_on",
     "terminal.input.show_hint_text": "always_on",
     "terminal.input.show_terminal_input_message_bar": "always_on",
     "terminal.input.syntax_highlighting": "always_on",
+    "terminal.input.warp_completions_enabled": "always_on",
     "terminal.maximum_grid_size": "always_on",
     "terminal.mouse_reporting_enabled": "always_on",
     "terminal.osc52_clipboard_access": "always_on",
@@ -1430,5 +1437,5 @@
     "verify-ui-change-in-cloud": "dogfood",
     "warpctrl": "bundled"
   },
-  "changelog_last_version": "2026.08.19"
+  "changelog_last_version": "2026.08.27"
 }
diff --git a/src/content/docs/terminal/settings/all-settings.mdx b/src/content/docs/terminal/settings/all-settings.mdx
@@ -187,6 +187,8 @@ Settings that control terminal behavior, input, and event handling.
 * `error_underlining_enabled` — Whether command errors are underlined in the input. Type: boolean. Default: `true`.
 * `completions_open_while_typing` — Whether the completions menu opens automatically while typing. Type: boolean. Default: `false`.
 * `classic_completions_mode` — Whether classic completions mode is enabled. Type: boolean. Default: `false`.
+* `warp_completions_enabled` — Whether Warp's built-in completions are shown for shell commands. When enabled, **Settings** > **Features** > **Terminal Input** also exposes "Open completions menu as you type" as a nested control (the same knob as `completions_open_while_typing`). Type: boolean. Default: `true`.
+* `native_shell_completions_enabled` — Whether your shell's own completions are used for shell commands. Native shell completions are not generated as you type; press `Tab` (or your completions keybinding) to fetch them. Type: boolean. Default: `true`.
 * `show_hint_text` — Whether hint text is shown in the terminal input. Type: boolean. Default: `true`.
 * `show_terminal_input_message_bar` — Whether the terminal input message bar is shown. Type: boolean. Default: `true`.
 * `enable_slash_commands_in_terminal` — Whether slash commands are available in the terminal input. Type: boolean. Default: `true`.
@@ -265,6 +267,7 @@ Settings for Warp's agents, including model behavior, permissions, knowledge, MC
 * `cloud_conversation_storage_enabled` — Whether conversations are stored in the cloud. Type: boolean. Default: `true`.
 * `usage_display_mode` — Which unit the terminal agent's usage entry displays. Applies only to the terminal agent's settings file; click the usage entry to flip between units. Type: string. Default: `"credits"`. Options: `"credits"` (the same number the desktop app's usage footer shows), `"cost"` (provider dollar cost).
 * `execution_profiles` — The collection of [agent profiles](/agents/capabilities/agent-profiles-permissions/) and their permissions, shared by Agent Mode and the terminal agent. This is a structured object that Warp manages when you create and edit profiles in **Settings** > **Agents** > **Profiles**; edit it through the UI rather than by hand. Type: object. Default: `{}` (Warp's built-in profiles).
+* `custom_endpoints` — Non-secret [custom inference endpoint](/agents/inference/custom-inference-endpoint/) definitions (URL, models, schema). Credentials stay in local secure storage, not in this object. Warp manages the collection from **Settings**; edit it through the UI rather than by hand. Type: object. Default: `{}`.
 
 ### Knowledge