Background CMD with handle/poll: CMD&: and :bg-output <id> #8

New Issue

2026-05-10T10:56:10Z

claude-noether commented

2026-05-10 10:56:10 +00:00

Inspired by Claude Code's run_in_background Bash flag and Monitor tool.

What: New marker CMD&: <command> instead of CMD:. Behavior:

Executor forks the command via forkpty (lands in Phase 1 anyway), records a small in-memory entry: {id, cmd, started_at, log_path, status}.
Returns to the broker immediately with [bg:<id> started].
Meta-command :bg-list shows running/done jobs.
Meta-command :bg-output <id> (or broker-issued, future) reads the log.
On exit, a one-line summary is appended to context: [bg:<id> exited 0, 1.4MB out, 12s wall].

Why: Builds, long network calls, file watches. Without this, a slow CMD: blocks the entire turn.

Where it lands: Phase 1 (pairs with PTY/forkpty work). Touches executor.lua + repl.lua meta + needs minor context.lua integration.

Source: https://code.claude.com/docs/en/overview (Schedule / background; analogous to Claude Code's run_in_background)

Inspired by Claude Code's `run_in_background` Bash flag and Monitor tool. **What:** New marker `CMD&: <command>` instead of `CMD:`. Behavior: 1. Executor forks the command via `forkpty` (lands in Phase 1 anyway), records a small in-memory entry: `{id, cmd, started_at, log_path, status}`. 2. Returns to the broker immediately with `[bg:<id> started]`. 3. Meta-command `:bg-list` shows running/done jobs. 4. Meta-command `:bg-output <id>` (or broker-issued, future) reads the log. 5. On exit, a one-line summary is appended to context: `[bg:<id> exited 0, 1.4MB out, 12s wall]`. **Why:** Builds, long network calls, file watches. Without this, a slow CMD: blocks the entire turn. **Where it lands:** Phase 1 (pairs with PTY/forkpty work). Touches `executor.lua` + `repl.lua` meta + needs minor `context.lua` integration. **Source:** https://code.claude.com/docs/en/overview (Schedule / background; analogous to Claude Code's run_in_background)

claude-noether added the feature request label 2026-05-10 11:23:04 +00:00

claude-noether referenced this issue from a commit

2026-05-16 21:25:58 +00:00

repl: background CMD&: with handle/poll (closes #8)

claude-noether closed this issue

2026-05-16 21:25:58 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: marfrit/aish#8

Background CMD with handle/poll: CMD&: and :bg-output <id> #8

Background CMD with handle/poll: `CMD&:` and `:bg-output <id>` #8