# Pine documentation

Pine 0.13.0 adds terminal widgets, a local browser dashboard and saved custom agents to Pi in herdr. Choose the task you want to do, then follow its guide. The [installation guide](https://pine-pi.vercel.app/install.html) provides complete commands and expected results; its [Markdown version](https://pine-pi.vercel.app/install.md) is suitable for an agent to read directly.

## Start with a working workspace

Use Node 22.19+, Pi 1.4+ and herdr. The reference setup uses herdr 0.9.5. Inside Pi, `/pine help` explains the commands, `/pine open notes` opens the first built-in view and `/pine doctor --json` checks the actual environment. Notes, tasks and help need no model call. Conversations and builders use the model configured through Pi's `/login` and `/model` commands.

- [Install, verify, troubleshoot and uninstall Pine](https://pine-pi.vercel.app/install.html)
- [Read the five recorded workflows](https://pine-pi.vercel.app/transcript.md)
- [Full Pine 0.13.0 command reference](https://github.com/johnlindquist/pine/blob/v0.13.0/README.md)

## Keep notes, tasks and project data visible

`/pine open notes` and `/pine open tasks --popout` show built-in views in terminal panes. `/pine dashboard` opens all widgets as cards in a browser. Send selection and Send state put a reference in Pi's draft; they do not submit it. Inspect the draft and decide what to send.

- [Widgets and exact references](https://github.com/johnlindquist/pine/blob/v0.13.0/docs/widgets.md)
- [Browser dashboard](https://github.com/johnlindquist/pine/blob/v0.13.0/docs/dashboard.md)
- [Browser pages and reconnecting](https://github.com/johnlindquist/pine/blob/v0.13.0/docs/pages.md)

## Save and improve a custom agent

`/pine new agent <job>` starts a builder after you choose the agent's access. A completed agent is an executable in `./agents/<name>` with its own guide and checks. Use `/feedback` to record improvements and `/fix` to attempt them. Review the trial and check results; a pending correction is not proof that the agent has changed.

- [Custom agents and workspaces](https://github.com/johnlindquist/pine/blob/v0.13.0/docs/agents.md)
- [Feedback, facts and fixes](https://github.com/johnlindquist/pine/blob/v0.13.0/docs/feedback.md)
- [Conversation-based suggestions](https://github.com/johnlindquist/pine/blob/v0.13.0/docs/brainstorm.md)
- [Build and fix progress](https://github.com/johnlindquist/pine/blob/v0.13.0/docs/progress.md)

## Use Pine's local tools from an agent

After installation, Pi exposes `pine_view`, `pine_records`, `pine_agent`, `pine_manage` and `pine_recall`. These are local Pi tools, not public HTTP routes on this site. Read their installed schemas. These read-only starting calls let an agent discover the current setup:

```json
{"action":"help"}
```

Call the object above through `pine_manage`; use `{"action":"doctor"}` through that same tool for diagnostics. Use `pine_view` with `{"action":"list"}` to find reusable views, and `pine_agent` with `{"action":"list"}` to find existing agents. Read current hashes and revisions before editing saved work. A person chooses project trust and confirms an agent's access.

- [Agent instructions and when to use Pine](https://pine-pi.vercel.app/llms.txt)
- [Pine API and MCP server: release, checksums, install steps and docs search](https://pine-pi.vercel.app/docs/api.md)
- [Versioned Pine skill](https://raw.githubusercontent.com/johnlindquist/pine/v0.13.0/skills/pine/SKILL.md)
- [Architecture, tool operations and persistence](https://github.com/johnlindquist/pine/blob/v0.13.0/docs/architecture.md)

## Export a separate team agent

`/pine durable <agent>` writes a pi-durable application for a team to host. Read the portability report, run the generated checks and review its access settings. Hosting and model usage can have costs. This documentation site does not host that service, expose its endpoints or accept its credentials.

- [Team-agent export and hosting](https://github.com/johnlindquist/pine/blob/v0.13.0/docs/durable.md)
- [Pine 0.13.0 release notes](https://github.com/johnlindquist/pine/blob/v0.13.0/docs/release-0.13.0.md)

## Project and site

- [About Pine](https://pine-pi.vercel.app/about.html)
- [Privacy and local data](https://pine-pi.vercel.app/privacy.html)
- [Contact and issue reports](https://pine-pi.vercel.app/contact.html)
- [Site hosting guide](https://pine-pi.vercel.app/docs/hosting.html)
- [MIT license](https://github.com/johnlindquist/pine/blob/v0.13.0/LICENSE)