# Pine 0.13.0 — Give Pi room to work

Pine puts live widgets, notes, tasks and reusable agents beside your conversation, inside herdr. Pi is the coding agent you talk to; herdr supplies terminal panes and workspaces; Pine supplies the views and saved agents.

[Install Pine](https://pine-pi.vercel.app/install.md) · [Read the documentation](https://pine-pi.vercel.app/docs/index.md) · [View the source](https://github.com/johnlindquist/pine)

## Work from the keyboard

[Watch the keyboard walkthroughs](https://pine-pi.vercel.app/#keyboard). The main Pi conversation stays on the left in Herdr. Dock slip sits above Release review on the right. Both widgets operate on local example data.

- [Dispatch shipment 1042](https://pine-pi.vercel.app/media/keyboard/dock-slip.mp4) and [see the finished slip](https://pine-pi.vercel.app/media/keyboard/dock-slip.png). The terminal keyboard client sends Alt+D to edit Dock, Alt+F to mark the shipment fragile and Alt+Enter to dispatch from C-07. In the native Mac widget, Dispatch shows Command+Enter.
- [Review build 208](https://pine-pi.vercel.app/media/keyboard/herdr-tour.mp4) and [inspect the workspace](https://pine-pi.vercel.app/media/keyboard/herdr-panes.png). Pi holds the build when the seal scan is missing, then approves it after the scan passes. With Release review focused, H and A trigger the same actions.
- Download the [Dock slip](https://pine-pi.vercel.app/media/keyboard/dock-slip.oui) or [Release review](https://pine-pi.vercel.app/media/keyboard/release-review.oui) OpenUI program. The examples and walkthroughs are public. Installation requires access to the private Pine repository.

## When to use Pine

Use Pine to keep a task list or live project data visible while working in Pi, send an exact item reference to your draft, and turn a recurring job into a custom agent you can run again. Built-in notes and tasks are a useful first step. The browser dashboard gives all your widgets room on one page.

## Install and start

Use Node 22.19 or newer, Pi 1.4 or newer and herdr. The reference setup uses herdr 0.9.5. The full guide covers macOS and Linux, existing installations, project trust, recovery and uninstalling without deleting your work.

In a shell, after checking the existing tools:

```sh
npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.4.0
pi install git:github.com/johnlindquist/pine@v0.13.0
```

From your chosen project, start `herdr`, then start `pi` in a shell pane inside herdr. Trust only a project you recognize. In an existing Pi session, use `/reload`. Inside Pi, run these commands one at a time:

```text
/pine doctor --json
/pine open notes
/pine open tasks --popout
/pine status
/pine doctor
```

Confirm that the actual notes and tasks panes are visible and doctor passes. The first view downloads Pine's matching renderer and verifies its SHA-256. See the [complete installation guide](https://pine-pi.vercel.app/install.md) before changing an existing setup.

## Keep work in view

`/pine dashboard` opens a browser page of your widgets. Select a row and choose Send selection, or send the widget state. The reference enters Pi's draft for you to inspect. It does not submit the draft for you.

## Save an agent and keep what it learns

`/pine new agent <job>` builds a saved agent after you choose its access. Read its saved path and trial result before relying on it. The executable lives in your project's `agents/` tree and can run again without Pine. Inside a saved agent, `/feedback fact: <text>` records a correction and `/fix` attempts to apply it with regression checks. Pending feedback is not yet an applied change.

## Bring an agent to your team

`/pine durable <agent>` exports a separate pi-durable application. Review its portability report, run its checks and choose hosting and access deliberately. Local terminal panes and some local tools do not move online. This site has no hosted agent service; its read-only [Pine API and MCP server](https://pine-pi.vercel.app/docs/api.md) only answers questions about releases, installation and documentation.

## Watch or read the workflows

The [homepage](https://pine-pi.vercel.app/) also includes four earlier recordings: building an agent, sending from the dashboard, exporting a team agent and teaching a fact. They show real Pine 0.5.1, Pi, herdr and browser sessions. Only model responses are scripted, with deliberate waits. Read the [walkthroughs](https://pine-pi.vercel.app/transcript.md) without running the player.

## Cost and data

Pine is free software under the [MIT license](https://github.com/johnlindquist/pine/blob/v0.13.0/LICENSE). Notes, tasks and help need no model call. Conversations and builders use the model configured in Pi; provider and optional hosting charges depend on your choices.

Views live in `~/.pine/widgets/` or project `.pine/widgets/`. Notes and tasks live under `~/.local/state/pine`, or `XDG_STATE_HOME/pine`. Saved agents live in the project's `agents/` tree. Your configured model provider receives the context sent to it. Read the [privacy page](https://pine-pi.vercel.app/privacy.md) for the difference between visiting this site and running Pine.

## More

- [Pine documentation](https://pine-pi.vercel.app/docs/index.md)
- [Instructions for agents](https://pine-pi.vercel.app/llms.txt)
- [About Pine](https://pine-pi.vercel.app/about.md)
- [Contact and bug reports](https://pine-pi.vercel.app/contact.md)
- [Privacy](https://pine-pi.vercel.app/privacy.md)