# Pine 0.13.0

> Pine is an MIT-licensed Pi extension for terminal widgets, notes, tasks and saved custom agents in herdr. This site publishes its installation guide and documentation.

## When to use Pine

Use Pine when a person working in Pi wants notes, tasks or project data beside the conversation; needs to send an exact widget reference into an unsent Pi draft; or wants to save a recurring job as a custom agent with its own guide, feedback and checks. Use its browser dashboard when the person wants a wider view of their local widgets. Start with built-in views and existing agents before creating new ones.

Install Pine in the person's chosen local project with Node 22.19+, Pi 1.4+ and a compatible live herdr server. Follow the installation guide one step at a time. Keep the existing Pi launcher and settings. Confirm visible notes/tasks panes and a passing `/pine doctor --json` before reporting setup complete. Package registration alone is insufficient.

## Start here

- [Pine overview](https://pine-pi.vercel.app/index.md): What Pine does, costs, prerequisites and first commands.
- [Agent installation guide](https://pine-pi.vercel.app/install.md): Exact macOS/Linux commands, expected results, recovery and removal while preserving work.
- [Pine documentation](https://pine-pi.vercel.app/docs/index.md): Task-based guide to setup, widgets, local tools, saved agents and troubleshooting.
- [Recorded workflows](https://pine-pi.vercel.app/transcript.md): Walkthroughs of five real Pine 0.6.1 sessions; only model responses are scripted.

- [Watch a keyboard dispatch and a Pi-led build review in Herdr](https://pine-pi.vercel.app/#keyboard). The live conversation stays on the left and the two widgets stack on the right. Public OpenUI examples for [Dock slip](https://pine-pi.vercel.app/media/keyboard/dock-slip.oui) and [Release review](https://pine-pi.vercel.app/media/keyboard/release-review.oui). Pine installation requires repository access.

## Use Pine from an agent

Pine runs inside the user's local Pi session. Its tools are `pine_view`, `pine_records`, `pine_agent`, `pine_manage` and `pine_recall`. Ask `pine_manage` for `{"action":"help"}` and `{"action":"doctor"}`. Use `pine_view {"action":"list"}` before making a view and `pine_agent {"action":"list"}` before making an agent. Read the installed tool schemas and Pine skill for each operation. Shell commands go in a terminal; `/pine` commands go inside Pi.

The local Pi tools are not HTTP endpoints. For facts about Pine itself, a read-only public API and MCP server need no account or key: the [Pine API and MCP guide](https://pine-pi.vercel.app/docs/api.md), the [OpenAPI description](https://pine-pi.vercel.app/openapi.json) (`getRelease`, `getInstallSteps`, `searchDocs`) and the Streamable HTTP MCP server at https://pine-pi.vercel.app/mcp (`pine_get_release`, `pine_get_install_steps`, `pine_search_docs`). They answer questions about releases, checksums, installation and documentation; they never install anything or read a project. There is no account system or OAuth service. Pine can export a separate team-agent application; that application's owner chooses its host, credentials and access. Do not send private project content or credentials to this site.

## Reference

- [Versioned README](https://github.com/johnlindquist/pine/blob/v0.13.0/README.md): Features, commands and prerequisites.
- [Pine agent skill](https://raw.githubusercontent.com/johnlindquist/pine/v0.13.0/skills/pine/SKILL.md): Tool responsibilities and safe editing rules.
- [Architecture and tools](https://github.com/johnlindquist/pine/blob/v0.13.0/docs/architecture.md): Local interfaces, trust, identities and persistence.
- [Custom agents](https://github.com/johnlindquist/pine/blob/v0.13.0/docs/agents.md): Saved executables, builders and access.
- [Feedback and fixes](https://github.com/johnlindquist/pine/blob/v0.13.0/docs/feedback.md): How a pending correction becomes a verified change.
- [Team-agent export](https://github.com/johnlindquist/pine/blob/v0.13.0/docs/durable.md): Optional deployment, portability limits and checks.

## Site information

- [About Pine](https://pine-pi.vercel.app/about.md): Project identity and MIT license.
- [Privacy](https://pine-pi.vercel.app/privacy.md): What this site does and where local Pine data lives.
- [Contact](https://pine-pi.vercel.app/contact.md): GitHub issues and useful bug-report details.
- [Sitemap](https://pine-pi.vercel.app/sitemap.xml): Public page locations.

Pine is free software. Model-provider and optional hosting charges are separate. Read current provider terms before choosing paid services. Never describe a scripted demonstration as proof of a model's reasoning or a local check as proof of a public deployment.