Register new session, clean stale ones, return active sessions + alerts.

Call this ONCE at the start of every conversation. Returns the session ID (SID) — store it for use in all other nexo_ tools.

Update session task, check inbox and pending questions. Auto-detects trust events.

Call this at the START of every user interaction (before doing work). Output always begins with a NOW_UTC line (ISO-8601, UTC) — use it as the authoritative wall-clock time for any artifact (emails, diaries, followups) to avoid date/day-of-week drift across long sessions. Args: sid: Your session ID from nexo_startup. task: Brief description of current work (5-10 words). context_hint: Last 2-3 sentences from the user or current topic. Used for sentiment detection, trust auto-scoring, and mid-session RAG. ALWAYS provide this for best results.

Read recent session diaries for context continuity.

Decide whether an answer should proceed directly or be verified first.

Resolve protocol debt records by id or filters.

Find official NEXO protocol cards for a user request.

Find reusable NEXO skills for the current task.

Cleanly close a session. Removes it from active sessions immediately.

Call this when ending a conversation to avoid ghost sessions. Args: sid: Session ID to close.

Cognitive pre-action check. Call before significant actions.

Check learnings relevant to files/area before reading or editing code.

Open a protocol task for non-trivial work.

ack_rules accepts "#95,#156" / "95,156" / "[95, 156]" and, when the guard surfaces blocking rules, acknowledges them inline instead of requiring a separate nexo_task_acknowledge_guard call.

Acknowledge blocking guard rules on an open protocol task.

Close a protocol task with evidence and optional artifacts.

Open a durable workflow run for long multi-step work.

Update a workflow run with a replayable checkpoint.

List active sessions. Filter by keyword if provided.

Return local memory index status for Desktop settings and support diagnostics.

Control the local memory index.

List, add or remove local memory roots.

List, add or remove local memory exclusions.

Retrieve local evidence before answering or acting.

Use mode='compact' for normal answers. Use mode='full' only for deep debugging, ideally with a higher max_chars and a specific query.

Return compact local context evidence suitable for injection before a reply.

Return one indexed local asset by asset id.

Return graph relations around one indexed local asset.

Return recent local memory diagnostic log entries.

Purge one indexed asset or clear the full local index.

Render service configuration metadata for macOS, Windows or Linux.

Return or warm local model state for the Local Context Layer.

Write a durable continuity snapshot for Desktop/Brain handoff.

Read recent continuity snapshots by conversation_id or session_id.

Build the small continuity bundle Desktop injects after restore or stale resume loss.

Persist a compaction-related continuity event into the canonical snapshot stream.

Return the forensic continuity timeline for a conversation.

Build a context packet for subagent injection. Returns learnings + changes + followups + preferences + cognitive memories for a specific area.

MUST call before delegating ANY task to a subagent. Inject the result into the subagent's prompt.

Capture/update a recent 24h context item and append an event.

Use this for important ongoing threads that should stay mentally fresh across sessions/clients.

Read recent hot context and continuity events from the last N hours.

Build the 24h recent-context bundle that should be reviewed before acting.

Especially useful for emails, orchestrators, and any work where the same topic may reappear hours later.

Resolve a recent hot-context item and append a resolution event.

List hot-context items currently alive in the recent continuity window.

List recent Claude Code / Codex transcripts visible to NEXO.

Search recent transcripts directly when recall/hot-context are not enough.

Read a full transcript fallback by session id, transcript display name, session_uid, or exact path.

List raw Memory Observations v2 events captured by hooks/tasks.

Summarize raw Memory Observations v2 event counts.

Process pending raw memory events into passive observations.

List passive Memory Observations v2 rows.

Summarize passive Memory Observations v2 rows and queue status.

Backfill Memory Observations v2 from existing Brain tables.

Return Memory Observations v2 health and table status.

Run safe Memory Observations v2 maintenance.

Search Memory Observations v2 with evidence-first results.

Answer a memory question only when evidence exists.

Return a chronological Memory Observations v2 timeline.

Read NEXO's live system catalog built from core tools, plugins, skills, scripts, crons, projects, and artifacts.

Explain a live NEXO tool/capability from the generated system catalog.

Temporarily override a Guardian rule's mode (Plan Consolidado 0.17).

Writes to ~/.nexo/config/guardian-runtime-overrides.json which guardian_config.rule_mode already honours at read time. Useful when a rule is noisy during an incident and needs to drop to shadow for an hour without a server restart.

