A desktop home for your Pi Pocket agents.
Pocket is a desktop app for people who run a team of agents on a Pi Pocket server, that puts everything waiting on you, and everything in motion, in one window. Where Pi Pocket's web app shows one session at a time, Pocket is organized around your attention, with pi-pocket-team's Desk built in.
Status: pre-release. It signs in to a server, streams sessions, and runs the Inbox, In motion, the team, the wiki and artifacts.
Documentation: docs/README.md
- Inbox. Calls to allow, Pi's questions, the Desk's decisions and PRs ready to merge, in one queue, with decisions grouped by thread in filing order, each answered on its card, keyboard first. Derived queues and thread matches are reused between data changes. The Details pane keeps its heading below the window controls. Desk report links open in a native reader. Review pending lessons from both named agents and Pi Pocket memory. Design
- Approve + merge. A ready PR on the Inbox approves and merges in 2 clicks, or up to 25 in a batch, as the owner
bketelsenthrough the GitHub App "Pocket for bketelsen": Settings > GitHub > Sign in with GitHub shows a device code to enter at github.com/login/device, and the sign-in stays in the desktop keyring only (no client secret, no personal access token);risk:highPRs go 1 at a time, after the diff. On a base where the owner can bypass a ruleset, Pocket checks each of its rules itself and refuses a rule it does not model. Design, ADR-0008, ADR-0010, ADR-0011 - In motion. Every thread at work, grouped by who moves it next, with what each agent does right now. Park, wake, watch, attach or drop a thread in its detail pane; due checks wait in the Inbox. Fresh activity, queued issues, other PRs and completed plans stay visible. Read plans natively, mark decision criteria, approve or request changes; comment, stop consults, revise scope or create a plan. Running now lists live tasks and schedules across sessions, with Stop controls. Design
- Sessions, native. Choose the server working directory before creating a session. Review native diffs, browse files, save a copy or confirm a file revert. A pill by the composer counts the session's background commands and opens their output and Stop; create or cancel scheduled messages, and edit or pause them on supporting servers. Attach files by picker, drop or image/file paste, with cancellable uploads for slower links; queued messages show above the composer, where they can be edited or withdrawn, and held messages resumed. A session's subagents show in a bar above the composer, each 1 click from its own session, and a subagent's session has a way back to its parent. Replies stream in as Markdown, tool calls fold away, approvals dock above the composer,
@agentstarts a task, and a read-only browser watch shows the agent's page. Find searches loaded messages and folded tools; the session menu can fork, export Markdown or start a new context. The inspector chooses or clears the session's team identity and shows its shift goal and progress. Design - The team. Lessons to approve, a page for each named agent, the shift board with supervisor choice, row details and controls, and the Desk's numbers with range and repository/owner filters and record drill-down. Daily closures show a count scale and each day's value on hover or keyboard focus. Design
- Wiki and artifacts. The homelab wiki and every session's pages, documents and pictures, read in the app. On systems without a web view, pages open in your browser using its own sign-in. Choose the latest or an older artifact version. The artifact list refreshes while open; reconnecting refreshes the team and its lessons. Design
- Terminal. Server shells retain their screen on attachment without replaying historical query replies into the live shell. Design
- Arrakis. The whole team as one animated desert scene on a single screen: an eclipse that counts what waits on you, a figure for each agent with a spice harvester while it works and a thumper while it calls. Carryalls bring and lift the harvesters as runs begin and end, the worm takes one when a run fails, ornithopters carry tasks and calls, and a storm stands while failures are unread. Click a figure for its sessions; double-click to go where it presses most; turn on Vision to watch a made-up order at work. An unofficial Dune fan work, drawn natively. Design
- Calm notifications. By kind, bursts gathered into one, do not disturb and quiet hours, without changing what your phone gets. Design
- Zoom. Everything in the window larger or smaller, 50% to 300%, from Settings or ⌘+, ⌘- and ⌘0 (Ctrl on Linux and Windows). Design
Go 1.27, and a Pi Pocket server you can reach, with its owner's sign-in link or an invite. On Linux, GTK 3, libepoxy and Pango; MyGo needs no CGO.
Pocket has no release yet: build it from source. On a Mac, build it on the Mac that runs it (the build signs it ad hoc), then open it:
git clone https://github.com/frostyard/pocket.git
cd pocket
make app
open build/mygo/darwin-*/Pocket.appOn Linux, make run builds and starts it, and make install installs it for you alone, with a launcher and its icon in the applications menu:
make install # the app in ~/.local/lib/pocket, the command ~/.local/bin/pocket
make uninstall # removes what make install wrotePREFIX (default ~/.local) moves the app and its command; the desktop entry and the icons go in $XDG_DATA_HOME (default ~/.local/share).
Paste the sign-in link your Pi Pocket launcher printed (https://example.org/login?token=…) or an invite link; Pocket masks the pasted link and keeps the token in the desktop's keyring. Public HTTP servers require confirmation because the token travels in clear text.
mise install # the pinned tools
make ci # what CI runs
make run # build and start the appThe live tests and the demo server are in docs/design/pocket.md.
- AGENTS.md: the rules for agents and contributors.
- docs/README.md: the decisions, designs, specs and plans.
- SECURITY.md: report a vulnerability privately.
- LICENSE: MIT.