mirror of
https://github.com/Ark0N/Codeman.git
synced 2026-10-07 07:59:42 +02:00
docs(wiki): catch the manual up to 1.29.0 and add the three run modes it never had
The wiki was written for seven run modes and never received Grok Build, DeepSeek Harness or OMP. They now appear everywhere the others do: the modes table and per-CLI notes, install commands, environment prefixes, the Quick Start table, the requirements rows, the vocabulary, and every "seven modes" count. The 1.27 to 1.29.0 changes land on the pages that own them: attaching a case to an existing container, multi-case adoption and the copy-a-case picker (Docker Cases); file reads over ssh in remote cases and what stays unavailable (Remote SSH Sessions, Working With Files, Security); single-page app routing, frame recovery, localhost links as tabs and the egress guard (Web Tabs); DeepSeek as the one non-Claude mode with real stop/blocked signals and Approvals items, Codex's own work detection, last-response, the model-endpoint routes and refreshed counts (HTTP API, Driving From An Agent, Hooks, Notifications, Keeping Agents Running, Core Concepts); Shift+drag, right-click copy, Auto Copy, the Ctrl+Z guard, font weight, the vertical rail and its activity sort (Keyboard Shortcuts, Input And Voice, The Dashboard, Settings Reference); the 600px phone cutoff, Codex shift arrows and iPhone Duo (Mobile Guide); the Docker Compose route and its update rule (Installation, Running As A Service); four new symptom entries and a "which CLIs" question (Troubleshooting, FAQ). Custom model endpoints are deliberately left to #430, which adds that page and edits Agent CLIs, Settings Reference and the sidebar; these edits stay out of the regions #430, #428 and #376 touch, and all three still merge cleanly on top. Both READMEs: the web-tab menu entry is labelled "Add URL" in the UI, not "Add dashboard". Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
@@ -24,6 +24,23 @@ Switching tabs does not reload a dashboard. Frames stay alive in the background,
|
||||
took a while to authenticate is still there when you come back. Past six live frames, the
|
||||
least recently viewed is dropped to bound memory.
|
||||
|
||||
## Single-page apps, reloads and links
|
||||
|
||||
A history-routed dashboard (React Router, Vue Router, a Vite dev server) sees the path it
|
||||
would see on its own origin, not the proxy prefix, so it renders its real route instead of
|
||||
its own "page not found". A navigation the page starts itself afterwards, a dev server's
|
||||
full reload or a root-absolute `location.href`, would land outside the proxy with no
|
||||
capability; Codeman recognises it, answers with a small recovery page, and remounts the
|
||||
frame at the path that was lost, bounded to five recoveries a minute per frame. A reload on
|
||||
the dashboard's landing page is recovered the same way.
|
||||
|
||||
A `localhost` or `127.0.0.1` link in agent output opens as a web tab automatically, reusing
|
||||
a saved dashboard for the same server or saving one under its `host:port`. On a phone that
|
||||
address only exists on the Codeman box, so the link would otherwise be a guaranteed
|
||||
connection error. LAN and tailnet addresses still open directly. `*.localhost` names are
|
||||
deliberately not auto-routed: they are DNS names rather than address literals, and the link
|
||||
came from agent output. Add such a dashboard by hand instead.
|
||||
|
||||
## Why dashboards are proxied
|
||||
|
||||
A plain cross-origin iframe fails three ways at once in the setup Codeman actually ships in:
|
||||
@@ -89,6 +106,12 @@ The proxy authenticates on an in-memory capability embedded in the path, which i
|
||||
exempt from the cookie and Origin checks that every API route enforces. That exemption is
|
||||
fenced to safe methods and non-API paths, and there is a test pinning it in place.
|
||||
|
||||
Saved URLs are refused when they point at a link-local or cloud-metadata address, at save
|
||||
time and again against the address the name resolves to at connect time; loopback and
|
||||
private ranges stay allowed, because a `localhost` Grafana is the feature. Capabilities are
|
||||
revoked on logout, and proxied responses carry a same-origin referrer policy so a dashboard
|
||||
cannot hand the capability-bearing URL to a third party.
|
||||
|
||||
Two failure modes that only appear inside a sandboxed frame, and that curl can never
|
||||
reproduce, are handled: runtime-built root-absolute URLs escaping the injected base, and
|
||||
same-host requests being CORS-checked with a null origin. Both present as the dashboard's own
|
||||
|
||||
Reference in New Issue
Block a user