Skip to content
sudermanPublic

About

Personal assistant on Pi Durable

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Repository files navigation

June

June is a personal assistant: one persistent daemon on Pi Durable. You talk to her from a terminal client, a desktop client, an Android app, or Telegram. She reads Org for tasks and knowledge and herdr-core for live agent sessions. She does quick checks and small edits herself with a shell and file tools, and hands larger work to coding agents through an Org dispatcher.

Built on

  • Pi Durable: the harness June runs in. Her conversation, tasks, tools, and compaction are durable, so a restart resumes work rather than losing or repeating it. pi-ai talks to the models and pi-tui draws the terminal client.
  • Pi Coding Agent and Claude Code: the agents the dispatcher starts for AUTO tasks, selected by AGENT. June reads her providers from Pi’s models.json.
  • herdr-core: the runtime those agents run in, one terminal each. June reads their status through its CLI, hc; the Herdr app and phone app show them.
  • Org in Emacs: where tasks, projects, calendars, and June’s own files live. Task states and dates are set by Org itself, through Emacs in batch.
  • ripgrep: how June searches Org.

Getting started

June is packaged for Nix, with a Home Manager module for the daemon and clients. docs/development.org covers installing and deploying her.

june init [NAME]     # copy the starting files into place
june doctor          # configuration and dependency checks
june                 # terminal client attached to the conversation
june ask "What are my agents doing?"
june status --json   # daemon, model, and conversation state; no model call

June has one conversation, shared by every client. Detaching or losing the connection never stops her work.

Documentation

ReadFor
docs/usage.orgCommands, attachments, transcripts, Telegram, and graphical clients
docs/configuration.orgWhere her files live, and every config.json key
docs/behaviour.orgHeartbeats, memory, the journal, Org tasks, and her other routines
docs/development.orgChecks, repository layout, the two skill directories, and deployment
docs/architecture.orgDesign decisions and the client protocol
docs/interfaces.orgThe desktop client, the Android app, the avatar, and voice
org/README.orgThe Org dispatcher and org-edit

Development

nix develop           # node 22 and ripgrep
npm ci
npm run typecheck
npm test
nix flake check       # all of the above in the sandbox; GitHub Actions runs it on every push

More is in docs/development.org.

About

Personal assistant on Pi Durable

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages