Record a canonical architectural decision on the active branch.

Decisions are durable: they are never compacted away, and a new value for an existing key supersedes the old one (which is kept as a deprecated assumption). Example: decision_key="auth.method", decision_value="OAuth2 PKCE".

Return the consolidated memory of a branch as JSON: tasks, decisions, active workspace facts, deprecated assumptions, execution blockers, file claims, active leases, workspace-wide coordination notices and recent events. Set include_ephemeral=true to also see raw tool-execution logs and scratchpad notes not yet compacted.

Post a workspace-wide advisory, e.g. service:auth / changing login.

It stays visible on all branches, even after rollback or GC. After TTL it becomes stale, not finished. Clear it explicitly when done. No lock is acquired.

Clear your notice after finishing. This cannot be undone by an old import.

List workspace-wide active and stale advisories; optionally include cleared history.

Sync signed notices using the operator's preconfigured trust policy and folder.

Check errors and memkernel_sync_status before coordinating. No tool-supplied paths, keys or new peers are accepted. This does not provide a distributed lock.

Inspect received peer sequences, freshness and errors without refreshing liveness.

Export portable JSON data for explicit sharing. Review it before sending.

Includes cleared notices so peers learn they are finished. Select IDs to limit disclosure. No decisions, scratchpads, local IDs or leases are included.

Merge a trusted collaborator's JSON export atomically and idempotently.

Authors are self-asserted. Validate who sent it yourself; content is untrusted. Import provides advisory information, never distributed locking or live sync.

Acquire an exclusive, time-limited lease on a file before editing it.

timeout_seconds is the lease TTL; renew it with memkernel_heartbeat_lease. Returns acquired=true and a fencing_token on success; on contention returns acquired=false with the current holder and how long until it expires.

Release a lease you hold. Returns false if the token is stale (the lease expired and was granted to someone else) or not yours.

Extend a lease you hold by its original TTL. False means the lease was lost: stop editing and re-acquire.

Record a decision only while this agent holds the current lease.

The holder, token and expiry check shares the append's transaction. This protects the memory event; it does not write or lock the file.

Fork the active branch at its head into a new branch and switch this session to it. Use for speculative work you may want to discard.

Switch this session's active branch (it must exist).

Roll the active branch's live timeline back to target_event_id.

Later events are reverted but kept in the audit log (fork from them to recover). Find event ids with memkernel_history.

Compact a branch's memory now, folding older tool logs and notes into a semantic snapshot. Reports token counts before/after.

Record this agent's task directive and constraints on the active branch.

Log a tool/terminal execution. A non-zero exit_code opens a blocker for this command; a later zero exit clears it. Put verified environment facts (e.g. {"python_version": "3.14.0"}) in facts; changed values are tracked as deprecated assumptions.

Record an ephemeral scratchpad note (compacted by GC over time).

List the most recent live events on the active branch (ids for rollback).

Compare two branches: merge base, events ahead on each side, and conflicting decisions and facts.

List all branches and this session's active branch.