Pre-load relevant cognitive memories based on pending followups, due reminders, and last session topics.

Call during startup (after nexo_startup) to ensure the session starts with the right context loaded. Returns up to 10 memories matching the current operational state.

Build a portable handoff packet for another client/runtime.

Use this when another client should continue the same work with explicit task/checkpoint/goal/workflow context instead of relying on memory alone.

Export a machine-readable session bundle for cross-client handoff or archival.

Save a session checkpoint for auto-compaction continuity.

Call this BEFORE context compaction to preserve session state. The PostCompact hook reads this checkpoint and re-injects it as a Core Memory Block, so the session continues seamlessly.

Read the latest session checkpoint. Used by PostCompact hook and for manual recovery.

Track files being edited. Detects conflicts with other sessions.

MUST call before editing any shared file. Args: sid: Your session ID. paths: List of absolute file paths to track.

Stop tracking files. If no paths given, releases all.

Show all tracked files across all active sessions with conflict detection.

Send a fire-and-forget message to another session or broadcast.

Ask a question to another session (they see it on next heartbeat).

Answer a pending question from another session.

Check if a question has been answered.

Check reminders and followups.

Generate the NEXO operations center menu with alerts and active sessions.

Shows: date, due alerts, all menu items by category, active sessions. Uses box-drawing characters for formatting.

Create a new reminder for the user.

Read a reminder with its history and usage rules.

IMPORTANT: before update/delete/restore/note, call this tool first and use the returned READ_TOKEN.

Update fields of an existing reminder. Only non-empty fields are changed.

IMPORTANT: call nexo_reminder_get first and pass its READ_TOKEN.

Mark a reminder as completed with today's date.

Append a note to reminder history.

IMPORTANT: call nexo_reminder_get first and pass its READ_TOKEN.

Restore a soft-deleted reminder back to PENDING.

IMPORTANT: call nexo_reminder_get first and pass its READ_TOKEN.

Soft-delete a reminder.

IMPORTANT: call nexo_reminder_get first and pass its READ_TOKEN.

Create a new agent followup (autonomous task).

Read a followup with its history and usage rules.

IMPORTANT: before update/delete/restore/note, call this tool first and use the returned READ_TOKEN.

Update fields of an existing followup. Only non-empty fields are changed.

IMPORTANT: call nexo_followup_get first and pass its READ_TOKEN.

Mark a followup as completed. Appends result to verification field.

Append a note to followup history.

IMPORTANT: call nexo_followup_get first and pass its READ_TOKEN.

Restore a soft-deleted followup back to PENDING.

IMPORTANT: call nexo_followup_get first and pass its READ_TOKEN.

Soft-delete a followup.

IMPORTANT: call nexo_followup_get first and pass its READ_TOKEN.

Add a new learning (resolved error, pattern, gotcha).

Search learnings by keyword. Searches title and content.

Scan recent decisions and surface those that conflict with a learning's prevention rule.

Closes Fase 2 item 3 of NEXO-AUDIT-2026-04-11. Use this when you add a new rule and want to retroactively check whether past decisions still hold. Creates deterministic NF-RETRO-L-D followups so the helper is idempotent across reruns. nexo_learning_add invokes this automatically when the new learning has a prevention field — call this tool manually only when you want to re-scan with a longer window or a different threshold.

List recent hook lifecycle runs and per-hook health summary.

Closes Fase 3 item 7 of NEXO-AUDIT-2026-04-11. Each NEXO hook (session-start, post-compact, pre-compact, inbox-hook, etc.) writes a row to hook_runs when it finishes via scripts/nexo-hook-record.py. This tool reads them back so the agent can answer "is the hook pipeline healthy?" without needing the dashboard or grepping log files.

Update a learning entry. Only non-empty fields are changed.

Delete a learning entry.

List all learnings, grouped by category.

Score learning quality so fragile rules can be strengthened before they mislead guard or retrieval.

Force full rebuild of the FTS5 search index. Use after bulk changes or if search seems stale.

Register a new directory for FTS5 search indexing. Survives restarts.

Remove a directory from FTS5 indexing and clean up its entries.

List all directories being indexed by FTS5 (builtin + dynamic).

Get credential value(s) for a service.

Store a new credential.

Update a credential's value and/or notes.

Delete credential(s). If no key, deletes all for the service.