Directories
¶
| Path | Synopsis |
|---|---|
|
Package alerts reads the alerts of the installations the sessions work on and turns two readings into NEW and RESOLVED lines.
|
Package alerts reads the alerts of the installations the sessions work on and turns two readings into NEW and RESOLVED lines. |
|
Package board picks the next item of work from a GitHub project board: it reads the board's open items once, ranks them by the configured order and says for every item above the pick why it was skipped.
|
Package board picks the next item of work from a GitHub project board: it reads the board's open items once, ranks them by the configured order and says for every item above the pick why it was skipped. |
|
Package brieflint finds what makes a skill or a brief go stale: dates, waits on something to ship, notes on a release that fixed something, and a role's run where the role's name belongs.
|
Package brieflint finds what makes a skill or a brief go stale: dates, waits on something to ship, notes on a release that fixed something, and a role's run where the role's name belongs. |
|
Package central is the local beekeeper's client of the central instance: beekeeper serve behind muster, called as the person through muster's call_tool.
|
Package central is the local beekeeper's client of the central instance: beekeeper serve behind muster, called as the person through muster's call_tool. |
|
centraltest
Package centraltest gives a test a muster in front of a beekeeper serve: its call_tool forwards x_<server>_<tool> to the backend with the caller's bearer and wraps the result as muster does, and a muster binary that names its endpoint and prints a token.
|
Package centraltest gives a test a muster in front of a beekeeper serve: its call_tool forwards x_<server>_<tool> to the backend with the caller's bearer and wraps the result as muster does, and a muster binary that names its endpoint and prints a token. |
|
Package claude finds the Claude Code sessions running on the machine and what they are doing, from what is on disk: the CLI processes (their environment names the desktop session), the record each CLI keeps of the session it runs, the desktop app's session records (title, branch), the transcripts (last activity, last words) and the git checkout each works in.
|
Package claude finds the Claude Code sessions running on the machine and what they are doing, from what is on disk: the CLI processes (their environment names the desktop session), the record each CLI keeps of the session it runs, the desktop app's session records (title, branch), the transcripts (last activity, last words) and the git checkout each works in. |
|
Package config loads beekeeper's machine configuration: where its state lives, which shared resources sessions lease, the GitHub budget floor, the thresholds of the machine watch and which installations' alerts it reads.
|
Package config loads beekeeper's machine configuration: where its state lives, which shared resources sessions lease, the GitHub budget floor, the thresholds of the machine watch and which installations' alerts it reads. |
|
Package feed is the shape of beekeeper://feed: the events of the shared state, each with an id, in a versioned schema the agent views share.
|
Package feed is the shape of beekeeper://feed: the events of the shared state, each with an id, in a versioned schema the agent views share. |
|
Package feedback reads the person's replies to the scheduled status reports in Slack: where a report was posted (its slack_send_message result), the replies in its thread (the Slack MCP server's slack_read_thread text) and whom a reply is for.
|
Package feedback reads the person's replies to the scheduled status reports in Slack: where a report was posted (its slack_send_message result), the replies in its thread (the Slack MCP server's slack_read_thread text) and whom a reply is for. |
|
Package free finds what the machine can give back without touching running work and frees it on request: dead sessions' scratch in the tmpfs /tmp, throwaway temp dirs and orphaned workers.
|
Package free finds what the machine can give back without touching running work and frees it on request: dead sessions' scratch in the tmpfs /tmp, throwaway temp dirs and orphaned workers. |
|
Package github reads the person's GitHub REST budget: the hourly core limit every session, every devctl wait and the person's own developer portal login draw from.
|
Package github reads the person's GitHub REST budget: the hourly core limit every session, every devctl wait and the person's own developer portal login draw from. |
|
Package guard keeps builds from taking the machine down.
|
Package guard keeps builds from taking the machine down. |
|
Package identity is who calls `beekeeper serve`: a person, from the Dex ID token muster forwards (or an installation exchanged), validated against the issuer's JWKS.
|
Package identity is who calls `beekeeper serve`: a person, from the Dex ID token muster forwards (or an installation exchanged), validated against the issuer's JWKS. |
|
identitytest
Package identitytest is a Dex stand-in for tests: an OIDC issuer that serves its discovery document and keys and signs ID tokens.
|
Package identitytest is a Dex stand-in for tests: an OIDC issuer that serves its discovery document and keys and signs ID tokens. |
|
Package install puts beekeeper in place on a machine and takes it away again: the Claude Code hooks, the platform's standby service and memory guard, and a starter config.
|
Package install puts beekeeper in place on a machine and takes it away again: the Claude Code hooks, the platform's standby service and memory guard, and a starter config. |
|
Package lease holds the machine's shared resources, one holder at a time: kind labs, shared installations, the browser.
|
Package lease holds the machine's shared resources, one holder at a time: kind labs, shared installations, the browser. |
|
Package machine reads the numbers that decide whether the workstation survives the next hour: RAM and swap, memory pressure, the Claude Desktop cgroup, tmpfs and disk, build slots, kind clusters and the kernel's OOM kills.
|
Package machine reads the numbers that decide whether the workstation survives the next hour: RAM and swap, memory pressure, the Claude Desktop cgroup, tmpfs and disk, build slots, kind clusters and the kernel's OOM kills. |
|
Package mailbox is the central instance's message queue: a mailbox per person for the local agents that person federates, in the beekeeper database of the platform's Postgres.
|
Package mailbox is the central instance's message queue: a mailbox per person for the local agents that person federates, in the beekeeper database of the platform's Postgres. |
|
mailboxtest
Package mailboxtest gives a test a database of its own on the Postgres BEEKEEPER_TEST_DATABASE_URL names (docs/development.md starts one).
|
Package mailboxtest gives a test a database of its own on the Postgres BEEKEEPER_TEST_DATABASE_URL names (docs/development.md starts one). |
|
Package merge is the gate's logic on devctl pr merge: which lane a merge queues in, what holds it, whose turn it is, and when a lane's installation has rolled the previous merge.
|
Package merge is the gate's logic on devctl pr merge: which lane a merge queues in, what holds it, whose turn it is, and when a lane's installation has rolled the previous merge. |
|
Package notify sends the watch's events that need a person to the desktop notification service, once per event however many watches share the state directory: each event is claimed in notify.json under notify.lock, and only the watch whose claim is first sends it.
|
Package notify sends the watch's events that need a person to the desktop notification service, once per event however many watches share the state directory: each event is claimed in notify.json under notify.lock, and only the watch whose claim is first sends it. |
|
Package omp finds the omp (oh-my-pi) agents running on the machine and what they are doing, from what is on disk: the omp processes (their working directory, and for an agent beekeeper started its environment) and the session files omp writes under ~/.omp/agent/sessions, one JSON line per entry: a title line (rewritten in place), the session header (id, cwd), model changes, and messages of the roles user, assistant and toolResult.
|
Package omp finds the omp (oh-my-pi) agents running on the machine and what they are doing, from what is on disk: the omp processes (their working directory, and for an agent beekeeper started its environment) and the session files omp writes under ~/.omp/agent/sessions, one JSON line per entry: a title line (rewritten in place), the session header (id, cwd), model changes, and messages of the roles user, assistant and toolResult. |
|
Package peer sends a message to a running Claude session from the command line.
|
Package peer sends a message to a running Claude session from the command line. |
|
Package platform is the one place beekeeper reaches into the machine it runs on: memory, pressure, processes and OOM kills (Machine), detached units of work (Launcher), memory-capped runs (Capper), claude:// links (Opener), the person's input (Input), desktop notifications (Notifier), and the standby service and memory guard beekeeper install puts in place (Setup).
|
Package platform is the one place beekeeper reaches into the machine it runs on: memory, pressure, processes and OOM kills (Machine), detached units of work (Launcher), memory-capped runs (Capper), claude:// links (Opener), the person's input (Input), desktop notifications (Notifier), and the standby service and memory guard beekeeper install puts in place (Setup). |
|
Package post checks a report before it is posted with the Slack connector, whose message is standard Markdown it converts for Slack: that every pull request or issue it mentions is a link to that pull request or issue in its own repository, and that its times are the person's.
|
Package post checks a report before it is posted with the Slack connector, whose message is standard Markdown it converts for Slack: that every pull request or issue it mentions is a link to that pull request or issue in its own repository, and that its times are the person's. |
|
Package proc reads the Linux process table from /proc once and answers the questions beekeeper asks of it: who is whose parent, which session a process belongs to, how long it has run.
|
Package proc reads the Linux process table from /proc once and answers the questions beekeeper asks of it: who is whose parent, which session a process belongs to, how long it has run. |
|
Package sandbox is the agent sandbox: the policy beekeeper renders into Claude Code's managed settings, which Anthropic's sandbox runtime enforces on every command of every session on the machine, and the allow lists beekeeper's PreToolUse hook holds the harness's own file tools to.
|
Package sandbox is the agent sandbox: the policy beekeeper renders into Claude Code's managed settings, which Anthropic's sandbox runtime enforces on every command of every session on the machine, and the allow lists beekeeper's PreToolUse hook holds the harness's own file tools to. |
|
Package secret is beekeeper secret: the credential operations beekeeper runs in its own process so that no agent reads a value.
|
Package secret is beekeeper secret: the credential operations beekeeper runs in its own process so that no agent reads a value. |
|
secrettest
Package secrettest is a fake sops and op for the tests of beekeeper secret: its "encryption" is base64 behind a header, so a test sees a plaintext value on disk as one, and its vault is a map.
|
Package secrettest is a fake sops and op for the tests of beekeeper secret: its "encryption" is base64 behind a header, so a test sees a plaintext value on disk as one, and its vault is a map. |
|
Package state is beekeeper's shared memory on the machine: the supervisor and its relay, grants, holds, registered agents, notes, timers and session records, one JSON document read and rewritten under an exclusive file lock, plus an append-only event log of every change and of every build run.
|
Package state is beekeeper's shared memory on the machine: the supervisor and its relay, grants, holds, registered agents, notes, timers and session records, one JSON document read and rewritten under an exclusive file lock, plus an append-only event log of every change and of every build run. |
|
kube
Package kube is the Kubernetes store of `beekeeper serve`: the shared state of the Giant Swarm installations as custom resources of beekeeper.giantswarm.io instead of one document under a file lock.
|
Package kube is the Kubernetes store of `beekeeper serve`: the shared state of the Giant Swarm installations as custom resources of beekeeper.giantswarm.io instead of one document under a file lock. |
|
Package takeover hands a Claude Code session's permission requests to the person's screen while the screen has taken the session over, and back to the session's own window when it has not.
|
Package takeover hands a Claude Code session's permission requests to the person's screen while the screen has taken the session over, and back to the session's own window when it has not. |
|
Package teleport keeps the desk's Teleport login: it reads the active profile's expiry from tsh and renews the login in a staging home, which replaces the profile directory in one exchange once the new login has succeeded.
|
Package teleport keeps the desk's Teleport login: it reads the active profile's expiry from tsh and renews the login in a staging home, which replaces the profile directory in one exchange once the new login has succeeded. |
|
Package tui is beekeeper's screen for the person: one window over the live state of the machine beekeeper keeps — the sessions and what each is on, the machine's memory and build slots, the leases, holds and merge lanes, the supervisor and guide, the agents, notes and timers, the GitHub budget, the installations' alerts and the event log.
|
Package tui is beekeeper's screen for the person: one window over the live state of the machine beekeeper keeps — the sessions and what each is on, the machine's memory and build slots, the leases, holds and merge lanes, the supervisor and guide, the agents, notes and timers, the GitHub budget, the installations' alerts and the event log. |
|
Package update replaces the running beekeeper with the latest signed release.
|
Package update replaces the running beekeeper with the latest signed release. |
|
Package upgrade detects the release upgrades running on an installation's Cluster API clusters and keeps the automatic holds that stop the installation's merges and lease claims while they run.
|
Package upgrade detects the release upgrades running on an installation's Cluster API clusters and keeps the automatic holds that stop the installation's merges and lease claims while they run. |
Click to show internal directories.
Click to hide internal directories.