# Install Wrench and capture your first URL.

Wrench is an open-source CLI and TypeScript SDK for command-capable AI agents. Install the immutable release with Bun 1.3.14, synchronize its reviewed adapter manifests, run the local readiness doctor, then start with a public URL.

This guide describes v0.16.11 and was checked against the public source for that immutable release.

## What you need

Wrench runs on macOS and Linux and requires Bun 1.3.14. The CLI does not include an AI model, planner, approval interface, or application shell. It supplies a capability and custody layer for an agent or application that can invoke commands.

A public page capture is the smallest useful first run. Authenticated providers add separate dependencies, account bindings, and contract requirements, so their commands remain unavailable until `wrench doctor` and the relevant capability report say they are ready.

## 1. Install the immutable release

```
bun add --global @hraness/wrench@0.16.11
wrench adapter sync-bundled --json
wrench doctor
```

The global install pins the public npm package to the release version shown above. `adapter sync-bundled` atomically installs the reviewed data manifests shipped by that exact package version. It upgrades an exact bundled baseline, including an older generation whose bytes later drifted, and preserves an independently modified current or newer install.

The matching GitHub tag and immutable Release bind the same checked source and package version. The Agent Skill remains available through skills.sh.

## 2. Inspect a page before saving it

```
wrench read https://example.com/article
```

`wrench read` returns a readable page result without persisting it. To save the page as durable Markdown in a configured knowledge base, pass the URL directly:

```
wrench https://example.com/article
```

Use only material you are authorized to access. Wrench does not bypass login, payment, access controls, or DRM. The [capture and archives guide](https://wrench.rip/capture-and-archives/) explains the difference between page capture and a verified media archive.

## 3. Ask the installed system what it can do

```
wrench capabilities --json
wrench plugin list --json
wrench platforms --json
wrench plugin doctor --json
```

`wrench capabilities` is the local source of truth. It reports the semantic operations that are installed and observed on this machine. A `capture-required` operation is an inert reservation, not partial support and not permission to improvise with a browser fallback.

Review the [provider capability attestation](https://wrench.rip/provider-capabilities/) before adding account credentials. It lists every bundled adapter operation and the reviewed completeness of that contract.

## Watch one complete read

This silent 12-second demo typesets the output from a successful Wrench 0.13.5 run on August 25, 2026. `wrench read` fetches the public page, prints bounded Markdown, and does not add the result to a vault.

The terminal text is actual CLI output. The presentation is typeset for legibility and contains no private state, account data, or provider credentials.

Reuse the [animated GIF](https://wrench.rip/wrench-first-capture.gif) or [PNG preview](https://wrench.rip/wrench-first-capture.png). Both show the same successful public-page read.

### Read the demo transcript

```
$ wrench read https://example.com
Capturing https://example.com/ (auto, auto) ...
---
title: "Example Domain"
source: "https://example.com/"
clipped: "2026-08-25"
platform: "generic"
capture_status: "complete"
capture_method: "http"
capture_scope: "page"
---
# Example Domain

This domain is for use in documentation examples without needing permission. Avoid use in operations.

[Learn more](https://iana.org/domains/example)
```

## 4. Use Wrench from TypeScript

Applications can pin the same release and import its side-effect-free package entrypoints:

```
bun add @hraness/wrench@0.16.11
```

```
import {
  isProviderPluginId,
  type ProviderPluginDefinitionV1,
} from "@hraness/wrench"

if (!isProviderPluginId(candidate.id)) {
  throw new Error("invalid plugin ID")
}

const plugin = candidate satisfies ProviderPluginDefinitionV1
```

The package has seven public TypeScript entrypoints: `@hraness/wrench` for plugin types and bounded validators, `@hraness/wrench/client` for persistent reads and strict live invocation, `@hraness/wrench/beeper` for body-free contact interactions, `@hraness/wrench/apple-photos` for local Photos contact evidence, `@hraness/wrench/whatsapp` for the bounded private Message Like Me export, `@hraness/wrench/omni` for normalized cross-provider reads, and `@hraness/wrench/messaging` for agentic route discovery and resolution. Importing any entrypoint does not start the CLI. Importing the package root also does not inspect local state.

## Wrench developer resources

These are the current public Wrench developer resources for the CLI, TypeScript SDK, Agent Skill, and provider plugin workflow. Wrench does not publish a hosted API, OpenAPI description, OAuth developer portal, webhook catalog, or MCP server.

- [Install the `@hraness/wrench` CLI and TypeScript SDK from npm](https://www.npmjs.com/package/@hraness/wrench/v/0.16.11)
- [Install the Wrench Agent Skill from skills.sh](https://skills.sh/hraness/wrench) with `npx skills add hraness/wrench#v0.16.11`
- [Capture URLs and create verified media archives](https://wrench.rip/capture-and-archives/)
- [Watch and download the first-capture demo](https://wrench.rip/getting-started/#demo)
- [Provider capability attestation](https://wrench.rip/provider-capabilities/)
- [Security and local custody](https://wrench.rip/security/)
- [Author and verify provider plugins](https://wrench.rip/plugins/)
- [Source, issues, and release tags](https://github.com/hraness/wrench)
- [Plugin protocol guide for v0.16.11](https://github.com/hraness/wrench/blob/v0.16.11/docs/plugins.md)
- [Agent site guide (llms.txt)](https://wrench.rip/llms.txt)

## Choose the next boundary

Learn how Wrench keeps credentials opaque and provider changes visible in the [security guide](https://wrench.rip/security/), or start an inert integration with the [plugin authoring guide](https://wrench.rip/plugins/).