contextdb-autopilot

ContextDB Autopilot

Working directory: project root. Commands assume repo root; npm run contextdb runs from mcp-server/.

Overview

Use this skill only to persist and retrieve ContextDB state. ContextDB is no longer a prompt-injection layer.

Runtime rules:

• Do not auto-inject ContextDB packets, continuity summaries, persona overlays, user overlays, route guides, or handoff prompts into model prompts.
• Interactive startup may show a short local unfinished-task summary to the user; it must not pass that summary as model input.
• One-shot mode sends only the explicit --prompt text to the selected client.
• Durable workflow constraints belong in checked-in instruction files (AGENTS.md, CLAUDE.md, GEMINI.md) and repo-local skills.

Deprecated prompt-loading flags are intentionally unsupported:

• --startup-mode inject
• --context-mode
• --limit
• CTXDB_AUTO_PROMPT

If old docs, scripts, or user requests mention these as ways to preload memory, treat them as removed behavior. Use explicit search/timeline retrieval instead.

Script path: scripts/ctx-agent.sh

When to Use

• You want cross-CLI memory continuity (codex, claude, gemini, opencode) in the same project.
• You need automatic session creation, event logging, checkpoints, and continuity/handoff artifact writes.
• You want to retrieve prior facts explicitly before continuing work.

Do not use this skill just to execute a normal coding task. Let the current Rex Capability Command select the task Provider.

Required Pattern

Use one-shot mode (--prompt) when you want automatic logging around a single explicit request. The prompt is not augmented with ContextDB state.

scripts/ctx-agent.sh --agent codex-cli --project rex-cli --prompt "继续上次任务，先列出你会读取哪些 handoff 文件"
scripts/ctx-agent.sh --agent claude-code --project rex-cli --prompt "记录这个检查点并总结下一步"
scripts/ctx-agent.sh --agent gemini-cli --project rex-cli --prompt "基于我明确给出的文件继续分析"
scripts/ctx-agent.sh --agent opencode-cli --project rex-cli --prompt "执行这个明确请求，不自动加载历史"