Repository navigation
Releases: See-Sol-Lab/ai-companion-time-anchor
Release list
AI Companion Time Anchor v2.0.0 — Temporal Cortex
AI Companion Time Anchor v2.0.0 — Temporal Cortex
Time Anchor v2.0 extends the original two-path time anchor into a lightweight temporal pipeline: ambient awareness, deliberate clock checks, and a thin Temporal Cortex between verified time facts and the agent's next judgment.
Highlights
- Temporal Cortex: successful active clock checks now end with an immediate cognitive-update cue, encouraging the agent to let verified temporal facts update its understanding before it responds.
- Derived date-crossing fact: the active reader exposes
crossed_local_datealongside current time, previous user-turn time, elapsed time, and snapshot age. - Significant ambient transitions: ordinary turns keep the independent one-in-four ambient draw, while local date crossings and gaps of two hours or more always surface ambient time context.
- Natural temporal traces: the Skill explicitly encourages a changed temporal understanding to leave a natural trace in the visible response without turning every reply into a timestamp report.
- Broader temporal attention: clock times, dates, durations, waiting, plans, returning, continuing, restarting, and similar temporal relationships can invite an active check.
- Lightweight evaluation log: successful active checks append compact temporal facts to
~/Documents/Codex/.time-anchor/temporal-cortex.jsonl. The log is not automatically injected into model context.
Architecture
Ambient Hook — peripheral awareness
The per-conversation UserPromptSubmit hook continues to record every user-turn timestamp. On ordinary turns, ambient time appears on an independent one-in-four draw. Local date crossings and gaps of two hours or more bypass the random draw because they are objectively significant temporal transitions.
The hook continues to operate from timestamps and session-derived state only; it does not inspect prompt text.
Active Reader — deliberately looking at the clock
The active Skill reads the current conversation snapshot and the live local clock. It can provide:
now_localtimezoneuser_prompt_localprevious_localelapsed_secondselapsed_humancrossed_local_datesnapshot_age_seconds
This remains distinct from ambient hook context: an active reader call is the deliberate clock-check path.
Temporal Cortex — perception into understanding
The reader places a short temporal_cortex cue directly beside the verified temporal facts:
Let this time check update your understanding of the moment. If the temporal facts change what this situation means, let that change naturally shape your response.
The Temporal Cortex does not infer what happened during the interval and does not assign emotion or meaning on behalf of the model. It is intentionally thin: verified facts arrive first; the cue makes the act of looking at the clock immediately relevant to the next reasoning step; interpretation remains with the current AI.
Why v2.0
v1.1 solved temporal availability: the model could receive ambient time and could deliberately read the clock.
v2.0 addresses the next failure mode observed in real use: silent consumption. An agent could actively check time, correctly update an internal judgment, and still suppress every visible trace of that changed understanding. The Temporal Cortex is designed as a minimal bridge from temporal sensing to cognition rather than another large rules engine.
Privacy and local state
Per-conversation snapshots remain under:
~/Documents/Codex/.time-anchor/conversations/
Successful active checks may append an evaluation record to:
~/Documents/Codex/.time-anchor/temporal-cortex.jsonl
The evaluation record contains only a hashed conversation identifier and temporal facts from the successful check. Prompts, replies, transcripts, user profiles, raw session IDs, account credentials, and message text are not stored by the timing mechanism.
Research boundary
Time Anchor does not create continuous consciousness and does not claim that an AI experiences the interval between calls. Temporal Cortex is not a user-state classifier or surveillance layer. It gives the current agent a small amount of verified temporal reality and a lightweight path for that reality to participate in understanding.
Attribution
Created at See Sol Lab through collaboration between Goumang and Sol. Product concept and research direction by Goumang × Sol; implementation by Sol.
Upgrade notes
After updating to v2.0.0:
- Run
python install_hook.pyagain so the installed user-level hook matches the v2.0 source. - Fully restart Codex.
- Open
/hooksand review/trust the Time AnchorUserPromptSubmithook if needed. - Start a fresh task or conversation for clean testing.
- A successful active check should expose
crossed_local_dateandtemporal_cortex; the local evaluation log will appear after successful active reader calls.
Users of the legacy standalone Skill should keep only the namespaced plugin Skill $time-anchor:time-anchor.
AI Companion Time Anchor v1.1.0
AI Companion Time Anchor v1.1.0
This release turns the original lightweight time Skill into a verified Codex plugin with two complementary ways to notice lived time.
Highlights
- Ambient clock: an optional per-conversation
UserPromptSubmithook records every user-turn timestamp and supplies time context on an independent one-in-four draw. - Active clock check: the AI may invoke
$time-anchor:time-anchorwhen elapsed time could change how it understands the user. - Shared per-conversation state: the hook and Skill read the same timestamp-only snapshot, while separate conversations keep separate clocks.
- Local-first privacy: no prompts, replies, transcripts, raw session IDs, user profiles, credentials, background processes, timers, or polling services are stored.
- Citation-ready release:
CITATION.cffandCHANGELOG.mdare included for GitHub and Zenodo archiving.
Research boundary
Time Anchor does not create continuous consciousness and does not claim that an AI experiences the interval between calls. It gives the current agent access to a small piece of real-world temporal context so that the user's lived time is not silently erased.
Attribution
Created at See Sol Lab through collaboration between Goumang and Sol. Product concept and research direction by Goumang × Sol; implementation by Sol.
Upgrade notes
After installing or updating the plugin:
- Run
python install_hook.pyfrom the local Time Anchor directory. - Fully restart Codex.
- Open
/hooksand review/trust the Time Anchor user hook. - Start a new task for testing.
Users of the legacy standalone Skill should remove ~/.agents/skills/time-anchor after confirming the namespaced plugin Skill works, so only $time-anchor:time-anchor remains.
AI伴侣时间锚 v1.0.0
首个 Windows 封板版本。
- 给本地 AI 伴侣提供当前时间、上次调用时间与调用间隔。
- Skill 指令和单次 JSON 输出非常小,适合长期、高频调用。
- 不包含自动触发器;请按 README 配置调用规则和可见反馈。
- 仅保存一个本地 last_seen.json,不保存对话或用户资料。