agentmemory.md

AgentMemory Automation & Client Hook Roundabout

This file documents the technical details and configurations for automating memory sessions, observations, and prompt-context syncing in environments that lack native client-side hook runners.

---

1. PowerShell-Level Console Hook Automation

For standard command shells that do not have custom plugins (such as PowerShell), we have implemented a native console hook system directly in the user profile:

• Profile File: D:\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1
• Automation Mechanism:
  1. Prompt Redefinition: Overrides the default PowerShell prompt function to retrieve the last executed command from the session history (Get-History).
  2. Asynchronous Dispatch: Uses PowerShell's Start-Job to send the command, execution status, and duration to the Hugging Face Space database (https://yash030-agentmemory-python.hf.space/agentmemory/observe) in the background, keeping terminal prompts lag-free.
  3. Interactive Shield: Wraps the prompts and startup session creation in if (-not [Console]::IsInputRedirected) so background script executions or tool runners do not pollute the database.
  4. Active Session Reuse: On console startup, checks for a cached session ID in current_session.txt and reuses it to prevent session clutter.

---

2. Antigravity Chat Sync Loop

Because the Gemini Antigravity agent runs inside a transient prompt-response loop sandbox, we automate chat log syncing through a shell-level daemon job:

• Sync Script: C:\Users\yashw\.gemini\antigravity\sync_antigravity.py
• Daemon Job: Appended to the PowerShell profile as a background Start-Job loop named AntigravitySync.
• Execution Heuristic:
  • The job runs a continuous loop that executes the sync script every 30 seconds.
  • Uses a lock file (sync_antigravity.lock) to ensure only a single terminal window runs the sync globally.
  • The script parses transcript.jsonl from the local brain/ directory and uploads new user prompts and response turns to the Hugging Face Space under the session antigravity_<conversation_id>.

---

3. Configuration & Controls

To control this automation inside PowerShell, use the following commands:

• Start-MemorySession -project "name": Starts a new memory session. Use the -Force switch to override any active session.
• End-MemorySession: Ends the active session, marking it completed and cleaning up the local cache file.
• Get-Job -Name "AntigravitySync": Checks the status of the background chat sync thread.