Skip to content
Frostyard docs

Porter

Porter is a personal assistant that runs inside lodge. You talk to it in a chat panel beside whatever app you are in. You need it if you run lodge and want an assistant that works across your apps.

  • It reads your mail, calendar, tasks, and notes through their MCP endpoints.
  • It drafts, and never sends. You send.
  • It keeps its memory and its scheduled prompts (routines) as notes in your vault.
  • It thinks through lodge’s inference layer.
  • It reads frostread read-only, and it keeps one continuous thread.

Porter has no desktop app, and none is planned. No Porter Flatpak ships. Porter works only behind lodge: you need lodge, Tailscale, and the other apps on lodge.

Status

Section titled “Status”

Porter is pre-release. The latest release is v0.1.0. Each release attaches one package, frostyard-porterd_X.Y.Z_amd64.deb, for lodge’s host. On a Frostyard image, the porterd system extension installs it. Chat, routines, and reading from frostread are built and run on lodge’s host, as lodge’s porter app. The GitHub manager, the next planned phase, is not built.

Install

Section titled “Install”

Porter runs as lodge’s porter app, on lodge’s host. You need lodge, an inference alias that lodge routes to a model, and the apps Porter reads. The web bundle builds in an nsl machine, and make lodge-package stages the app, with porterd in usr/bin. lodge’s own host keeps porterd in /opt/lodge/bin, so do not extract the staged tree onto / there. The operational notes cover the configuration, the tokens, and the agent socket. Step 5 of lodge’s packaging README covers agents on lodge’s host.

Update and roll back

Section titled “Update and roll back”

On a Frostyard image, Updex updates and rolls back the porterd system extension. Update, roll back, and remove has the steps, with the backup to take first. The release .deb is built for that extension, and it is not in the Frostyard APT repository. To check a download, run gh attestation verify frostyard-porterd_X.Y.Z_amd64.deb --repo frostyard/porter.

On lodge’s own host, which is installed by hand, follow Update and Roll back in the README. The Update steps take a rollback archive before the new build goes in.

Documentation

Section titled “Documentation”
  • README: what Porter is and what is built.
  • Design overview: how Porter works and what it reaches.
  • Operational notes: configuration, tokens, dependencies, and logs.
  • Limits: what Porter does not do, and what can go wrong.
  • Routines: how to write a routine.
  • ADR-0004: Porter drafts and the owner sends.
  • ADR-0005: memory and routines live in the vault.
  • ADR-0006: one continuous thread.
  • ADR-0007: Porter reads frostread read-only.
  • Roadmap: what is built and what comes next.

See also

Section titled “See also”

Sources

Section titled “Sources”

Reviewed 2026-10-28.