CLI Commands

waypoint init

Sets up Waypoint in a git repository. Run from the repo root.

waypoint init

What it does:

1. Updates CLAUDE.md with the instruction to call get_waypoint_context before editing files and list_waypoints at session start
2. Updates .gitignore to exclude .waypoint/sessions/ (sessions live on the server, not in git)
3. Registers the Stop hook in .claude/settings.json
4. Installs the /pr-summary slash command in .claude/commands/
5. Prompts for server URL and API key if not already configured

Safe to re-run — existing config is not overwritten.

waypoint connect

Configures the server URL and API key for the current user.

waypoint connect <server-url>

Example:

waypoint connect https://waypoint.yourcompany.com

The command checks that the server is reachable, then prompts for your API key (input is hidden). Config is saved to ~/.waypoint/config.json with 0600 permissions.

Config can also be set via environment variables, which take precedence over the file:

export WAYPOINT_SERVER_URL=https://waypoint.yourcompany.com
export WAYPOINT_API_KEY=wp_...

waypoint generate

Parses an agent session transcript from stdin and posts it to the server.

waypoint generate

You do not normally call this directly — it's invoked automatically by the Stop hook after each session. If you want to replay a transcript manually, pipe it in:

cat session.json | waypoint generate

What it does:

1. Reads the stop hook JSON from stdin (transcript path + session metadata)
2. Parses the transcript into structured events (user_prompt, agent_response, agent_plan, bash_command, file_edit, file_read, tool_use, waypoint_context)
3. Flags third-party service calls (bash_command and tool_use events involving external CLIs or non-Waypoint MCP tools)
4. Captures git state (branch, commit, changed files)
5. Posts the session to the configured server

If no server is configured, a warning is printed and the session is not saved:

[waypoint] No server configured — session not saved. Run `waypoint connect <url>` to set up.

waypoint show

Shows the development history for a file.

waypoint show [filepath]

Example:

waypoint show src/auth/middleware.ts

If no filepath is given, shows recent sessions for the current repo. Queries the server (if configured).

waypoint pr-context

Emits session context for the current branch, formatted for the /pr-summary slash command. Called internally by /pr-summary — not typically used directly.

waypoint pr-context