Pine 0.13.0 · Documentation

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 provides complete commands and expected results; its Markdown version 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.

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.

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.

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:

{"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.

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.