Skip to content
Permalink

Comparing changes

Choose two branches to see what’s changed or to start a new pull request. If you need to, you can also or learn more about diff comparisons.

Open a pull request

Create a new pull request by comparing changes across two branches. If you need to, you can also . Learn more about diff comparisons here.
base repository: ref-tools/docs
Failed to load repositories. Confirm that selected base ref is valid, then try again.
Loading
base: main
Choose a base ref
...
head repository: ref-tools/docs
Failed to load repositories. Confirm that selected head ref is valid, then try again.
Loading
compare: docs/local-agent-install
Choose a head ref
Checking mergeability… Don’t worry, you can still create the pull request.
  • 7 commits
  • 8 files changed
  • 1 contributor

Commits on Aug 12, 2026

  1. Document the local-agent install one-liner 

    Adds plans/install/local-agent.mdx covering the curl | bash installer that
ref.tools leads with: the unified command, per-agent variants and why they
must be quoted, platform support, sign-in via browser device pairing,
re-running and updates, what the plugin adds to each agent, and uninstall.

Lists it first in the Install MCP Server group and points at it from the
install index intro and card group.
    @tj-ref
    tj-ref committed Aug 12, 2026
    Configuration menu
    Copy the full SHA
    2af2db7 View commit details
    Browse the repository at this point in the history

  2. Plainer wording: prefer needs/needed and earlier 

    Word-level pass toward simplified technical English. Swaps requires/required
and previous for their plainer equivalents on lines this PR introduced.
No technical content or product names changed.
    @tj-ref
    tj-ref committed Aug 12, 2026
    Configuration menu
    Copy the full SHA
    d69a488 View commit details
    Browse the repository at this point in the history

  3. Rework the local-agent page around install and the Plans UI 

    Retitles "Quick Install" to "Local agents" and reorders the page around what a
reader needs: the one install command and the browser approval, a supported
platforms table, then the payoff — local sessions in the Ref Plans sidebar with
live status, the plan/investigation/receipt shapes, the review wait, and the
trigger rating.

Cuts the implementation detail: the step-by-step of what the installer writes,
manifests, PATH and binaries, the uninstall flag table, and the capture-policy
and plugin internals. Targeted per-agent installs and the uninstall command stay,
demoted below the plain install, with the quoting warning intact.

Updates the install index lead-in and card to match the new title.
    @tj-ref
    tj-ref committed Aug 12, 2026
    Configuration menu
    Copy the full SHA
    e44187d View commit details
    Browse the repository at this point in the history

  4. Rework local agents page from review 

    Trims the page to what a reader needs: install and support first, then what
changes once connected. Adds a Support matrix in the same shape the custom MCP
page uses, a short how-it-works, the session states a sidebar row renders, and
the plan-review loop.

Drops the installer walkthrough, binary and PATH mechanics, the capture-policy
note, and the uninstall flag table. Session-state glyphs are inline data URIs
taken from the sidebar's own icon source. Harness requests point at the existing
request form.
    @tj-ref
    tj-ref committed Aug 12, 2026
    Configuration menu
    Copy the full SHA
    27f3a22 View commit details
    Browse the repository at this point in the history

  5. Present local-agent support as agent cards plus a platform line 

    The support matrix repeated 'Supported' across four rows to carry five
facts. Agents are the question readers arrive with, so they lead as
cards; platforms and the Codex version floor fit in one sentence.
    @tj-ref
    tj-ref committed Aug 12, 2026
    Configuration menu
    Copy the full SHA
    470f8e2 View commit details
    Browse the repository at this point in the history

  6. Serve session-state glyphs as committed SVGs 

    Base64 data URIs were the only ones in the repo, did not preview on
GitHub, and left the diff unreviewable. The glyphs also carried no
intrinsic size, so an img referencing them fell back to the default
replaced-element box instead of rendering at glyph scale.
    @tj-ref
    tj-ref committed Aug 12, 2026
    Configuration menu
    Copy the full SHA
    92fc4c9 View commit details
    Browse the repository at this point in the history

  7. Correct session-state glyphs against the product's own icons 

    Four glyphs now carry the exact geometry of the components the sidebar
renders. The running glyph had no SVG to copy: the product renders a CSS
border-ring primitive, so it is reproduced as a stroked three-quarter
circle at the same relative weight and given the same 0.8s linear spin.

Colors were hand-picked hex that matched no token. They now resolve
through the real values behind the tone classes, with the dark-mode
variants the palette defines.
    @tj-ref
    tj-ref committed Aug 12, 2026
    Configuration menu
    Copy the full SHA
    34fb74f View commit details
    Browse the repository at this point in the history
Loading