an open-source alternative to the dots, bots and muses of the world, run an office of claude code/codex like agents on your laptop, sandboxes or anywhere, uses your existing subscriptions
HTML agent-harnessagent-orchestrationagentsai-agentsautonomous-agentsclaude-codecodexcoding-agentsdesktop-appdeveloper-toolselectrongemini-cliharnessharness-engineeringlocal-firstmemorymulti-agentopencodeorchestrationtypescript
/**
* The inbox-wake nudge — the text queued for an agent that has unread hive mail,
* and the predicate the message queue uses to keep only one of them pending.
*
* The nudge is QUEUED the moment fresh mail is seen but TYPED only once the agent
* is idle and off cooldown, and it survives a renderer reload in the persisted
* queue. By the time it lands, the agent has often already drained that mail and
* filed it under `inbox/.done/` — so the nudge arrives against an inbox the agent
* itself just emptied.
*/
/** The fixed head of every nudge; the ids that follow differ per nudge. */
const NUDGE_HEAD = 'You have new hive inbox message(s)';
/**
* Build the nudge, naming the messages that prompted it.
*
* The ids are diagnostic, NOT a work list: they let an agent tell "I already
* handled this last turn" (the id sits in `inbox/.done/`) from "the harness woke
* me for nothing", which is the distinction it otherwise cannot make and burns a
* round-trip guessing at. The pending inbox stays authoritative — an agent that
* has a nudge suppressed by the one-pending rule below still finds its mail by
* reading the directory, so the text must never invite it to stop at the ids.
*/
export function inboxNudgeText(ids: string[]): string {
const named = ids.length ? ` — at least: ${ids.join(', ')}` : '';
return `${NUDGE_HEAD}${named}. Read your inbox, act on what is pending there, and move handled ones to inbox/.done/. Your inbox directory is authoritative: work everything still pending in it, and if a named id is already in inbox/.done/ you handled it on an earlier turn and can ignore that one. Act autonomously; only message god if you genuinely need a decision.`;
}
/**
* Is this queued text an inbox-wake nudge?
*
* Matches the fixed head only, since every nudge carries different ids — the
* point is to recognise the COMMAND, not one instance of it. Mirrors
* `isCompactionCommand`, and the queue's one-pending rule leans on it the same way.
*/
export function isInboxNudge(text: string): boolean {
return text.trim().startsWith(NUDGE_HEAD);
}