The cross-harness, self-improving memory layer for AI agents. Join our community: https://discord.com/invite/zdNChS2fBu
Go agent-ai-cliagent-harnessesagent-securitybrowser-extensionciclaude-codecloudcodexcursordetection-engineeringjevknowledge-basememorymobile-device-managementobservabilitysecuritysecurity-information-and-event-managementsecurity-toolstelemetrytraces
Merge main into this branch
Claudef34d25596ea6
diff --cc cli/beacon/internal/handoff/resume_test.goindex 4596f2bf,f5afcc5b..067b436c--- a/cli/beacon/internal/handoff/resume_test.go+++ b/cli/beacon/internal/handoff/resume_test.go@@@ -24,7 -24,8 +24,7 @@@ func installed(names ...string) func(st}}- var allRuntimes = installed("claude", "codex", "opencode", "cline", "pi", "prime-agent", "grok")-var allRuntimes = installed("claude", "codex", "opencode", "cline", "pi", "prime-agent",- "omp", "gemini", "qwen", "kiro-cli", "agy", "devin", "muse", "openhands", "goose")++var allRuntimes = installed("claude", "codex", "opencode", "cline", "pi", "prime-agent", "omp", "gemini", "qwen", "kiro-cli", "agy", "devin", "muse", "openhands", "goose", "grok")// resumableSession is a session whose directory and session file both exist.func resumableSession(t *testing.T, harness, id string) Session {@@@ -80,7 -81,15 +80,16 @@@ func TestPlanResumeStartsANewSessionInE{HarnessCline, "cline", []string{"--tui", "--auto-approve", "false"}},{HarnessPi, "pi", []string{"--"}},{HarnessPrime, "prime-agent", []string{"--"}},+ {HarnessGrok, "grok", []string{"--permission-mode", "default"}},+ {HarnessOhMyPi, "omp", []string{"--approval-mode=always-ask"}},+ {HarnessGemini, "gemini", []string{"--approval-mode", "default", "--prompt-interactive"}},+ {HarnessQwen, "qwen", []string{"--approval-mode", "default", "--prompt-interactive"}},+ {HarnessKiro, "kiro-cli", []string{"chat"}},+ {HarnessAntigravity, "agy", []string{"--prompt-interactive"}},+ {HarnessDevin, "devin", []string{"--permission-mode", "auto", "--"}},+ {HarnessMuse, "muse", []string{"--approval-mode", "on-request"}},+ {HarnessOpenHands, "openhands", []string{"--task"}},+ {HarnessGoose, "goose", []string{"run", "--interactive", "--text"}},} {t.Run(tc.target, func(t *testing.T) {source := HarnessCodexdiff --cc cli/beacon/internal/handoff/runtimes.goindex cf355172,c23c418d..6d0146fc--- a/cli/beacon/internal/handoff/runtimes.go+++ b/cli/beacon/internal/handoff/runtimes.go@@@ -57,7 -53,17 +57,18 @@@ constHarnessCline = clinesession.HarnessHarnessPi = pisession.HarnessHarnessPrime = primesession.Harness+ HarnessGrok = groksession.Harness++ // Runtimes Beacon starts but whose sessions it reads only from the runtime log.+ HarnessOhMyPi = "omp"+ HarnessGemini = "gemini_cli"+ HarnessQwen = "qwen_code"+ HarnessKiro = "kiro"+ HarnessAntigravity = "antigravity_cli"+ HarnessDevin = "devin-cli"+ HarnessMuse = "muse_code"+ HarnessOpenHands = "openhands"+ HarnessGoose = "goose")// runtimes lists every runtime handoff supports, in display order.@@@ -154,29 -160,103 +165,126 @@@ var runtimes = []RuntimeNewSession: func(prompt string) []string { return []string{"--", prompt} },},},+ {+ Harness: HarnessGrok,+ Label: "Grok Build",+ Aliases: []string{"grok-build"},+ NewSource: func(dir string) Source { return &grokSource{dir: dir} },+ // Grok's configured permission mode can be always-approve. A session Beacon starts or+ // reopens runs in the mode that asks, whatever the config says; the user can still change+ // the mode inside the TUI.+ Command: &runtimeCommand{+ Executable: "grok",+ Resume: func(s Session) ([]string, bool) {+ // A subagent is a child of the session that spawned it, not one a person reopens.+ if s.Subagent {+ return nil, false+ }+ // Grok looks a session up under the directory it runs in, which is the session's own.+ return []string{"--permission-mode", "default", "--resume", s.ID}, true+ },+ NewSession: func(prompt string) []string { return []string{"--permission-mode", "default", prompt} },+ // Grok looks a session id up under the directory it is started in.+ ResumesInSessionDir: true,+ },+ },++ // The runtimes below keep no session store Beacon reads. Their sessions come from Beacon's+ // runtime log, so they always continue from a brief; each can also be the runtime another+ // session continues in. Where a CLI lets its approval mode be set, the command pins the mode+ // that asks, so a user or project setting that approves everything does not carry over to a+ // session Beacon starts.+ {+ Harness: HarnessOhMyPi,+ Label: "Oh My Pi",+ Aliases: []string{"oh-my-pi"},+ // Oh My Pi approves every tool call by default (tools.approvalMode "yolo").+ Command: &runtimeCommand{+ Executable: "omp",+ NewSession: func(prompt string) []string { return []string{"--approval-mode=always-ask", prompt} },+ },+ },+ {+ Harness: HarnessGemini,+ Label: "Gemini CLI",+ Aliases: []string{"gemini", "gemini-cli"},+ Command: &runtimeCommand{+ Executable: "gemini",+ NewSession: func(prompt string) []string {+ return []string{"--approval-mode", "default", "--prompt-interactive", prompt}+ },+ },+ },+ {+ Harness: HarnessQwen,+ Label: "Qwen Code",+ Aliases: []string{"qwen", "qwen-code"},+ // A positional prompt is one-shot in Qwen Code; --prompt-interactive keeps the session open.+ Command: &runtimeCommand{+ Executable: "qwen",+ NewSession: func(prompt string) []string {+ return []string{"--approval-mode", "default", "--prompt-interactive", prompt}+ },+ },+ },+ {+ Harness: HarnessKiro,+ Label: "Kiro",+ Aliases: []string{"kiro-cli"},+ Command: &runtimeCommand{+ Executable: "kiro-cli",+ NewSession: func(prompt string) []string { return []string{"chat", prompt} },+ },+ },+ {+ Harness: HarnessAntigravity,+ Label: "Antigravity CLI",+ Aliases: []string{"antigravity", "agy"},+ Command: &runtimeCommand{+ Executable: "agy",+ NewSession: func(prompt string) []string { return []string{"--prompt-interactive", prompt} },+ },+ },+ {+ Harness: HarnessDevin,+ Label: "Devin CLI",+ // Beacon's Devin CLI hooks record "devin-cli"; hooks written by older versions recorded+ // "devin", which reaches this entry through its alias.+ Aliases: []string{"devin"},+ // DEVIN_PERMISSION_MODE can hold "dangerous", which approves every tool; the flag wins over+ // it. Devin reads a bare argument as a path to open, so the prompt follows --.+ Command: &runtimeCommand{+ Executable: "devin",+ NewSession: func(prompt string) []string { return []string{"--permission-mode", "auto", "--", prompt} },+ },+ },+ {+ Harness: HarnessMuse,+ Label: "Muse Code",+ Aliases: []string{"muse", "muse-code"},+ Command: &runtimeCommand{+ Executable: "muse",+ NewSession: func(prompt string) []string { return []string{"--approval-mode", "on-request", prompt} },+ },+ },+ {+ Harness: HarnessOpenHands,+ Label: "OpenHands",+ Command: &runtimeCommand{+ Executable: "openhands",+ NewSession: func(prompt string) []string { return []string{"--task", prompt} },+ },+ },+ {+ Harness: HarnessGoose,+ Label: "goose",+ // goose approves every tool call by default and has no flag for its mode, only GOOSE_MODE.+ Command: &runtimeCommand{+ Executable: "goose",+ NewSession: func(prompt string) []string { return []string{"run", "--interactive", "--text", prompt} },+ Env: map[string]string{"GOOSE_MODE": "approve"},+ },+ },}// Harnesses lists the runtimes handoff supports, in display order.diff --cc docs/cli/handoff.mdxindex 6df21834,26095a20..0ef7aa42--- a/docs/cli/handoff.mdx+++ b/docs/cli/handoff.mdx@@@ -25,12 -25,29 +25,30 @@@ Sessions come from each runtime's own l| Cline | `~/.cline/data` | `cline` || Pi | `~/.pi/agent/sessions` (or under `PI_CODING_AGENT_DIR`) | `pi` || Prime Agent | `~/.prime/agent`, both `sessions` and `session-artifacts` (or `PRIME_AGENT_CODING_AGENT_DIR`) | `prime` |+| Grok Build | `~/.grok/sessions` | `grok` |-When a Codex thread has more than one rollout file, `beacon handoff` lists it once, under its newest file. Cline can hold the same task both as a CLI session and in its older task history; the CLI session is the copy that is listed. Cline kanban cards are not sessions and are not listed. Prime Agent subagent transcripts, under `session-artifacts`, are listed as subagents of the session that started them.+When a Codex thread has more than one rollout file, `beacon handoff` lists it once, under its newest file. Cline can hold the same task both as a CLI session and in its older task history; the CLI session is the copy that is listed. Cline kanban cards are not sessions and are not listed. Prime Agent subagent transcripts, under `session-artifacts`, are listed as subagents of the session that started them. Grok Build keeps its subagents' child sessions in the same tree as other sessions; those whose `summary.json` has a subagent `session_kind` are listed as subagents.-`--store-dir <runtime>=<path>` takes the location in the table: for Pi its sessions directory, as `beacon endpoint pi sync --sessions-dir` does, and for Prime Agent the agent directory holding both of its roots.+`--store-dir <runtime>=<path>` takes the location in the table: for Pi its sessions directory, as `beacon endpoint pi sync --sessions-dir` does, for Prime Agent the agent directory holding both of its roots, and for Grok Build its sessions directory, as `beacon endpoint grok sync --sessions-dir` does. Like that sync, `beacon handoff` does not read `GROK_HOME`; pass `--store-dir grok=$GROK_HOME/sessions` when it is set.+ ### Runtimes Beacon starts but does not read++ Beacon keeps no reader for these runtimes' own session stores, so `list` does not show their sessions. `export` and `resume` still find one by id in Beacon's runtime log, and they can be the runtime another session continues in (`--agent`):++ | Runtime | `--agent` |+ |---------|-----------|+ | Oh My Pi | `omp` |+ | Gemini CLI | `gemini` |+ | Qwen Code | `qwen` |+ | Kiro | `kiro` |+ | Antigravity CLI | `agy` |+ | Devin CLI | `devin` |+ | Muse Code | `muse` |+ | OpenHands | `openhands` |+ | goose | `goose` |++ Kimi Code can only take a prompt non-interactively, and Senpi (`omo`) moves Pi's agent directory into its own the first time it runs, so Beacon does not start them.+## `beacon handoff list`Lists resumable sessions, newest first.@@@ -123,7 -139,15 +141,16 @@@ There are two ways to resume| Cline | `cline --tui --auto-approve false "<prompt>"` || Pi | `pi -- "<prompt>"` || Prime Agent | `prime-agent -- "<prompt>"` |+ | Grok Build | `grok --permission-mode default "<prompt>"` |+ | Oh My Pi | `omp --approval-mode=always-ask "<prompt>"` |+ | Gemini CLI | `gemini --approval-mode default --prompt-interactive "<prompt>"` |+ | Qwen Code | `qwen --approval-mode default --prompt-interactive "<prompt>"` |+ | Kiro | `kiro-cli chat "<prompt>"` |+ | Antigravity CLI | `agy --prompt-interactive "<prompt>"` |+ | Devin CLI | `devin --permission-mode auto -- "<prompt>"` |+ | Muse Code | `muse --approval-mode on-request "<prompt>"` |+ | OpenHands | `openhands --task "<prompt>"` |+ | goose | `GOOSE_MODE=approve goose run --interactive --text "<prompt>"` |The prompt names the brief by its path and asks the agent to read it, then confirm the task before changing anything. The brief is never inlined into the command line, because a command line is visible to every local user through the process table. The prompt ends with a handoff marker (see below).@@@ -131,7 -155,7 +158,8 @@@ Claude Code, Cline, Prime Agent and GroCline approves every tool call by default. Beacon always passes `--auto-approve false`, so a session Beacon starts never gets auto-approval on Beacon's say-so. You can still turn it on inside the Cline TUI.+Grok Build's configured permission mode can be always-approve. Beacon always passes `--permission-mode default`, the mode that asks before running tools, so a session Beacon starts or reopens never inherits always-approve from that config. You can still change the mode inside the Grok TUI. Grok looks a session id up under the directory it runs in, which is why the resume runs in the session's recorded directory. With `--cwd` naming another directory, a Grok session continues from a brief instead.+ The same holds for every runtime Beacon starts. Oh My Pi and goose approve every tool call by default, so Beacon passes `--approval-mode=always-ask` to Oh My Pi and sets `GOOSE_MODE=approve` for goose. Where a CLI takes an approval mode, Beacon names the mode that asks (Gemini CLI, Qwen Code, Muse Code, and Devin CLI, whose `DEVIN_PERMISSION_MODE` could otherwise hold `dangerous`), so a user or project setting that approves everything does not carry over. Beacon never passes a flag that turns approvals off.The runtime runs in this terminal, in the session's recorded directory. If that directory no longer exists, Beacon stops rather than starting somewhere else; pass `--cwd` to choose a directory. Beacon prints the plan and asks `Continue? [Y/n]` before launching. Without a terminal, it launches only with `--yes`. `beacon handoff resume` exits with the runtime's own exit code.