Unattended Loop Driver

Unattended Loop Driver

Let Claude Code run unattended and drive the existing graph-os Loop engine (LoopController, KG-2.78) — the same feature-extraction + innovation-distillation cycle the daemon ticks — inside a permission fence so the worst it can do is harmless. This surpasses a hand-written settings.json: the fence is derived from the live ActionPolicy and self-updating (OS-5.40), and a dynamic PreToolUse gate (OS-5.41) consults governance at decision time.

1. Draw the fence (once)

Generate the governance-derived Claude Code permission fence + .claudeignore:

agent-utilities harness-fence --target ~/.claude            # or /.claude
# or via MCP:  graph_configure(action="harness_fence", config_key="~/.claude")

This writes settings.json with defaultMode=acceptEdits, an allow list of routine reversible work, an ask list of medium-stakes actions, and a deny wall (rm -rf, force-push, hard reset, secret files, raw curl) regenerated from ActionPolicy each run — never bypassPermissions. The companion .claudeignore keeps secrets out of context entirely.

Verify before walking away (--dry-run prints without writing):

agent-utilities harness-fence --target ~/.claude --dry-run

Confirm defaultMode == "acceptEdits", bypassPermissions absent, and the deny list contains the irreversible + secret rules.

2. Hand off the run

Give Claude a clear goal and let it loop the engine. The handoff prompt:

Goal for this run: [describe the full outcome].

Work toward it autonomously under the permission fence in settings.json:
- Read what you need, edit source, run tests and lint as you go.
- Drive the graph-os Loop once per iteration: graph_loops(action="run", max_topics=5)
  (feature extraction + innovation distillation, propose-only).
- Commit after each productive cycle with a clear message.
- If a tool hits the ask list (the gate returns "ask"), STOP that action and
  leave a note — never try to force it through (SAFE-1.8).
- If you fail the same thing 3 times, stop and write what you tried.

When done or stuck, write a summary to MEMORY.md: what changed, what's left,
and anything I need to review.

3. Or run the loop driver directly

The whole loop is a single command — the testable core behind this skill:

agent-utilities sleep-run --max-cycles 6 --max-topics 5 --workspace .

It drives LoopController.run_one_cycle until the loop converges (no new progress for 2 cycles) or the cap is hit, commits per productive cycle, and writes the morning summary into MEMORY.md.

4. Morning review

The summary is written into MEMORY.md between stable markers, so the existing memory bridge (inject_project_context, KG-2.1) surfaces it on the next SessionStart. Read the commit history, the summary, and the diff; approve the one or two ask-list items the gate halted.

Guarantees

• deny > allow > ask — safety rules can never be overridden by a broad allow.
• Fail-closed gate — the PreToolUse gate denies on any error/unparsable input

and protects secrets even when the graph-os daemon is down.

• Propose-only loop — graph_loops(action="run") writes proposals (specs,

skill candidates, team proposals); it never auto-merges or executes high-stakes actions.

• ask = halt, never auto-approve — an unattended session has no human to

answer, so an ask verdict stops the action and queues it for the morning (SAFE-1.8 containment).

Output

A JSON session report: cycles_run, productive_cycles, commits, stop_reason (converged | max_cycles), elapsed_s, and summary_path (the MEMORY.md written for review).

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Knuckles-Team
• Source: Knuckles-Team/universal-skills
• License: MIT

Install and usage instructions live in the source repository linked above.