Skip to content

Using Pofyland

konuksev edited this page Nov 16, 2026 · 1 revision

Using Pofyland

Reading the sea

Where the Pofy is What it means
Swimming working
At the glass, looking at you waiting for a permission, an answer or a plan approval
On the bottom idle or finished
  • The bubble shows the last request and what it is doing: "Thinking · 10 s", "Writing", "Bash permission · 1 min". Hover and the card grows.
  • Islands: every project is an island on the sea floor. Its coral grows with the project's commits; recently active projects come forward.
  • Red bond: when two sessions edit the same file, the line between them turns red with the file name ("⚠ game.ts"), so you can stop a conflict early.
  • Top bar: how many sessions are waiting for you, what finished today, how many problems, and how much of your Claude / Codex limits is used.

Answering a waiting Pofy

  • Permission requests, questions and plan approvals are answered right on the card. No need to go back to the terminal. You can type a message too.
  • Several waiting? The cards queue up; ‹ › moves between them.
  • Let Pofy decide hands the question to Claude, which knows the context, and it tells you why it chose what it chose.
  • From the card you can also switch the model or the mode (plan, auto), or stop the session.

Notifications and the day

  • macOS notifications when a Pofy starts waiting and when a long job ends (with duration and result). Click to jump to the session.
  • The Today card: finished jobs, durations, commits, problems. One look in the evening tells you what got done.

Helpers (optional, they always ask first)

Pofyland notices patterns and offers to act. You approve once with always and it does that on its own afterwards; you can switch any learned rule off in its list.

  • "Commit when the job is done?"
  • "Your limit is nearly used up, hand this to Codex?"
  • "Forward the new comments on your open PR to the Pofy?"
  • Proof: when a Pofy edits a page and says "done" while the project's preview server is up, a phone-size and a desktop-size screenshot are taken, so you judge the picture, not the claim.
  • Ulak: connect Gmail and each new mail arrives as a courier that summarizes it and drafts a reply. Sending stays your decision.

Codex and Antigravity

Their bridges ship with the app. When those tools are installed and running, their sessions come into the sea as Pofys too. New sessions can be started from the app; it looks for codex and agy in your own Terminal PATH (nvm, volta, bun and pnpm installs are found). Pofyland doesn't install these tools, it only runs them.

Clone this wiki locally