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.
- 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’smodels.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.
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 callJune has one conversation, shared by every client. Detaching or losing the connection never stops her work.
| Read | For |
|---|---|
| docs/usage.org | Commands, attachments, transcripts, Telegram, and graphical clients |
| docs/configuration.org | Where her files live, and every config.json key |
| docs/behaviour.org | Heartbeats, memory, the journal, Org tasks, and her other routines |
| docs/development.org | Checks, repository layout, the two skill directories, and deployment |
| docs/architecture.org | Design decisions and the client protocol |
| docs/interfaces.org | The desktop client, the Android app, the avatar, and voice |
| org/README.org | The Org dispatcher and org-edit |
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 pushMore is in docs/development.org.