agent-memory-cli 0.1.0__py3-none-any.whl

agent_memory/setup/__init__.py

@@ -0,0 +1,53 @@
+# SPDX-FileCopyrightText: 2026 Kiloloop
+# SPDX-License-Identifier: Apache-2.0
+"""``agent-memory setup <runtime>``: one planner, one applier, a spec per runtime."""
+
+from __future__ import annotations
+
+from typing import Dict
+
+from . import claude, codex
+from .common import (
+    Plan,
+    Result,
+    RuntimeSpec,
+    SetupError,
+    Step,
+    apply_plan,
+    detect_repo,
+    known_template_digests,
+    known_workflow_digests,
+    lines,
+    plan_setup,
+    run_setup,
+    script_text,
+    template_digest,
+    to_json,
+    workflow_digest,
+    workflow_text,
+)
+
+SPECS: Dict[str, RuntimeSpec] = {claude.SPEC.name: claude.SPEC, codex.SPEC.name: codex.SPEC}
+RUNTIMES = tuple(SPECS)
+
+__all__ = [
+    "Plan",
+    "RUNTIMES",
+    "Result",
+    "RuntimeSpec",
+    "SPECS",
+    "SetupError",
+    "Step",
+    "apply_plan",
+    "detect_repo",
+    "known_template_digests",
+    "known_workflow_digests",
+    "lines",
+    "plan_setup",
+    "run_setup",
+    "script_text",
+    "template_digest",
+    "to_json",
+    "workflow_digest",
+    "workflow_text",
+]

agent_memory/setup/claude.py

@@ -0,0 +1,34 @@
+# SPDX-FileCopyrightText: 2026 Kiloloop
+# SPDX-License-Identifier: Apache-2.0
+"""``agent-memory setup claude``: the Claude Code hook.
+
+Claude Code reads ``.claude/settings.json`` and runs each ``SessionStart``
+command with the ``startup`` matcher when a session begins, with the
+repository as its working directory; what the command prints to stdout is
+added to the session's context. So the script prints its manifest, and a
+warning, as plain lines. The registration retires the two hook commands the
+kernel used to install, and removes their scripts only when they are byte
+for byte what it wrote; the kernel's envelope hook and anything custom stay. Beside the hook goes the
+workflow file, a repository skill Claude Code loads on demand.
+"""
+
+from __future__ import annotations
+
+from . import legacy
+from .common import RuntimeSpec
+
+SETTINGS_SCHEMA = "https://json.schemastore.org/claude-code-settings.json"
+
+SPEC = RuntimeSpec(
+    name="claude",
+    settings_file=".claude/settings.json",
+    script_file=".claude/hooks/agent-memory-pull.sh",
+    event="SessionStart",
+    matcher="startup",
+    timeout=30,
+    workflow_file=".claude/skills/agent-memory/SKILL.md",
+    report_body="  printf '%s\\n' \"$1\"",
+    fresh_settings={"$schema": SETTINGS_SCHEMA},
+    legacy_registrations=legacy.CLAUDE_LEGACY_REGISTRATIONS,
+    legacy_files=legacy.CLAUDE_LEGACY_FILES,
+)

agent_memory/setup/codex.py

@@ -0,0 +1,39 @@
+# SPDX-FileCopyrightText: 2026 Kiloloop
+# SPDX-License-Identifier: Apache-2.0
+"""``agent-memory setup codex``: the Codex hook.
+
+Codex reads ``.codex/hooks.json``; a ``SessionStart`` entry whose matcher is
+``^startup$`` runs when a session begins, and the command answers with a
+JSON envelope whose ``additionalContext`` the runtime adds to the session.
+The script therefore reports through that envelope, and the ``startup`` verb
+renders one for this runtime. The entry is the memory half only: it sits
+beside the kernel's ``session-init --hook`` entry, which keeps verifying
+protocol files and status, and only that entry's ``--pull-memory`` flag is
+retired, so memory is pulled once. Its ``additionalContextLimit`` belongs
+to it and is never touched. Beside the hook goes the workflow file, a
+repository skill under ``.agents/skills/``, where Codex discovers them.
+"""
+
+from __future__ import annotations
+
+from . import legacy
+from .common import RuntimeSpec
+
+REPORT_BODY = (
+    "  printf '{\"continue\": true, \"systemMessage\": \"%s\", \"hookSpecificOutput\": "
+    "{\"hookEventName\": \"SessionStart\", \"additionalContext\": \"%s\"}}\\n' \"$1\" \"$1\""
+)
+
+SPEC = RuntimeSpec(
+    name="codex",
+    settings_file=".codex/hooks.json",
+    script_file=".codex/hooks/agent-memory-pull.sh",
+    event="SessionStart",
+    matcher="^startup$",
+    timeout=60,
+    workflow_file=".agents/skills/agent-memory/SKILL.md",
+    report_body=REPORT_BODY,
+    hook_fields={"statusMessage": "Pulling agent memory"},
+    fresh_settings={"description": "agent-memory startup: pull the memory home and list the files to read."},
+    legacy_flag=(legacy.CODEX_SESSION_INIT_PREFIX, legacy.CODEX_LEGACY_PULL_FLAG),
+)