Installation

Choose how you want to work

For occasional feedback, install the browser extension, annotate your page, and copy the feedback into your coding-agent chat. You do not need the local server or MCP for this path.

For an ongoing feedback loop, also install the Waypoint CLI, start its local server, and connect your agent through MCP. The agent can then read and update the Queue directly. The recommended Waypoint skill teaches it how to handle that work.

Current availability

Install Logbook Waypoint from the Chrome Web Store for the supported browser-extension experience.

The separate Waypoint CLI is published through npm and as a checksummed GitHub Release. The curl installer is recommended for agent workflows because it installs both the CLI and Waypoint skill. npm installs the CLI; add the skill separately.

Recommended: install from a GitHub Release

Run the public installer to download and verify the latest Waypoint CLI release. It includes Waypoint’s agent workflow skill by default, installing globally for the universal agent target without prompting. It uses AFK when available and otherwise runs the Skills CLI through npx.

To opt out, pipe the installer into bash -s -- --skip-skill. The installer remembers that choice for future updates. Re-run with --yes to enable skill installation again. If the skill step fails, the CLI still installs and prints a retry command.

curl -fsSL https://waypoint.logbookfordevs.com/install.sh | bash
waypoint start

Node.js 22.12+ required. GitHub installs to ~/.local/bin and flags missing PATH setup.

Alternative: install through npm

Install the published CLI package globally, then add the Waypoint skill separately with the Skills CLI. Use npx @logbookfordevs/waypoint --help for a temporary first look. Start runs the local server in the background by default.

npm install --global @logbookfordevs/waypoint
npx skills@latest add logbookfordevs/logbook-waypoint --skill waypoint --global
waypoint start

Recommended for agent workflows. The skill is not required when you use Waypoint only for visual annotation and copy.

Install the agent workflow skill

The Waypoint skill teaches a coding agent how to find the current local project, begin with compact Queue context, Claim before editing, and interpret lifecycle and Variant decisions correctly. MCP provides access to Waypoint’s tools; the skill provides the working method.

The GitHub installer includes a global universal-target installation automatically. If you installed through npm, opted out, or need a specific harness, run the command below to choose the agent harnesses where you use Waypoint.

npx skills@latest add logbookfordevs/logbook-waypoint --skill waypoint --global

Enable your first page

Open the page you want to work on, then open Waypoint from your browser’s extensions menu. Local development sites are supported automatically; other sites offer Enable for this site. Show the toolbar using the extension’s toggle. If you see Reload to activate, reload the page first.

Choose Annotate in the toolbar and select an element. Write a small request, such as “Change this button label to Save changes,” then save it. Open the Queue and check that your comment is there. This verifies the browser workflow before you add an agent.

Continue with Core Workflow for copy and paste, or Agent Setup to connect the Queue directly to your coding agent.

Build the extension from source

Clone the repository, install the workspace, and build the browser extension with pnpm.

Open chrome://extensions, enable Developer mode, choose Load unpacked, and select packages/extension/.output/chrome-mv3.

git clone https://github.com/logbookfordevs/logbook-waypoint.git
cd logbook-waypoint
pnpm install
pnpm build